Con esta entrada o post comienzo una serie de artículos sobre diferentes snippets de código para WordPress, que no son más que «trocitos» de código que realizan o pretenden realizar tareas concretas.
En este caso voy a explicar el código para modificiar el número de posts por página que establece WordPress o que tal vez nuestro thema también lo haya modificado. En esos casos en los que queramos modificar el número de posts por página en algunas de las páginas de nuestro blog, podemos utilizar el código que pondré a continuación.
Pero antes de nada comentar que procuraré hacer dos partes o más bien hacerlo de dos formas, o tres si me apuras.
En primer lugar vamos a ver cómo hacerlo con programación estructurada y en otro artículo lo haremos con programación orientada a objetos.
Para incluir este código u otros en vuestro blog de WordPress, lo podéis hacer en el fichero «functions.php» de vuestro tema. No hay problema. Lo podeís poner al final del fichero y listo. Eso si, tened cuidado puesto que si lo hacéis en el editor de WordPress y algo falla, tendréis que modificar el fichero «functions.php» descargándolo por ftp y luego volver a subirlo.
Es muy común olvidar algún «;» o algún cierre «}«. Sin más, tenedlo en cuenta.
También podéis crear vuestro propio plugin y dependiendo de algunas cosas, tal vez en otro artículo lo haga en un plugin y así vemos mejor cómo se hace un plugin y vamos practicando.
Comenzamos creando la función que ejecutará el hook:
function number_of_posts_per_page( $number ) { ........ }
Como podemos ver en la función, recibe una variable. Esta variable contendrá el número de posts por página que le indiquemos.
Y ahora el action que ejecutará la función y que es el alma de la programación en WordPress:
add_action('pre_get_posts', 'number_of_posts_per_page');
Lo que hace es ejecutar la función que vamos a crear en el action «pre_get_posts» que como su propio nombre indica tiene lugar antes de cojer los posts para luego mostrarlos. De esta manera, le pasamos el númeor de posts a este hook y el lo hará todo por nosotros.
Ahora bien… Podemos establecer el número de posts por página en diferentes páginas. Como por ejemplo en la página de inicio, en la de búsqueda, en la de etiquetas, etc..
En primer lugar haremos una prueba sólo con la página de inicio.
Supongamos que queremos que en la página de inicio de nuestro blog se muestren los artículos de 15 en 15. Para ello, dentro de la función que hemos comentado antes, especificamos lo siguiente:
if ( is_home() ) { $number->set( 'posts_per_page', 15 ); }
¿Fácil verdad?
Por si acaso comento la jugada: Si «is_home«, osea que si es la página de inicio o inicial de nuestro blog que haga algo:
$number->set( 'posts_per_page', 15 );
Establecer en 15 el número de «posts_per_page» y guardarlo en la variable $number.
Creo que no hay mucho más que decir sobre esto porque se ve muy claro.
Bien, pues ya que estamos, vamos ha tener en cuenta otras páginas para establecer también el número de posts por página. Como por ejemplo las siguientes:
- Página de etiquetas.
- Página de autor.
- Página de búsqueda.
- Página de categoría.
- Página de archivo.
Al igual que con la página de inicio, cada una de las anteriores dispone de un «is_xxx» para saber si se trata de la página en cuestión.
A continuación indico las páginas junto con sus funciones:
Página de inicio. ---> is_home() Página de etiquetas. --> is_tag() Página de autor. ---> is_author() Página de búsqueda. --> is_search() Página de categoría. ---> is_category() Página de archivo. ---> is_archive()
Pues ya tenemos toda la información que necesitamos para completar nuestro snippet WordPress.
Aquí teneís el código completo:
Como he indicado antes, lo podéis incluir en el fichero «functions.php» del theme o hacer un plugin.
Espero que os sea de utilidad.
En posteriores artículos veremos más cosas sobre esto y otras muchas cosas de WordPress.
Saludos.