Manual ShortCodes en WordPress (completísimo) I

Los shortcodes se introdujeron a partir de la versión 2.5 de WP. Facilitan la repetición de pequeñas tareas repetitivas en las plantillas (como publicar en Twitter, embeber videos, poner publicidad, un mapa de google, una enmaquetación específica, etc.).

Funciona poniendo un código corto entre corchetes [código-corto] (como próximamente veremos) que luego es sustituido (automáticamente por WO) por esos pequeños fragmentos de código o hooks.

El código siguiente se puede poner en en archivo functions.php pero yo prefiero añadir sólo esta línea a ese archivo:

include(TEMPLATEPATH . '/includes/shortcodes.php');

y poner en shortcodes.php el código, para que de esa manera sea luego un poco más cómodo exportalos a otras plantillas o salvarlos de alguna actualización.

Se crea en pocos y sencillos pasos para un caso 'base',

• Se crea la función (callback) llamada. En este ejemplo nos devuelve una cadena con el enlace y el nombre del último post introducido.

function recent_posts_function() {
   query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => 1));
   if (have_posts()) :
      while (have_posts()) : the_post();
         $return_string = '<a href="'.get_permalink().'">'.get_the_title().'</a>';
      endwhile;
   endif;
   wp_reset_query();
   return $return_string;
}

• Se "registra" el atajo o shortcode 

function register_shortcodes(){
   add_shortcode('recent-posts', 'recent_posts_function');
} 

•  Se añade el gancho 'hook'

add_action( 'init', 'register_shortcodes'); 

Hasta aquí la manera de crear un shortcode sencillo para mostrar el último post de nuestro blog en una entrada.
En el siguiente veremos cómo pasarle parámetros (para mostrar 5 por ejemplo) y ponerle contenido entre las etiquetas [atajo] Lorem ipsum... [/atajo]