Muchas veces tener simplemente “título”, “entrada” y “extracto” en WordPress como campos de texto al administrar una noticia no es suficiente para un sitio y necesitamos algún campo extra como “subtítulo”, “volanta”, “fuente”, o cualquier otro tipo de campo propio. Normalmente esto se puede gestionar usando los custom fields, pero la administración de estos campos no es tan simple o intuitiva para usuarios no avanzados y no está disponible para todos los niveles de usuario.

Para uno de los proyectos de Nicestream, en el que trabajan varios editores, necesitábamos agregar un par de campos personalizados a la administración de noticias que fuesen claros al agregar y editar. Mi idea era hacerlo sin tener que modificar el código de WordPress, para evitar bugs, tener todos estos cambios en un solo lugar y no preocuparnos al tener que actualizar el backend (en este caso la versión MU).

Hay actions y filters que permiten agregar y modificar con funciones simples distintas áreas del blog, así que la mejor solución era crear un plugin especial para mostrar los nuevos campos en la edición de posts aprovechando eso. Pero no fue tan fácil encontrar documentación y ejemplos al respecto, y tuve que revisar varias fuentes diferentes y pensar algunas cosas con Javi (estas cosas se piensan más rápido con una mente de programador) para sacarlo.

Como creo que puede ser interesante y necesario para otros, se me ocurrió compartir el código para que puedan aprovecharlo y usarlo como base si necesitan algo similar. Eso sí, el código funciona a partir de la versión 2.5 de WordPress.

1: Definir los campos a agregar

Voy a usar de ejemplo un campo para agregar un subtítulo. Primero definimos en una función un espacio en el que va a aparecer nuestro campo cuando escribamos o editemos un post:

add_action('admin_menu', 'agregar_campos');
function agregar_campos() {
	add_meta_box('subtitulo', 'Subtítulo', 'fn_subtitulo', 'post', 'normal', 'high');
}

La acción “admin_menu” sirve para que se incluya nuestra función en la administración (puede ir en otra parte del código sin problemas).

La función “add_meta_box” nos permite agregar secciones a la administración de páginas, posts y links. Los parámetros que acepta son los siguientes: ('id', 'titulo', 'funcion', 'pagina', 'contexto', 'prioridad') (pueden ver más detalles sobre esta función en el Codex de WordPress).

Entonces, agregamos una sección con el id “subtitulo”, el título de la caja será “Subtítulo”, la función que se ejecutará en esa caja será “fn_subtitulo”, la página en la que aparece será la de administrar posts, el contexto será la parte de edición básica y la prioridad es “alta”, para que aparezca arriba de los otros campos (aunque el título y el texto de la entrada siempre aparecerán primero).

Nosotros estamos usando por ahora 2 campos separados, así que simplemente agregamos otra área usando “add_meta_box” de nuevo dentro de la misma función.

2: Crear las funciones de los campos

En segundo lugar, creamos las funciones que se van a usar en los campos que agregamos:

function fn_subtitulo() {
	global $wpdb, $post;
	$value  = (get_post_meta($post->ID, subtitulo, true));
	echo '<label class="hidden" for="subtitulo">Subtítulo</label>
	<input type="text" name="subtitulo" id="subtitulo" value="'.htmlspecialchars($value).'" style="width: 600px;" />';
}

Primero invocamos las variables globales de la base de datos y de los posts. En segundo lugar definimos la variable $value y usamos “get_post_meta” para obtener el contenido de ese campo si ya existe (lo necesitamos si estamos editando un post en el que ya completamos este campo). Finalmente, incluimos un <input> en el que se puede editar ese campo (si el $value no existe todavía, obviamente lo veremos vacío). El HTML del <input> está copiado del formato usado por otros campos del formulario, pero podemos hacerlo como más nos guste (mientras valide), e incluir algún texto más si hace falta, o usar un <textarea> o lo que necesitemos en este caso. Agregué la función htmlspecialchars al contenido del campo para evitar problemas al guardar y editar textos con caracteres especiales (sobre todo con las comillas).

