¿Cómo agregar un shortcode en WordPress?

¿Alguna vez has tenido un momento en el que quisiste agregar contenido especializado a tu publicación o página de WordPress, pero no estabas seguro de cómo? Tal vez deseaba insertar un widget de Twitter o algún contenido devuelto desde algún sitio web o API. ¿Cómo puedes agregar fácilmente este tipo de contenido a tu publicación de WordPress? Afortunadamente, WordPress proporciona algo llamado código abreviado para que este tipo de tarea sea extremadamente fácil. Este tutorial lo guiará a través del proceso de creación, instalación y uso de un shortcode en su instalación de WordPress. Empecemos por ver qué es un shortcode..

¿Qué es un código corto de WordPress??

En resumen, un shortcode es una etiqueta especial que puede ingresar en una publicación que se reemplaza con un contenido diferente al ver la publicación en el sitio web. Si alguna vez ha incorporado una galería de WordPress en su blog, entonces ya ha visto el código corto incorporado .

Cuando carga una página de blog con el shortcode [galería], WordPress reemplaza el shortcode [galería] con todo el código que realmente muestra una galería de sus imágenes.

Como puede ver en el ejemplo anterior, un código abreviado es similar a una etiqueta HTML, pero está encerrado entre corchetes en lugar de corchetes angulares. Este código se reemplaza con otro código cuando la página se carga en un navegador web. Lo realmente genial es que WordPress te permite crear tus propios códigos cortos personalizados para mostrar casi cualquier cosa. Puede usarlo para mostrar un video de Youtube, mostrar sus últimos tweets o incluso personalizarlo como desee..

En caso de que eso no tenga sentido, veamos un ejemplo. Digamos que quiero publicar un anuncio de AdSense dentro de mi publicación. Podría entrar en el modo HTML del editor de contenido de WordPress y copiar y pegar el bloque de código de Adsense en él, pero esto sería tedioso y potencialmente distraería con todo el margen de beneficio adicional en mi publicación. Además, si quisiera cambiar el bloque de anuncios, tendría que volver a cada una de las publicaciones para cambiarlo por el nuevo. Una forma más fácil y más confiable de agregar el bloque de Adsense donde yo quisiera sería usar un código corto de AdSense. El shortcode podría verse así:

[adsense] 

Al mirar la publicación en su sitio web, el código abreviado se reemplazaría con el bloque de anuncios de Adsense. Entonces, ¿cómo crear este shortcode? Obviamente, necesitas decirle a WordPress que debe reemplazar el shortcode de alguna manera. Echemos un vistazo a eso siguiente.

¿Cómo puedo crear un código corto?

Afortunadamente, WordPress hace que sea bastante simple hacer tus propios códigos cortos, así que en realidad vamos a implementar el código corto [adsense]. Lo primero que debemos hacer es definir una función que genere el código de Adsense real. Todo el siguiente código irá en functions.php en su tema (también podría ir en un archivo de complemento independiente). ¿Lo tengo? Ok, entonces veamos esa función.

 función get_adsense ($ atts) return '';  

Esta función es bastante sencilla: solo devuelve mi código de Google Adsense como una cadena. Lo que devuelva esta función es con lo que se reemplazará mi código abreviado, por lo que potencialmente podría haber devuelto el html para un widget de Twitter, o una lista de las publicaciones secundarias de este, o cualquier otra cosa.

Ahora que tenemos una función que devuelve lo que queremos, ¿cómo lo conectamos a un shortcode? Ahora aquí es donde entra en juego la API de WordPress. De nuevo, veamos cómo lo hacemos y luego explicamos lo que está pasando. Aquí está la llamada para configurar el código corto de AdSense.

 add_shortcode ('adsense', 'get_adsense'); 

¡Eso es! El primer parámetro pasado es el nombre del shortcode, por lo que en nuestro caso, 'adsense' le dice a WordPress que cree el shortcode [adsense]. El segundo parámetro designa la función que se llamará cuando se encuentre el nuevo shortcode. Nuevamente, en nuestro caso, 'get_adsense' le dice a WordPress que reemplace [adsense] con los resultados de nuestro método get_adsense.

No está tan mal, ¿verdad? Ahora que este es un código corto muy simple, WordPress le permite hacer mucho más con sus códigos cortos, incluyendo la adición de parámetros (¿quizás desee elegir entre bloques de AdSense?). La API completa se puede ver en el Códice de WordPress.

¿Cómo uso mi código corto?

Esta última parte es simple, solo agregue el shortcode [adsense] en las vistas HTML o Visual del editor de contenido de Publicaciones o Páginas. ¡Eso es! Has creado tu primer shortcode.

John Gadbois es el copropietario y líder técnico de Domain Superstar, un sitio de herramientas de nombres de dominio. También ejecuta CalculatorPro, un sitio de calculadoras genial con todo tipo de calculadoras financieras. Le gusta aprender y programar con Ruby on Rails, jQuery, WordPress y PHP.