Una forma de mejorar el SEO de nuestro sitio es creando un mapa de su contenido. Este mapa del sitio no solo ayuda a los buscadores a descubrir nuestro contenido, también ayuda a los visitantes en este descubrimiento. Con Genesis Framework crear un mapa de sitio es muy fácil.

¿Ya conoces el Archivo Cyberia.MX? Contiene todas las páginas publicadas, la lista de categorías, de autores (aunque por el momento solo aparezco yo) y los 100 post más recientes. Esta página usa una plantilla personalizada que contiene el código que produce el resultado. Lo único que hice fue crear una página y seleccionar la plantilla Archivo. Eso fue suficiente para tener mi mapa del sitio tal como la ves.

En este tutorial para Genesis Framework veremos cómo crear una página de archivo y al mismo tiempo vamos a revisar detalladamente las etiquetas de plantillas de WordPress relacionadas con el archivo. Crear un plantilla de página

Como vimos en el artículo anterior sobre cómo crear una portada personalizada vimos que para crear una plantilla de página (en inglés Template Page) lo único que necesitamos es insertar el comentario Template Name: Archivo, pero para mejorar la legibilidad de nuestro código, agregamos comentarios adicionales. Veamos la primera parte del código:

<?php
 /**
   * Template Name: Archivo
   * Esta plantilla crea un mapa del sitio.
   *
   * @category Cyberia
   * @package  Plantilla
   * @author   Cyberia.MX
   * @license  http://www.opensource.org/licenses/gpl-license.php GPL v2.0 (or later)
   * @link     http://cyberia.mx/tag/genesiswp
   **/

Realmente solo es necesario incluir el contenido de la línea 3, pero el resto del código nos proporciona información importante y nos permite utilizar documentadores de código como por ejemplo phpDocumentor o apigen.

Eliminar y agregar acciones de los hooks en Genesis WordPress

Los hooks son “ganchos” de los que colgamos acciones en Genesis Framework, lo que nos permite crear fragmentos de código y contenido y colocarlos en cualquiera de los hooks que define Genesis Framework.

Esto nos permite crear nuestro sitio web como si fuera un figura hecha con bloques de lego, y las posibilidades son verdaderamente inmensas. Poco a poco iremos descubriendo en esta serie todas las posibilidades de los hooks.

En Genesis Framework existen ¡51 hooks! lo que nos permite controlar todo nuestro sitio, pero en nuestra plantilla de página solo vamos a utiliza el hook genesis_post_content. Este hook controla la salida del contenido del post o página y si existe la imagen destacada, pero dentro del div #content.

Primero vamos a desactivar del hook la acción preprogramada por Genesis Framework y que llama a la función interna genesis_do_post_content. Para desactivar esta acción usamos la función remove_action, que tiene dos parámetros: el primero es el hook y el segundo es la acción o función que colgamos en el hook:

/** Desactivar la acción preprogramada por Genesis Framework **/
remove_action( 'genesis_post_content', 'genesis_do_post_content' );

La siguiente actividad es agregar una acción a este mismo hook. Recuerda que las acciones son funciones cuya salida se coloca en ese “gancho”, así que procura darle a tu acción/función un nombre que te ayude a comprender para qué existe.

Tenemos que usar la función add_function que tiene dos parámetros obligatorios y un tercero opcional: el primero es el nombre del hook, el segundo es el nombre de la acción/función que colgamos a dicho hook y el tercero, que es opcional, es la prioridad (si más de una acción está colgada al mismo hook se coloca primero la acción de prioridad más baja); en nuestro hook esta acción es la única, por lo que agregar prioridades resulta ocioso.

add_action( 'genesis_post_content', 'cyberia_mapa_de_sitio' );

Llamamos a la acción cyberia_mapa_de_sitio porque va a producir el contenido de nuestro mapa del sitio, lo que ayudará a los visitantes y a los motores de búsqueda a descubrir y recorrer todo nuestro sitio.

Acciones que crean contenido en Genesis Framework

La acción cyberia_mapa_de_sitio es una función que creará el contenido en nuestro sitio. Va a crear la lista de categorías, la lista de archivos por meses, la lista de autores y una lista con los 100 artículos más recientes.

Lo primero que hacemos es crear la función y cerrar el código PHP para mezclar el código con etiquetas HTML.

