Hace algunos meses salio la gran esperada versión 3 de WordPress. Aquella que unificaba WordPress MU con WordPress normal y que añadía los custom posts y las custom taxonomies como una serie de funciones que ya nos permitían salir totalmente de del uso de WordPress como generador de blogs o páginas web textuales y nos permite crear una completa y compleja web a nuestra medida. WordPress ha entrado en terrenos reservados hasta ahora a Drupal y Joomla.

He estado haciendo algunas pruebas y tras entender el sitema es cierto que podemos llegar a montar muchos tipos de webs con estos nuevos añadidos -aunque siempre dentro del orden de datos de wordpress-. En este post intentaré explicar paso a paso como crear las bases de una completa web de clasificados usando wordpress como base.

Empezaremos por el principio -como no- y definiremos como vamos a trabajar para que nuestro código de wordpress sea mínimamente amigable -algo que cuesta mucho conseguir con este sistema tan mal estructurado-. Antes de intentar algo así, debemos tener un poco de experiencia sobre la estructura de programación seguida en wordpress para meternos en este tipo de tareas por lo que recomiendo leer los distintos contenidos del post que publiqué hace tiempo sobre cómo programar en wordpress; sobretodo todo lo referente a acciones y filtros de wordpress.

Includes para ordenar un poco la locura de wordpress

Para empezar lo que haremos será incluir simplemente un include en el archivo «functions.php» de nuestro theme que nos permita separar en un archivo aparte todo lo que vamos a añadir. Este archivo tiende a crecer y crecer con pequeñas funciones de los temas por lo que yo recomiendo separar un poco el código ya que si no al cabo de unos meses no habrá quien pueda tratar lo que hay hecho.

Así que al principio de dicho archivo simplemente añadiremos este include:

include('adds/inline_in_functions.php');

Luego, dentro del propio tema añadiremos la carpeta «adds» y dentro de esta crearemos la menos 2 archivos (quizás más adelante alguno más, pero de momento con 2 creo que basta para separar el código).

Creamos «inline_in_functions.php» y dentro empezamos por declarar una acción «init» -ejecutada al inicio de wordpress- en la que otra vez, simplemente añadiremos un include para separar el código de Init (donde vamos a hacer la mayor parte de los cambios) del resto.

// adding init action as include...
add_action( 'init', 'launchInitScript' );
function launchInitScript() {
  include('init.php'); 
}

Bien! Ahora ya tenemos un archivo separado donde manejar todo el hilo de funciones al inicio del wordpress y otro donde seguir añadiendo pequeñas funciones. Dejémonos ya de incluir archivos y empecemos de una vez con nuestro proposito…

Añadiendo un Custom Post

Empezaremos por añadir un nuevo custom post que representará un tipo de producto de nuestro catálogo. Para ligar el tema con las explicaciones de wordpress diremos que lo que vamos a crear, en vez de posts, serán fichas de libros. Para hacer este añadido debemos usar la función register_post_type(). Veamos un ejemplo:

// dentro de adds/init.php
$args_labels = array(
  'name' => 'Libros', // Nombre del tipo de post creado
  'singular_name' => 'Libro', // Nombre en singular
  'add_new' => 'Añadir 1', // Texto para representar en menús y botones la accion de "añadir uno nuevo"
  'add_new_item' => 'Añadir nuevo libro', // Titulo de la página del admin para añadir un nuevo elemento
  'edit_item' => 'Editar Libro', // Texto del link para editar este tipo de elementos
  'new_item' => 'Añadir Libro', // Texto para el botón de "añadir nuevo" en el botón de la cabecera de wordpress
  'view_item' => 'Ver Libro', // Texto para el botón de "ver" en este tipo de elemento
  'search_items' => 'Buscar Libros', // Texto para el buscador de este tipo de elemento
  'not_found' =>  'No se han encontrado libros', // Texto para mostrar que no hay resultados
  'not_found_in_trash' => 'No encontrado libros en la papelera', // Texto para mostrar que no hay resultados en la papelera
  'parent_item_colon' => '' 
  );
  $args = array(
    'labels' => $args_labels, 
    'public' => true, 
    'publicly_queryable' => true,
    'show_ui' => true, 
    'query_var' => true,
    'rewrite' => true,
    'capability_type' => 'post',
    'hierarchical' => false,
    'menu_position' => 5, // 5 - below Posts, 10 - below Media, 20 - below Pages, 60 - below first separator, 100 - below second separator
    'supports' => array('title','editor','author','thumbnail','excerpt','comments'), // Elementos que contendrá la página de añadir y editar elementos
  'rewrite' => array(
    'slug' => 'libro', // a la hora de crear las urls, cual es la carpeta que contendrá estos elementos
    'with_front' => FALSE
  )
); 
// Con los arrays creados, por fin llamamos a la función Register post Type:
register_post_type('book',$args);

