Cómo crear sus propios códigos cortos de WordPress
En la versión 2.5, WordPress introdujo códigos breves, y todos nosotros probablemente los hayamos usado en un momento u otro. Por lo general, vienen con plugins, o incluso temas, y lo que hacen es observar cuando insertas algo entre corchetes y luego lo reemplazas con otro contenido; podría ser una oración simple o podría ser una función masiva de PHP, todo depende de lo que instruyó a WordPress a hacer.
Los códigos cortos incluidos son geniales y aceleran las cosas considerablemente, pero ¿no sería genial saber cómo crear sus propios códigos cortos?
En este artículo, lo guiaremos en la creación de algunos códigos breves simples de WordPress para ayudarlo a crear cualquier funcionalidad que desee.
Un shortcode simple
La API de código abreviado funciona de manera muy simple: primero necesita crear una función de devolución de llamada que se ejecutará cada vez que se use el código abreviado; entonces necesitas atar esa función a un shortcode específico que lo prepara para el uso. El código se coloca con frecuencia en el archivo functions.php, pero si planea tener muchos shortcodes, tiene sentido crear un archivo separado e incluir ese archivo en su archivo functions.php.
En nuestro primer ejemplo, queremos crear un shortcode que creará algo de lorem ipsum cada vez que tecleemos [lorem] en el editor. Primero necesitamos crear la función de devolución de llamada que devolverá el lorem ipsum (en los códigos abreviados no hacemos eco de nada, todo se devuelve):
function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}A continuación tenemos que agregar este shortcode a WordPress usando la función add_shortcode en nuestro archivo functions.php o en un archivo que se está incluyendo en él, esta función agrega el shortcode y también lo vincula a la función que acabamos de crear. add_shortcode solo toma dos argumentos, el primero es el nombre que queremos que tenga este shortcode (lo que escribiremos entre corchetes) y el segundo es la función que queremos adjuntar a ese shortcode:
add_shortcode('lorem', 'lorem_function');Eso es todo lo que se necesita para crear un código abreviado simple en WordPress.
Agregar parámetros
Continuando con esta idea de contenido falso, a menudo necesitamos imágenes en nuestro contenido cuando preparamos nuestras maquetas y estas imágenes deben ser de diferentes tamaños, por lo que ahora crearemos un código corto para insertar una imagen como esta:
[picture width="500" height="500"]Cuando WordPress encuentra esto, queremos una función que inserte una imagen. Necesita leer los atributos de ancho y alto, pero solo en caso de que también proporcionemos los valores predeterminados para que puedan usarse sin los atributos. Como es posible que no tengamos una imagen disponible, vamos a usar la lorempixel.com servicio para proporcionarnos una imagen aleatoria.
Primero necesitamos crear la función:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Llamamos a esta función random_picture y como este shortcode puede tomar argumentos, le dimos el parámetro $ atts . Para usar los atributos, necesitamos dos funciones: shortcode_atts, que es una función de WordPress que combina nuestros atributos con los atributos conocidos y rellena los valores predeterminados cuando es necesario; y la función extraer PHP que, como su nombre indica, extrae los atributos que establecemos para nuestro código abreviado. Finalmente, la función devuelve el valor que queremos, en este caso el código HTML para nuestra imagen combinado con las variables de ancho y alto.
Lo único que queda por hacer es registrar este shortcode:
add_shortcode('picture', 'random_picture');Nuestro shortcode está completo, cuando tecleemos [imagen] nos dará una imagen aleatoria de 400 por 200, y si usamos los atributos podemos crear una imagen de cualquier tamaño que queramos.
Conclusión
Crear pequeños códigos breves para cosas que usamos con frecuencia definitivamente nos ayuda a escribir publicaciones de blog porque puedes hacer lo que quieras con códigos cortos, puede ser tan simple como devolver una oración, o tan complejo como agregar un formulario o las últimas publicaciones ordenadas por mes.
¿Has creado shortcodes útiles para WordPress? ¿Qué códigos cortos deseas que existan? Háganos saber en los comentarios.
Imagen / miniatura destacada, imagen de código a través de Marjan Krebelj.