En este tutorial vamos a crear un shortcode en WordPress con parámetros. Un shortcode es una manera de llamar a una función para evitar poner código en mitad de nuestra page o de nuestra entrada, va entre corchetes [mifuncion].
Cómo crear un shortcode en WordPress
En primer lugar vamos a crear un shortcode sencillo, simplemente queremos guardar un número de productos totales que hay en la web, así, si está puesto el shortcode en varios sitios, solo tengamos que cambiarlo desde la función creada y no página por página. Para profundizar en los estándares y mejores prácticas, consulta la documentación oficial de shortcodes de WordPress en el sitio de desarrolladores.
Para ello, vamos a nuestro functions.php de nuestro tema y ponemos el siguiente código:
function numero_total(){
return "150";
}
add_shortcode('n_total','numero_total');
¿Fácil verdad? Ahora ya podemos sacar ese dato en nuestros post o páginas utilizando el shortcode con el que lo hemos definido: [n_total]
Bien! Ahora vamos a probar a pasarle parámetros, imagínate que queremos sacar el total de productos, pero queremos que aparezca en un color distinto según donde publiquemos el número total de productos, por ejemplo con distinto color y tamaño.
Crear un shortcode en WordPress con parámetros
La función add_shortcode puede recibir parámetros, lo que vamos a hacer es definir unos parámetros por defecto, que serán color negro y size 16px.
function numero_total($atts){
$atts = shortcode_atts ( array (
'color' => 'black',
'size' => '16px'
), $atts );
$numero = '<span style="color:'.$atts['color'].'; font-size:'.$atts['size'].';">150</span>';
return $numero;
}
add_shortcode('n_total','numero_total');
Ahora si llamamos a la función usando el siguiente shortcode [n_total] nos aparecerá el número total de productos en color negro y tamaño 16px.
Si pasamos parámetros a través del shortcode, usará los que hemos pasado sobre los valores por defecto. Imaginemos que lo queremos en color rojo y tamaño de fuente 25px. Entonces usaremos el siguiente shortcode:
[n_total color=’red’ size=’25px’]
Crear shortcodes en WordPress con parámetros
- Un shortcode es una función llamada entre corchetes que evita insertar código directamente en páginas o entradas
- Los shortcodes se registran en functions.php usando add_shortcode() con el nombre de la función y el identificador del shortcode
- Usa shortcode_atts() para definir parámetros por defecto que se aplican automáticamente si no se especifican otros
- Puedes actualizar el contenido del shortcode desde la función una sola vez en lugar de modificar cada página donde aparezca
