¿Estás pensando en añadir una funcionalidad a WordPress y no sabes por donde empezar a extenderlo? ¿te gustaría hacer las tareas más comunes de tu día a día con el blog sean más fáciles? Pues solo necesitas conocer, como actuar frente a esta pregunta.
¿Como y donde puedo extender WordPress?
WordPress, por defecto, nos presenta 3 formas de extender las funcionalidades de WordPress:
- Mediante actions.
- Mediante filters.
- Mediante declaración de funciones.
Todas ellas sin necesidad de tocar el código propio del núcleo de WordPress, evitando así tener que hacer modificaciones cada vez que actualicemos nuestro Wordpres.
Extender WordPress mediante Actions
Uno de los métodos que podemos usar y que están disponibles el la API de WordPress es el uso de actions. Como su nombre indica, actions son las acciones definidas por el equipo de WordPress en las que podremos añadir nuestras propias funcionalidades.
<?php add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1); ?>
Esta función que tanto hemos visto en plugins o código que hemos mostrado para extender WordPress, hace una función muy importante y cada parámetro aporta un grado más de personalización.
$tag: Nombre del action (ahora los veremos).$function_to_add: Nombre de la función que ejecutaremos al activarse el action ($tag).$priority: Prioridad de ejecución, de menor a mayor.$accepted_args: Aceptamos (o no) el paso de parámetros a nuestra función.
Ejemplo:
<?php
define("TWITTER_USER", 'username');
define("TWITTER_PASS", 'password');
define("TWITTER_MESSAGE", '[Post] %name%: %link% <-- %title%');
function update_twitter($post_ID = '') {
$curl_handle = curl_init();
// Nombre del blog
$message = str_replace("%name%", get_bloginfo('name'), TWITTER_MESSAGE);
// Cargamos el post
$post = get_post($post_ID);
// Enlace y título
$message = str_replace("%link%", $post->guid, $message);
$message = str_replace("%title%", $post->post_title, $message);
// Enviamos el Tweet
curl_setopt($curl_handle, CURLOPT_URL, 'http://twitter.com/statuses/update.xml');
curl_setopt($curl_handle, CURLOPT_CONNECTTIMEOUT, 2);
curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl_handle, CURLOPT_POST, 1);
curl_setopt($curl_handle, CURLOPT_POSTFIELDS, "status=$message";
curl_setopt($curl_handle, CURLOPT_USERPWD, TWITTER_USER.":"TWITTER_PASS);
$buffer = curl_exec($curl_handle);
curl_close($curl_handle);
return $post_ID;
}
// Añadimos funcionalidad a publish_post
add_action('wp_insert_post', 'update_twitter');
?>
No le hagais mucho caso al código, es ilustrativo y puede producir un funcionamiento erroneo en WordPress
En este código, vemos lo sencillo que es añadir una funcionalidad a nuestro WordPress. En este caso, estamos añadiendo al action wp_insert_post la función update_twitter(). En este caso, una vez hayamos pulsado el botón de publicar en nuestro WordPress, este ejecutará la función update_twitter() y esta enviará a Twitter un aviso de un nuevo artículo.
¿Donde se extienden los actions?
Este ejemplo solo debe servir para hacernos una idea de como añadir funcionalidades a nuestro WordPress, lo interesante es que debemos conocer los actions disponibles para extender nuestro WordPress.
La API nos muestra un listado bastante detallado de los action disponibles. Pero si tenemos alguna duda lo mejor es siempre revisar el código.
En el fichero post.php del directorio wp-includes/ podemos encontrar en la línea 1534 la llamada do_action() que lanzará las acciones asociadas al nombre wp_insert_post.
[...]
wp_transition_post_status($post_status, $previous_status, $post);
if ( $update)
do_action('edit_post', $post_ID, $post);
do_action('save_post', $post_ID, $post);
do_action('wp_insert_post', $post_ID, $post);
return $post_ID;
}
[...]
do_action(), es la función encargada de lanzar el array de acciones asociadas a la key definida por el primer parámetro. En este caso wp_insert_post, lanzará nuestra función que recibirá por parámetro $post_ID que estamos pasando con el do_action(). Suplementaríamente estamos paando un segundo parámetro con $post, que contiene el objeto con los valores que componen el post que acabamos de insertar en la BD.
Revisando el código de WordPress encontraremos una infinidad de do_action() que permiten extender WordPress en casi todos los puntos en los que queramos añadir una nueva funcionalidad.
Mediante filters
Los filters, están mucho más extendidos por el núcleo de WordPress. Como su nombre indica, sirven para filtrar variables que nos podemos encontrar en cualquier funcionalidad de WordPress.
Al igual que los actions, podemos extender la funcionalidad de nuestro WordPress en ellos.
Ejemplo
<?php
function noShowIPs($IP = '') {
// Mostramos solo los primeros 7 carácteres
return substr($IP, 0, 7);
}
// Aplicamos el filtro
add_filter('get_comment_author_IP', 'noShowIPs');
?>
En este pequeño ejemplo, indicamos que no queremos mostrar la IP completa del usuario que comenta en nuestro WordPress cuando se usa la función get_comment_author_IP(). Mediante un substr() devolvemos los 7 primeros dígitos de $IP.
¿Donde se extienden los filters?
Al igual que los actions, los filters están en los ficheros que componen WordPress. En el ejemplo que hemos montado previamente hemos hecho uso de get_comment_author_IP() que se encuentra en el fichero comment-template.php del directorio wp-includes/. Si nos dirigimos a la línea 173 veremos el siguiente código.
[...]
function get_comment_author_IP() {
global $comment;
return apply_filters('get_comment_author_IP', $comment->comment_author_IP);
}
[...]
apply_filters() es el do_action() de los filters, ya que se encarga de recorrer el array de filtros definidos para la key establecida y los va aplicando uno trás otro. En nuestro caso, recibimos la IP del comentarista para posteriormente devolver una IP recortada.
Mediante declaración de funciones
Esta forma, es quizas la más obvia, pero no por ello deja de ser potente.
En muchos casos, usamos plugins por que son más fáciles de instalar, pero bien bien, podrían ser sustituidos por funciones alojadas en ficheros concretos de WordPress. Obtendríamos el mismo resultado.
Ejemplo
<?php
function ult_comments($cuantos = 5) {
global $wpdb;
$comentarios = $wpdb->get_results($wpdb->prepare("
SELECT wc.comment_date, wc.comment_author, wp.post_title, wp.guid, wp.comment_count
FROM ".$wpdb->comments." as wc, ".$wpdb->posts." as wp
WHERE wc.comment_post_ID = wp.ID
AND wc.comment_approved = '1'
AND wc.comment_type = ''
ORDER BY wc.comment_date DESC LIMIT 0,%d;",$cuantos ));
foreach ($comentarios as $comentario) {
echo '<li>
<a href="'.$comentario->guid.'" title="'.$comentario->post_title.'">'.$comentario->post_title.'
<small>'.$comentario->comment_count.'</small>
</a>
<small>Por '.$comentario->comment_author.' hace '.since_date($comentario->comment_date).'</small>
</li>';
}
}
?>
Uno de los puntos recomendados para alojar este tipo de funciones, es el fichero functions.php de nuestro theme. Todas las funciones definidas en él serán visibles desde nuestro themes, plugins, …
En este caso, definimos esta función que nos devolverá los últimos 5 comentarios del blog en el fichero functions.php. Una vez definida, podremos usarla en nuestro theme, donde más rábia nos dé, simplementa llamándola.
<ul>
<?php ult_comments(10); // 10 últimos comentarios ?>
</ul>
¿Que podemos hacer con todo esto?
Pues lo que queramos, podemos hacer que WordPress se transforme a nuestra voluntad. Nos permite desde añadir funcionalidades que nos ayudan en el día a día, hasta cambiar el concepto de blog por el de CMS, Miniblog, …
Edito:
NUNCA SE DEBE TOCAR EL CÓDIGO DE WORDPRESS
Este artículo intenta mostrar las diferentes formas de extender WordPress, sin necesidad de tocar los ficheros que componen el núcleo de WordPress, osea la raíz y wp-includes/ y wp-admin/. Para poder extenderlo puedes hacer uso de los fichero functions.php de tu theme o generar un plugin con dichas funcionalidades dentro.
La limitación, está en nuestra cabeza 😀