function cyberia_mapa_de_sitio() { ?>

A partir de este punto y hasta el cierre de la función mezclaremos las etiquetas del HTML y el código PHP.

Lista de Páginas

La salida de esta función se muestra en dos columnas. Cada columna está englobada en una capa con el estilo que permite visualizarlas una a lado de la otra.

<div class="archive-page">
   <h4>Páginas</h4>
   <ul>
     <?php wp_list_pages( 'title_li=' ); ?>
   </ul>

La función wp_list_pages¹ muestra una lista de páginas con sus enlaces, toma varios argumentos en un arreglo, pero nosotros solo vamos a utilizar title_li sin ningún valor, para producir una salida de elementos englobada entre etiquetas <ul> </ul>.

Al final de este artículo encontrarás enlaces a todas las funciones utilizadas.

Lista de Categorías

<h4>Categorías</h4>
<ul>
    <?php wp_list_categories( 'sort_column=name&title_li=' ); ?>
</ul>

Con este fragmento de código, mostramos la lista de categorías, usando la función wp_list_categories², y damos como argumentos que ordene la lista usando el nombre, es decir, por orden alfabético con sort_column=name y que no agrega nada a los elementos de la lista con title_li=.

<ul>
  <?php wp_list_categories( 'sort_column=name&title_li=' ); ?>
</ul>

Archivos Mensuales

La tercera sección de nuestra columna corresponde a los archivos mensuales. Aquí presentamos un enlace que lleva a cada mes que contenga artículos en nuestro blog, una de las muchas formas de presentar información que nos proporciona Genesis Framework y WordPress.

<h4>Archivos Mensuales</h4>
  <ul>
    <?php wp_get_archives( 'type=monthly' ); ?>
  </ul>

</div><!-- end .archive-page-->

La función utilizada es wp_get_archives³ y le indicamos en el parámetro que nos muestre los archivos mensuales con type=monthly.

Con esta sección cerramos la primera columna.

Lista de los archivos de un blog

La columna de la derecha contiene la lista de los 100 artículos más reciente de este blog, e inicia con la capa que forma la segunda columna de nuestro mapa de sitio.

<div class="archive-page">

   <h4>Artículos Recientes</h4>
   <ul>
     <?php wp_get_archives( 'type=postbypost&limit=100' ); ?>
   </ul>

 </div><!-- end .archive-page-->
 ```

En esta sección volvemos a hacer uso de la función `wp_get_archives`[^3] pero ahora con diferentes argumentos.

* **`type=postbypost`**. Significa que muestre los artículos o posts enlistados por el título del post
* **`limit=100`**. Establecemos el límite de artículos que queremos mostrar. En el caso de Cyberia.MX mostramos los 100 artículos más recientes.

### Cierre de una plantilla en Genesis Framework

Para terminar nuestra plantilla llamamos al motor de nuestro blog. No tenemos que agregar encabeza, pie de página, barras laterales o códigos adicionales. [Genesis Framework][gen] colocará la salida de nuestra acción en el lugar adecuado, es decir en el gancho o _hook_ que especificamos.

```php
<?php
}

genesis();

Este es un ejemplo sencillo de la potencia que nos proporciona Genesis Framework.

Código completo, plantilla Archivo

Aquí tienes el código completo de la plantilla.

<?php
 /**
   * Template Name: Archivo
   * Esta plantilla crea un mapa del sitio.
   *
   * @category toledano
   * @package  Plantilla
   * @author   Cyberia.MX
   * @license  http://www.opensource.org/licenses/gpl-license.php GPL v2.0 (or later)
   * @link     http://yo.toledano.org/tag/genesiswp
   **/

 /** Desactivar la acción preprogramada por Genesis Framework **/
remove_action( 'genesis_post_content', 'genesis_do_post_content' );
add_action( 'genesis_post_content', 'toledano_mapa_de_sitio' );

/**
 * Esta función produce como salida un mapa del sitio en un esquema de dos
 * columnas, con etiquetas, categorías, archivos mensuales, autores y los archivos más recientes.
 */

function toledano_mapa_de_sitio() { ?>

  <div class="archive-page">

    <h4>Páginas</h4>
    <ul>
      <?php wp_list_pages( 'title_li=' ); ?>
    </ul>

    <h4>Categorías</h4>
    <ul>
      <?php wp_list_categories( 'sort_column=name&title_li=' ); ?>
    </ul>

    <h4>Archivos Mensuales</h4>
    <ul>
      <?php wp_get_archives( 'type=monthly' ); ?>
    </ul>

  </div><!-- end .archive-page-->

  <div class="archive-page">

    <h4>Artículos Recientes</h4>
    <ul>
      <?php wp_get_archives( 'type=postbypost&limit=100' ); ?>
    </ul>

  </div><!-- end .archive-page-->

<?php
}

genesis();