Ahora -tras añadir este código- podemos entrar en el administrador. Encontraremos el nuevo tipo de elemento aparte de posts y páginas: los «Libros». Entramos y creamos nuestro primer elemento, por ejemplo «El Perfume» que tiene por slug: «el-perfume» y por tanto su url final donde podremos ver este libro será algo así como «http://midominio.com/libros/el-perfume».

Sobre esto último, Debemos tener cuidado con los permalinks ya que no se actualizan solos. Tras cada cambio debemos entrar en Ajustes > Permalinks y actualizarlos. Se recomienda seleccionar Estructura personalizada e indicar simplemente: «/%postname%» sin más variables para evitar lo máximo posible las coincidencias. Prueba con unos permalinks así de simples, luego ya jugarás a dejarlos a tu manera.

Ahora que ya vemos nuestros libros seguramente querremos una maqueta ligeramente distinta que la de los
posts para los libros. Para ello wordpress ha cambiado un poco la jerarquía de plantillas:

Vemos que podemos crear una plantilla especial con el nombre «single-[[Nombre del tipo de post]].php» en nuestro tema. Así que copiamos nuestro single.php le hacemos algún cambio notorio y lo subimos como single-book.php (recordemos que pese a que visualmente estamos creando el el elemento «libros», al lanzar register_post_type() le hemos llamado «book» en la primera variable.)

Añadiendo una Custom Taxonomy

Ahora que ya podemos crear nuevos tipos de elementos en wordpress, lo que nos queda es ver como los organizamos. ¡El nuevo tipo de elemento no va a disponer de Categorías y tags por defecto!

Para añadir distintas clasificaciones lo que haremos será usar la función register_taxonomy() que viene a ser el equivalente a register_post_type pero en categorías. Añadiremos entonces una categorización por «tipos de libros» que afecta al tipo de post «Libro», que hemos llamado «book» internamente (También podríamos añadir categorízaciones nuevas para los posts o paginas llamando a «posts» o «pages»).

// dentro de adds/init.php

register_taxonomy('book_type', 'book', array(
  'label' => 'Tipos de libros',
  'singular_label' => 'Tipo de Libro',
  'public' => true,
  'show_tagcloud' => false, 
  'hierarchical' => true,
  'query_var' => true,
  'rewrite' => array(
    'slug' => 'tipo-libro'
  )
));

A destacar que con esta misma función podemos añadir las clasificaciones en forma de Tags o de Categorías que queramos. Simplemente debemos ir haciendo varias llamadas a register_taxonomy() jugando con los parámetros show_tagcloud e «hierarchical». El primero hace que la nueva clasificación se vea como tag en vez de como categoría y el segundo manipula si las categorías pueden ser unas hijas de otras -mas ligado normalmente al comportamiento de categorías que de tags-.

// estilo categorías:
'show_tagcloud' => false, 
'hierarchical' => true,

// estilo tags:
'show_tagcloud' => true, 
'hierarchical' => false,

También resulta interesante echarle un ojo a las posibilidades que se nos dan al declarar el array «labels» donde podemos especificar todos los textos que acompañarán a la administración de la nueva taxonomía para hacerlo todo más lógico y natural. En caso de no usarlo veremos cosas como que al ver en el admin el cuadro de «Tipos de libros» estos se organizan internamente en «Todas las Categorías» y nos permite «Añadir nueva categoría». Por otro lado si hacemos mucho uso de Taxonomías puede resultar realmente incomodo declarar todos los textos de las mismas… Todo dependerá de hasta que punto necesitas decorar el admin.

Bien, una vez hemos añadido nuestra nueva taxonomía podemos ir a nuestro administrador y en la sección «libros» veremos un nuevo elemento del menú «Tipos de lirbos». Entramos y creamos la categoría «de bolsillo» con el slug «de-bolsillo». Ahora al editar o añadir nuevos elementos nos encontramos a la derecha con el nuevo cuadro de selección de categorías donde podemos escoger «de bolsillo». Editemos algunas de nuestras entradas para asignarles esta categoría…

Ahora, con varios elementos asignados a la categoría «de-bolsillo» podemos entrar en la url de esta clasificación y ver los elementos. Si no has hecho cosas raras con los permalinks debería ser una cosa parecida a esta «http://midominio.com/tipo-libro/de-bolsillo».

El problema es que esta va a ser la típica plantilla de posts. No nos gusta, ¡no nos gusta nada! Fijandonos otra vez en la jerarquía de plantillas de wordpress vemos que podemos asignar una plantilla especifica para estos listados creando un archivo llamado «taxonomy-[[nombre interno del tipo de taxonomía]].php» así que, como antes, copiamos el archivo llamado «category.php», lo alteramos un poco y le ponemos el nombre «taxonomy-book_type.php». Ya tenemos plantillas especificas para nuestra taxonomía.

