Vamos a ver como podemos personalizar el bucle de WordPress para modificar los datos a mostrar, por ejemplo podemos ordenar o indicar cuantos elementos queremos mostrar. Mediante el bucle, podemos crear consultas complejas sin conocimientos de SQL.
El objeto wp_query
Wp-query es una clase definida en WordPress que facilita la creación de consultas SQL y modificar la consulta a base de datos que luego pintaremos con el bucle de WordPress.
Vamos a ver un ejemplo de su funcionamiento:
<?php
$ejemplo = new WP_Query('post_per_page=3');
while ($ejemplo->have_posts()):
$ejemplo->the_post();
the_title();
endwhile;
?>
En este ejemplo se mostraran solo los 3 primeros registros, ya que hemos definido el parámetro: post_per_page.
Parámetros de una consulta
Veamos los posibles parámetros para configurar una consulta personalizada:
- p=X: Carga el ID indicado.
- name=enlace-permanente: Carga los artículos que su enlace permanente coincide con lo indicado.
- post_status=X: Carga en función del estado de los artículos: Pending, draft, Published, Future, Private, Trash y Auto-Draft.
- ignore_sticky_posts: Evita que en el bucle se muestren las entradas fijas en el inicio del mismo. Las entradas fijas son aquellas que se marcan como Fijas desde visibilidad del artículo.
- post_type=X: Para filtrar entre entradas/artículos (post) o páginas (page). también es posible indicar: Adjuntos (Attachment), Menú de navegación (Navigation menu) y artículos en revisión (Revision).
- posts_per_page=X: Número de registros a mostrar.
- offset=x: Ignorar las primeras X entradas.
- pagename=X: Es posible cargar una página indicando su nombre.
- page_id=X: Es posible cargar una página conociendo su ID.
- cat=X,X,X: Cargamos las entradas de unas categorías concretas.
- category_name=X: Cargamos las entradas de una categoría.
- tag_id: Cargamos las entradas de una etiqueta.
- tag=X,X,X: Cargamos entradas en función de las etiquetas establecidas.
- author=X o author_name=X: Cargamos entradas del autor.
- monthnum=X: Se cargan las entradas del mes.
- day=X: Se cargan las entradas del día.
- year=2015: Se cargan las entradas del año 2015.
- orderby=title: ordenamos las entradas por título.
- order=ASC: Ordenamos ascendentemente ASC o descendentemente DESC.
- meta_key=X: Si hemos creado campos personalizados, podemos filtrar por los artículos que tienen un campo personalizado sea cual sea su valor.
- meta_value=X: Cargamos las entradas que tengan como valor de un campo personalizado el indicado.
Ejemplos
//Página con ID=2
$ejemplo = new WP_Query('post_type=page&p=2');
//Recuperar 5 entradas empezando por la 3ª ordenado por title
$ejemplo = new WP_Query('post_type=post&posts_per_page=5&offset=2&orderby=title');
//Recuperar las entradas que sean de la categoría 5, que tengan la etiqueta wordpress y sena del año 2015
$ejemplo = new WP_Query('post_type=post&cat=5'&tag=wordpress&year=2015);