Si usamos más de un campo, tenemos que crear otra función similar a esta para cada uno de ellos por separado y referenciarla al agregar la “meta_box” correspondiente.

3: Funciones para agregar los campos a la base de datos

Lo siguiente sería crear una función que guarde nuestro campo personalizado en la base de datos:

add_action('save_post', 'guardar_campos');
add_action('publish_post', 'guardar_campos');
function guardar_campos() {
   global $wpdb, $post;
	if (!$post_id) $post_id = $_POST['post_ID'];
	if (!$post_id) return $post;
	$subtitulo= $_POST['subtitulo'];
	update_post_meta($post_id, 'subtitulo', $subtitulo);
}

Primero añadimos dos acciones para que esta función se ejecute tanto al publicar un post como al guardarlo si lo editamos. El resto simplemente controla el contenido enviado por el formulario con el id “subtitulo” y usa la función update_post_meta de WordPress para actualizar el campo personalizado con ese nombre referenciando al post que estamos editando.

Y ya que estamos, agregamos una función similar para eliminar de la base de datos este campo personalizado en el caso de que se borre el post al que pertenece:

add_action('delete_post', 'borrar_campos');
function borrar_campos() {
   global $wpdb, $post;
	if (!$post_id) $post_id = $_POST['post_ID'];
	if (!$post_id) return $post;
	delete_post_meta($post_id, 'subtitulo');
}

Básicamente hace lo mismo que la función anterior, pero se ejecuta sólo al borrar un post, y usa la función delete_post_meta para eliminar el campo personalizado que indiquemos.

Y, de nuevo, si tuviésemos más de un campo, simplemente habría que comprobar el $_POST correspondiente y utilizar “update_post_meta” o “delete_post_meta” de nuevo para cada campo dentro de las mismas funciones.

Recapitulando…

Si organizamos todo esto en un archivo PHP, le agregamos la cabecera que usa WordPress para sus plugins, lo subimos a la carpeta /wp-content/plugins/, y lo activamos desde la administración, estamos hechos.

El código final de este ejemplo quedaría así:

<?php
/*
Plugin Name: Campos personalizados
Version: 1.0
Author URI: http://ldablog.com.ar/
Plugin URI: http://ldablog.com.ar/2008/09/agregar-campos-personalizados-a-la-administracion-de-wordpress/
Description: Plugin para agregar campos personalizados a la administración de posts de WordPress.
Author: Leo
*/

add_action('admin_menu', 'agregar_campos');
function agregar_campos() {
	add_meta_box('subtitulo','Subtítulo','fn_subtitulo','post','normal','high');
}

function fn_subtitulo() {
	global $wpdb, $post;
	$value  = (get_post_meta($post->ID, subtitulo, true));
	echo '<label class="hidden" for="subtitulo">Subtítulo</label>
	<input type="text" name="subtitulo" id="subtitulo" value="'.htmlspecialchars($value).'" style="width: 600px;" />';
}

add_action('save_post', 'guardar_campos');
add_action('publish_post', 'guardar_campos');
function guardar_campos() {
   global $wpdb, $post;
	if (!$post_id) $post_id = $_POST['post_ID'];
	if (!$post_id) return $post;
	$subtitulo= $_POST['subtitulo'];
	update_post_meta($post_id, 'subtitulo', $subtitulo);
}

add_action('delete_post', 'borrar_campos');
function borrar_campos() {
   global $wpdb, $post;
	if (!$post_id) $post_id = $_POST['post_ID'];
	if (!$post_id) return $post;
	delete_post_meta($post_id, 'subtitulo');
}

?>

Pueden copiarlo en un archivo .php con el nombre que les parezca, subirlo a la carpeta de plugins y probarlo.

Y, por último, algo fundamental: Para mostrar este campo en la parte que queramos de nuestro theme, podemos usar la función “get_post_meta” como se ve más arriba u obtenerlo en un array usando “get_post_custom” o “get_post_custom_values“.