No olvidemos que en esta nueva plantilla nada nos impide manipular el orden de los posts con la funcion query_posts y mostrarlos como nos convega (¿quien dice que el orden cronológico sea el mejor para los libros?). Puedes leer un artículo de aNieto para ver como controlar bien la páginación al hacer este tipo de alteraciones en el query_posts.

Para terminar con todo esto solo nos quedará poder mostrar en nuestras plantillas el acceso a este tipo de categorías. Si no, ningún usuario podría acceder a ellas ;). Para ello pdeberemos usar la función wp_list_categories() que hace la nos permite mostrar cualquier tipo de categorización de la forma acostumbrada. Para llamarla nada tan sencillo como declarar en en el campo «taxonomy» el tipo de taxonomía de la que queremos listar sus categorías, en este caso «book_type», que es string con el que hemos declarado la nueva taxonomía.

$args = array(
    'orderby'            => 'name',
    'order'              => 'ASC',
    'show_last_update'   => 0,
    'style'              => 'list',
    'show_count'         => 0,
    'hide_empty'         => 1,
    'use_desc_for_title' => 1,
    'child_of'           => 0,
    'hierarchical'       => true,
    'title_li'           => 'Tipos de Libros',
    'number'             => NULL,
    'echo'               => 1,
    'depth'              => 0,
    'current_category'   => 0,
    'pad_counts'         => 0,
    'taxonomy'           => 'book_type'
); 
echo wp_list_categories( $args ); 

De la misma forma podremos usar la función get_the_term_list() para mostrar al mostrar nuestro elemento en su página individual las taxonomías a las que está suscrito.

ID, 'book_type', 'Tipo de Libro: ', ', ', '' ); ?>

Esto, pensando en nuestra finalidad, -crear una web de clasificados- nos va a permitir crear como taxonomía, ya sea con forma de categoría o de tag, cualquier cualidad o característica de nuestro elemento. De esta forma podremos ir listando nuestros elementos por cualquiera de sus atributos y mostrar listados individuales de cada uno de estos tipos. Sigamos con el caso de nuestro sistema de clasificación de libros: nada nos impide manejar como taxonomía aspectos como…

– Autores
– Idiomas
– Precios (de 5 a 10, de 10 a 20, etc.)
– Formatos
– Puntos de venta
– Años de edición
– Género
– Etc.

Si, es cierto, acabaremos declarando cientos de caracteristicas y eso en un sistema como wordpress que no destaca por su rendimiento puede no ser lo más productivo. Sin embargo siempre contamos con sistemas de cacheo para que no se nos disparen cpu y ram… ¡tu decides!

Añadiendo Custom Fields (o campos personalizados)

¿No te basta con la categorización y con controlar tus maquetas para cada tipo de contenido y para cada tipo de taxonomía? ¿Necesitas más campos con los que ir clasificando tus fichas de productos? No hay problema porque para eso ya teníamos y podemos aprovechar los campos personalizados de wordpress.

Este es un sistema con el cual podemos añadir campos concretos asociados a cualquier post -o custom post en nuestro caso-. Por defecto pueden trabajarse estos campos con una interfaz que viene ya de serie en el admin de wordpress. La podemos encontrar bajo el texto de cualquier post con el nombre «Campos personalizados» pero no es precisamente usable y segura, por lo que yo preferiría no usarla y pasar a configurar estos campos creando en el admin bloques nuevos hechos a medida para lo que vamos a guardar.

Para mostrarlo con un ejemplo, que siempre es más fácil, lo que haremos será crear como custom field campo personalizado «Precio» asociado a cualquier elemento de libro.

En esta parte de nuestro desarrollo usaremos las acciones (ver referencia de acciones) de «admin_menu» para marcar el punto donde vamos a actuar y los filtros (ver referencia de filtros) de «add_meta_box» para añadir el nuevo cuadro en el admin y de «save_post», «publish_post» y «delete_post» para guardar lo que escribamos en esos campos como campo personalizado del custom post. Sobre como añadir este tipo de variables hay varios post en castellano por internet (la mayoría con el ejemplo de como añadir un Subtitulo a los post) así que no voy a extenderme mucho más explicándolo. Simplemente recalcar que al identificar donde añadimos el add_meta_box() deberemos marcar el string que hemos asignado a nuestro custom post -en nuestro caso «book»- para que se añada el cuadro a su propia página de añadir nuevo elemento y editar elemeneto. Seguidamente un código de ejemplo:

// dentro de adds/inline_in_functions.php

// Apadiendo funciones a lanzar en la acción 'admin_menu'
add_action('admin_menu', 'launchAdminMenuScript');
function launchAdminMenuScript() { 
  // Añadiendo cuadro de precio al formulario
  add_meta_box('precio','Precio','addAdmin_Precio','book','normal','high');
  // notese que marcamos el entorno como 'book'
}

