Dominar los metadatos de WordPress: Consulta de publicaciones y usuarios por metadatos

Spanish (Español) translation by Esther (you can also view the original English article)

Hasta ahora en esta serie has aprendido a acceder a los meta data (metadatos) de WordPress, y a trabajar con las matrices (arrays) en las que se devuelven. No solo añadimos campos personalizados a los posts de WordPress para poder mostrar esta información, sino también para poder clasificarla por ella.

Ahora que sabes cómo recuperar y mostrar metadatos, es hora de aprender a personalizar el bucle de WordPress para que devuelva solo las publicaciones con metadatos específicos.

Uso de WP_Query para consultar por el Meta Field Value (valor de campo meta)

Para personalizar qué publicaciones devuelve WordPress en base a los meta fields (metacampos), necesitamos usar WP_Query y especificar una meta_query. Si, por ejemplo, tuviéramos un tipo de publicación personalizado llamado "films" que tuviera un campo personalizado llamado "director" podríamos buscar películas cuyo director fuera un director de una de las tres películas de Star Wars.

Echa un vistazo al código de abajo y mira si puedes usar tu dominio de los arrays que descargaste en la última parte para entender lo que está pasando con la meta_query, que voy a desglosar lo que está pasando en el código.

$sw_args = array(
	'post_type' => 'films',
	'meta_query' => array(
		array(
			'key' => 'director',
			'value' => array( 'George Lucas', 'Richard Marquand', 'Irvin Kershner' ),
			'compare' => 'IN',
		)
	)
);
$query = new WP_Query( $sw_args );
if ( $the_query->have_posts() ) {
     echo '<h2>Films By Star Wards Directors</h2>';
     echo '<ul>';
		while ( $the_query->have_posts() ) {
			$the_query->the_post();
			echo '<li>' . get_the_title() . '</li>';
	}
        echo '</ul>';
}
/* Restore original Post Data */
wp_reset_postdata();

Como puedes ver, tenemos una serie de nombres de directores dentro de otras tres matrices. Vamos a desarmarlo, pieza por pieza.

Primero, empezamos un array para nuestros arcos de WP_Query. Después de nuestro primer argumento 'post_type', comenzamos una matriz para alojar nuestros argumentos de meta_query.

Dentro de eso especificamos qué llave buscar, en el caso "director". También proporcionamos una serie de valores para buscar en esa clave.

El último argumento es cómo comparar esos valores, en este caso especificamos "IN" para recuperar cualquier publicación con esos valores en el director clave.

Otras comparaciones

¿Y si quisiéramos películas que fueran dirigidas por un director de una película de Star Wars, pero no queremos excluir las Precuelas de Star Wars? Podemos añadir otro array de argumentos a nuestra meta_query, pero esta vez para el valor utiliza un array de esos títulos de películas para clave film_title y para comparar, utilizar 'NOT LIKE' para excluir las publicaciones que tienen estos valores en el campo film_title.

$sw_args = array(
	'post_type' => 'films',
	'meta_query' => array(
		array(
			'key' => 'director',
			'value' => array( 'George Lucas', 'Richard Marquand', 'Irvin Kershner' ),
			'compare' => 'IN',
		),
                array(
			'key' => 'film_title',
			'value' => 'Phantom Menace', 'Attack of the Clones', 'Revenge of the Sith' ),
			'compare' => 'NOT LIKE'
		),

	)
);
$query = new WP_Query( $sw_args );

Ahora WordPress buscará películas de estos tres directores, cuyo título no es una de las tres precuelas.

Visualizar los Meta Fields (metacampos) en WP_Query

Hasta ahora te he mostrado cómo usar WP_Query para encontrar publicaciones que tienen valores específicos para un campo personalizado, pero no cómo mostrar esos campos.

Mostrar estos campos es más o menos lo mismo que antes, pero en lugar de usar get_the_ID() para especificar el ID de get_post_meta() lo especificamos en un contexto de objeto. Así que en nuestro bucle, que puedes ver más abajo, el ID se recupera de forma un poco diferente usando $query->post->ID.

$sw_args = array(
	'post_type' => 'films',
	'meta_query' => array(
		array(
			'key' => 'director',
			'value' => array( 'George Lucas', 'Richard Marquand', 'Irvin Kershner' ),
			'compare' => 'IN',
		),
                array(
			'key' => 'film_title',
			'value' => 'Phantom Menace', 'Attack of the Clones', 'Revenge of the Sith' ),
			'compare' => 'NOT LIKE'
		),

	)
);
$query = new WP_Query( $sw_args );
if ( $the_query->have_posts() ) {
     echo '<h2>Films By Star Wards Directors</h2>';
     echo '<ul>';
		while ( $the_query->have_posts() ) {
			$the_query->the_post();
			echo '<li><ul>';
			echo '<li>' . get_the_title() . '</li>';
			echo '<li>' . get_post_meta( $query->post->ID, 'director', true ). '</li>';
			echo '</ul></li>''
		}
        echo '</ul>';
}
/* Restore original Post Data */
wp_reset_postdata();

Usar WP_User_Query

Al igual que en la última parte cuando usamos WP_Query para encontrar publicaciones con ciertos valores para varios campos personalizados, podemos usar WP_Query equivalente de la tabla de usuario de WP_User_Query.

Por ejemplo, si tuviéramos un campo personalizado llamado subscriber_level y quisiéramos encontrar sólo aquellos usuarios que tuvieran el nivel de suscriptor de extra_special o super_special podríamos, de la misma manera que buscamos las películas dirigidas por los tres directores de las películas de Star Wars:

$args = array(
	'meta_query' => array(
		array(
			'key'     => 'subscriber_level',
			'value'   => array('extra_special', 'super_special' );
			'compare' => '='
		)
	)
 );
$user_query = new WP_User_Query( $args );

if ( ! empty( $user_query->results ) ) {
	echo '<h3>Extra and Super Special Users</h3>';
	echo '<ul>';
	foreach ( $user_query->results as $user ) {
		echo '<li>' . $user->display_name . '</li>';
	}
	echo '</ul>';
}

Al igual que con WP_Query, podemos combinar diferentes comparaciones para controlar mejor qué usuarios devuelven nuestra consulta. El siguiente ejemplo combina la última consulta con una consulta, esta vez de la propia tabla wp_users para cualquier usuario cuyo nombre sea Luke, Han o Leia.

$args = array(
	'meta_query' => array(
		array(
			'key'     => 'subscriber_level',
			'value'   => array('extra_special', 'super_special' );
			'compare' => '='
		)
	),
	'search'         => array( 'Luke', 'Han', 'Leia' ),
	'search_columns' => array( 'user_nicename', 'display_name' ),
 );
$user_query = new WP_User_Query( $args );
if ( ! empty( $user_query->results ) ) {
	echo '<h3>Extra and Super Special Users Named Luke, Han or Leia</h3>';
	echo '<ul>';
	foreach ( $user_query->results as $user ) {
		echo '<li>' . $user->display_name . '</li>';
	}
	echo '</ul>';
}

Terminando

En esta serie has sido introducido a los meta data (metadatos) de WordPress y has aprendido algunas lecciones sobre los conceptos básicos del PHP a lo largo del camino.

Has aprendido a obtener los valores de los campos que almacenan los metadatos de los mensajes y usuarios y a construir consultas para los mensajes y usuarios basadas en los metadatos. Con este conocimiento puedes estar preparado para trabajar con unos pocos campos personalizados y en camino de usar WordPress como un complejo sistema de gestión de contenidos.