Tutorial de temas de WordPress para principiantes – Parte 4: El Post Loop
En esta lección del tutorial del tema de WordPress para principiantes, entraremos en detalles sobre el "bucle de publicación" en WordPress; qué es, cómo se ve, por qué lo usamos y cómo acceder a las publicaciones. Luego, implementaremos el bucle en nuestro tema.
El bucle de correos
Si está familiarizado con PHP, puede reconocer que un "bucle" es una técnica para recorrer cada elemento en una matriz u objeto con for, foreacho while. El bucle en WordPress funciona así. Pero usaremos las propias funciones de WordPress para hacer un bucle con el fin de obtener algunos beneficios y simplificaciones adicionales.
En todo momento, WordPress ya ha consultado las publicaciones por usted, según la página en la que se encuentre. Si está en una página de categoría, WordPress ya ha consultado todas las publicaciones asociadas con esta categoría, y si está en una sola página de publicación, WordPress ya ha obtenido esa publicación para usted.
Cuando queremos acceder a las publicaciones que WordPress ha consultado en nuestras plantillas, agregamos el bucle. Dentro del bucle tenemos acceso a cada publicación. Y para cada publicación decidimos qué mostrar o hacer.
Nota: Incluso en las plantillas de una sola publicación o de una sola página, agregará un bucle, ¡aunque sabemos que solo contiene una publicación! El ciclo simplemente se ejecuta una sola vez.
Aquí está el bucle de WordPress en todo su esplendor:
while (have_posts()): the_post();
// Access to each post here
endwhile;Este fragmento de código hace dos cosas. La whileparte (incluido el endwhile) es la parte de bucle que se repetirá independientemente del tiempo que queden publicaciones. La segunda parte es la the_post()que establece un acceso simplificado e intuitivo al objeto de publicación dentro del bucle. Aprenderemos más sobre eso más adelante.
Es una buena práctica envolver el ciclo dentro de una ifverificación que verifique si realmente hay publicaciones para recorrer. Entonces también podemos mostrar opcionalmente un mensaje si no lo hubiera. La consulta de publicación podría estar vacía si va a un archivo de categoría vacío o si intenta buscar algo que no tiene resultados. Esta es una mejor versión del bucle:
¡Familiarícese con este fragmento de código, ya que lo repetirá cada vez que desee acceder a las publicaciones! Implementemos el bucle en nuestro tema.
Implementando el loop en nuestro tema
Agreguemos el bucle en nuestro index.php, reemplazando el texto ficticio.
Agregué una función llamada the_title()dentro del ciclo que hace eco del título de la publicación. Esto es solo para que podamos ver el bucle en la práctica. No se preocupe, en el próximo paso aprenderemos todo acerca de cómo acceder a toda la información real de la publicación.
Veamos qué sucede ahora en WordPress. Actualizar la página principal. Dependiendo de su configuración y contenido, debería ver aparecer algunos títulos. En mi WordPress tengo la publicación predeterminada "¡Hola mundo!" y otra publicación que creé titulada "Esta es otra publicación". Esto es lo que me sale en la portada:
Si intenta visitar una sola página de publicación, debería ver solo un título, el título de la publicación que está viendo. ¡Agradable!
Para los curiosos…
Si tiene curiosidad acerca de por qué está pasando el bucle y qué parámetros usó WordPress para esta consulta, puede consultarlo. La variable global a la que se refiere el bucle se llama $wp_query. Debe definirlo como global para poder acceder a él. Intente usar var_dump()para imprimir su contenido completo. El bucle está recorriendo la $wp_query->postspropiedad.
global $wp_query;
var_dump($wp_query);Agreguemos un detalle importante a nuestro bucle en index.php; una forma para que el usuario navegue a la página siguiente y anterior de publicaciones.
Tenga en cuenta que el ciclo obtendrá la cantidad de publicaciones definidas en su Configuración de WordPress> Lectura, siempre que se encuentre en una página que muestre varias publicaciones. Si hay más publicaciones disponibles en el bucle que el número definido aquí, necesitamos una forma de navegar entre las páginas. Para esto podemos usar la función the_posts_pagination().
Esta función acepta algunos parámetros para personalizar su salida. Puede definir el número de páginas entre los puntos suspensivos (cuando hay muchas páginas). También puede definir cuáles deben ser los textos para los enlaces de página "Anterior" y "Siguiente". Lo agregaré sin ningún parámetro para hacer los valores predeterminados, pero puede ajustarlo si lo desea.
...
while (have_posts()): the_post();
the_title();
endwhile;
the_posts_pagination();
} else {
...Esta función no genera absolutamente nada si hay menos publicaciones o la misma cantidad de publicaciones por configuración de página. Así que no se preocupe si cree que se equivocó porque no ve ningún resultado. Una vez que hay más publicaciones que publicaciones por página, esta función genera un div, un encabezado para lectores de pantalla (que normalmente oculta con CSS) y una serie de enlaces de paginación.
Ahora que sabemos cómo acceder a cualquier publicación que WordPress haya encontrado para nosotros, el siguiente paso es aprender a mostrar lo que queremos de cada publicación; dentro del bucle.