Dividir una entrada en varias páginas [WordPress]

Al momento de crear una entrada muy larga, como un tutorial por ejemplo, es posible dividir el post en varias páginas de una manera muy sencilla utilizando las etiquetas <!--nextpage-->. Funciona de manera similar a <!--more-->, pero dividiendo completamente el post. Y usándola podríamos obtener resultados como este:

¿Cómo incluir esta característica en nuestra plantilla?

La mayoría de los themes deberían incluir esta importante característica, pero en algunos casos no es así. Por tanto, si la tuya no la posee, tendrás que incluir la función wp_link_pages dentro del archivo single.php (si tu plantilla utiliza ese archivo para mostrar las entradas) o index.php (si se muestran directamente con ese archivo). Los parámetros que podemos pasarle a wp_link_pages son:

• before (string): Texto que va antes de los links. Por defecto <p>.
• after (string): Texto que va antes de los links. Por defecto </p>.
• next_or_number (string): Indica se deben usar los números (number) para las páginas o las palabras Previous y Next (next).
• nextpagelink (string): Texto del enlace siguiente. Por defecto Next page.
• previouspagelink (string): Texto del enlace anterior. Por defecto Previous.
• pagelink (string): Formato para las páginas con número.  Si pones % en el string, será reemplazado con el número de la página.

Por ejemplo:

<?php
wp_link_pages('before=<div class="estilo">Páginas:&after=</div>&pagelink=page %');
?>

Mostraría algo como:

Páginas: Página 1 Página 2 Página 3 Página 4

Todo dentro de etiquetas <div class=”estilo”>, lo que haría muy fácil el proceso de aplicarle un estilo visual con CSS.

También existe una función llamada link_pages, que hace exactamente lo mismo que wp_link_pages. La diferencia es que link_pages, recibe los parámetros por separado, mientras que wp_link_pages los recibe todos en una cadena. IMPORTANTE: la función link_pages se encuentra en estado deprecated, lo que significa que NO se debe usar; siempre utiliza wp_link_pages.

Hacks en la función wp_link_pages()

Si deseas aplicar algún tipo de comportamiento especial a la función wp_link_pages, puedes hacerlo editando el archivo post-template.php, que se encuentra en wp-includes. Debes estar seguro de lo que haces, porque de lo contrario te puedes llevar un susto

En mi caso, por ejemplo, edite dicha función de tal manera que añadiera las etiquetas <span class=”current”> y </span>, para poder aplicar un estilo visual a la “página actual”.

Lo complicado aquí es que debes tener en cuenta el cambio, cuando hagas una actualización de la versión de WordPress. Por tanto es más seguro escribir un plugin, o algo más elaborado. Está en ti decidir qué hacer: un hack rápido y peligroso, o un plugin demorado pero seguro.

Happy hack!

12 Comentarios | deja el tuyo