// funcion llamada para crear el add_meta_box
function addAdmin_Precio()
{	
  $fieldName = 'price';
  $labelName = 'Precio';
  global $wpdb, $post;
  echo ''.$labelName.'';
}

//Añadiendo que el campo se guarde como custom field: http://codex.wordpress.org/Custom_Fields 
add_action('save_post', 'guardar_precio');
add_action('publish_post', 'guardar_precio');
add_action('delete_post', 'borrar_precio');
function guardar_precio() {
  $fieldName = 'price';
  global $wpdb, $post;
  $post_id=($post_id)?$post_id:$_POST['post_ID'];
  if (!$post_id) return $post;
  update_post_meta($post_id, $fieldName, $_POST[$fieldName]);
}
function borrar_precio() {
  $fieldName = 'price';	
  global $wpdb, $post;
  $post_id=($post_id)?$post_id:$_POST['post_ID'];
  if (!$post_id) return $post;
  delete_post_meta($post_id, $fieldName);
}

A partir de estos añadidos veremos como se añade bajo el cuadro de texto del admin de libros un nuevo cuadro donde podemos escribir el precio de los libros.

Para luego mostrar en nuestras themes esta nueva variable lo más seguro es que usemos la función get_post_meta() que nos permite rescatar cualquier custom field asociado a un post (también es posible que queramos extraerlos todos a la vez con la función the_meta() pero en la práctica seguramente preferiremos sacar cada uno de estos datos cuando los necesitamos uno a uno).

Su uso es bastante simple, por ejemplo para sacar el precio dentro del loop del post:

Precio: ID, 'price', true); ?>

Urls con filtros

¿Y que nos falta para terminar de considerar a nuestra web en wordpress toda una web de clasificados? Pues los filtros. No hay web de clasificados que no ofrezca al usuario distintas formas de ordenar los contenidos que ve. WordPress por defecto lo ordena todo por fecha de creación y aunque ya hemos visto antes que podemos cambiar ese orden para cualquier plantilla lo cierto es que es iluso pensar que todos los usuarios se conformarán con el orden de elementos que nosotros les demos.

Para este útlimo paso lo que haremos será mezclar lo que ya conocemos sobre ordenar de los post en wordpress con el uso de las expresiones regulares de este para crear urls de que modifiquen el orden de aparición de los elementos. Más o menos vendrá a ser lo explicado en la última parte de dicho artículo solo que adaptado a todas las taxonomías que hayamos creado en vez de a la categorización genérica de WordPress. Por favor, lee el artículo porque no voy a entrar aquí en detalle de porque se usan las funciones que se usan.

Lo dicho. Simplemente, se trata de crear las expresiones regulares concretas que ordenarán nuestros posts pero deberemos hacerlo (como decíamos) para cada una de las taxonomías creadas. Veamos un ejemplo de como sería la creación de urls que ordenen los post de tipo «libro», en la taxonomía de «tipo de libro» por el valor del campo personalizado «precio», mezclando todo lo tratado en este último punto…

// dentro de adds/inline_in_functions.php

//Añadiendo nuevas reglas de rewrite: http://codex.wordpress.org/Function_Reference/WP_Rewrite
add_filter('rewrite_rules_array','addOrders');
// añadiendo la nueva regla de orden.
function addOrders($rules)
{
  //querypost vars at: http://codex.wordpress.org/Template_Tags/query_posts
  $newrules = array();

  // "tipo libro" por "precio"
  // NOTA: usar la declaración con comillas simples (') para que las variables $matches no sean reemplazadas en la propia declaración
  $newrules["tipo-libro/([^/]+)/por-precio/?$"] = 'index.php?orderby=meta_value_num&meta_key=precio&order=asc&book_type=$matches[1]';

  // Y lo mismo pero para resultados páginados
  $newrules["tipo-libro/([^/]+)/por-precio/page/?([0-9]{1,})/?$"] = 'index.php?book_type=$matches[1]&paged=$matches[2]&orderby=meta_value_num&meta_key=precio&order=asc';

  // añadimos las reglas al PRINCIPIO del array	
  $rules = $newrules + $rules;
  return $rules;
}

// FLUSH!!!!
add_filter('init','flushRules');
// Hay que hacer flush de las reglas al menos una vez para que se den de alta.
function flushRules(){
  global $wp_rewrite;
  $wp_rewrite->flush_rules();
}

Bien, ahora ya podemos probar a cargar las urls que acabamos de crear:

– http://midominio.com/tipo-libro/de-bolsillo/por-precio
– http://midominio.com/tipo-libro/de-bolsillo/por-precio/page/2

Y ver como el orden los posts pasa a depender del precio que les hemos indicado en el campo personalizado «precio».

Alguien puede pedir más?