Como crear y usar shortcodes en las publicaciones de WordPress

Los shortcodes son una de las funciones más útiles que incluye WordPress, aunque son poco conocidos y empleados por la gran mayoría.
En este articulo explico con ejemplos como usar en la práctica los que incluye WordPress y como crear los propios nuestros, para agregar contenido y personalizar las publicaciones.

¿Qué son y cómo funcionan los shortcodes de WordPress?

Un shortcode es una etiqueta que se puede insertar dentro del texto en cualquier entrada o página, usando el editor del panel de administración, de la siguiente forma:
[NombreDelShortcode]
En ese lugar exactamente, se inserta el contenido que refiere.
Podemos usar los que incluye WordPress o crear los nuestros, agregando previamente las funciones necesarias, en el archivo “functions.php” o en un plugin como explico más abajo.

Shortcodes que incluye WordPress

WordPress incluye los siguientes shortcodes:

Crear shortcodes personalizados en WordPress

Para crear shortcodes propios que nos permitan insertar contenido en las publicaciones, necesitamos agregar la función necesaria en el archivo “functions.php” del Tema Child.
Si son varios estos shortcodes, se recomienda crear un plugin personal solo para esta tarea.
En ambos casos la función tiene el siguiente formato:

// Crear shortcode
function nombre_funcion() {
return 'TEXTO o HTML';
}
add_shortcode( 'nombre_shortcode', 'nombre_funcion' );

Ejemplos de shortcodes

En los siguientes ejemplos uso funciones comentadas en un artículo anterior, que nos permiten agregar contenido en las páginas.
1- Shortcode para mostrar un mensaje de texto en un contenedor.

// Insertar mensaje
function mensaje_texto( $atts ){
	return '<div style="background-color:#d4eefd;padding:12px;margin:-12px 0 12px 0;">Texto del mensaje a mostrar donde se inserte el shortcode</div>';}
add_shortcode( 'mensaje', 'mensaje_texto' );

Nombre del shortcode: [mensaje]

2- Shortcode para insertar un calendario del mes actual, con enlaces a las publicaciones creadas en nuestro blog en cada fecha.

// Insertar calendario
function npc__calendario() {
       ob_start();
get_calendar();
return ob_get_clean();}
add_shortcode('calendario', 'npc__calendario');

Nombre del shortcode: [calendario]

3- Shortcode para mostrar la fecha y hora actual.

// Insertar fecha y hora local
function npc__act() {
  ob_start(); 
echo '<p>'.date_i18n('F jS, Y, H:i').'</p>'; 
return ob_get_clean();}
add_shortcode( 'fechahora', 'npc__act' );

Nombre del shortcode: [fechahora]

4- Shortcode para mostrar un enlace a las redes sociales, en este caso Twitter.

// Enlace de seguir en Twitter
function seguir_twitter() {
    return '<p><a style="color: #55acee;font-size: 1.2em;" href="https://twitter.com/NorfiPC"><b>¡Sígueme en Twitter!</b></a></p>';}
add_shortcode('seguirtwitter', 'seguir_twitter');

Nombre del shortcode: [seguirtwitter]

5- Shortcode para compartir la página donde se inserte en Facebook.

//Compartir pagina en Facebook
function share_fb(){
$url = get_permalink();
return '<p><a style="color: #3b5998;font-size: 1.2em;" href="https://www.facebook.com/sharer/sharer.php?u='.$url.'" target="_blank"><b>Compartir en Facebook</b></a></p>';}
add_shortcode('compfb', 'share_fb');

Nombre del shortcode: [compfb]

¿Cómo insertar shortcodes en widgets?

En WordPress no podemos agregar contenido en la barra latera, a no ser que usemos los widgets.
Para poder habilitar el uso de shortcodes en el Widget de texto, necesitamos agregar la siguiente instrucción al archivo functions.php.

// Habilitar Shortcodes en Widget de texto
add_filter('widget_text', 'do_shortcode');

Reglas para evitar errores al crear shortcodes

Otras páginas relacionadas

✓ Como modificar y personalizar mi tema de WordPress
✓ Como usar y configurar WordPress sin plugins
✓ Convertir los enlaces externos en NoFollow en WordPress


Comparte

Sígueme en las redes sociales