Qué es un shortcode y cómo usarlo

Un shortcode es una etiqueta breve de WordPress, escrita entre corchetes (por ejemplo [galeria]), que ejecuta una función o inserta contenido dinámico sin tener que escribir código. Basta con colocarlo en una entrada, página o widget para mostrar galerías, formularios, botones u otros elementos complejos de forma rápida.

Qué es un shortcode y cómo funcionan

Un shortcode (literalmente, código corto) es una pequeña etiqueta encerrada entre corchetes que WordPress reconoce y sustituye por un contenido o una funcionalidad concreta. Se introdujeron en WordPress 2.5 mediante la llamada API de Shortcodes y, desde entonces, se han convertido en una de las formas más cómodas de añadir elementos avanzados a una web sin tocar el código fuente. Cuando el sistema procesa el contenido de una página, detecta la etiqueta, busca la función asociada y muestra en su lugar el resultado que esa función genera.

WordPress incluye varios shortcodes nativos que quizá ya hayas utilizado sin darte cuenta, como

para crear galerías de imágenes, para añadir pies de foto, y para incrustar archivos multimedia o para insertar contenidos externos. Además, la mayoría de los shortcodes admiten atributos que modifican su comportamiento. Por ejemplo, mostraría una galería con esas imágenes concretas organizadas en tres columnas. Esa capacidad de recibir parámetros es lo que los hace tan flexibles y potentes.

Cómo se crean

Crear un shortcode propio es relativamente sencillo si tienes nociones básicas de PHP. El procedimiento consiste en registrar una función mediante add_shortcode(), indicando el nombre de la etiqueta y la función que debe ejecutarse cuando aparezca. Un detalle importante es que esa función debe devolver el contenido con return y no imprimirlo directamente con echo, ya que WordPress se encarga de colocar el resultado en el lugar adecuado. Si quieres que el shortcode acepte atributos, se utiliza shortcode_atts() para definir valores por defecto y combinarlos con los que indique el usuario.

Lo más recomendable es añadir este código en un plugin propio o en el archivo functions.php de un tema hijo, de modo que no se pierda al actualizar el tema. En la práctica, sin embargo, la mayoría de los usuarios no necesita programar nada: una enorme cantidad de plugins generan sus propios shortcodes. Los constructores visuales como Elementor o WPBakery, los formularios de Contact Form 7 o las galerías avanzadas añaden etiquetas listas para copiar y pegar. Todo ello funciona sobre cualquier instalación de WordPress alojada en un hosting compatible con WordPress, que es donde se ejecuta el PHP que da vida a estas funciones.

Ventajas y desventajas de usar shortcodes

Facilitan y agilizan tareas

La gran ventaja de los shortcodes es que permiten reutilizar funcionalidades complejas escribiendo apenas unas pocas letras. En lugar de repetir un bloque de código en cada página, insertas la etiqueta y listo. Si necesitas cambiar el comportamiento, modificas una sola vez la función y el cambio se refleja en todos los lugares donde hayas usado el shortcode, lo que ahorra tiempo y reduce errores.

Múltiples posibilidades para el diseño y la maquetación

Los shortcodes abren un abanico enorme de opciones de diseño: columnas, pestañas, acordeones, botones, carruseles, tablas de precios o llamadas a la acción. Gracias a ellos puedes maquetar páginas ricas y dinámicas sin saber programar, simplemente combinando las etiquetas que ofrecen tu tema y tus plugins.

Facilidad de creación

Para un desarrollador, crear un shortcode a medida es una tarea rápida que aporta mucho valor. Con pocas líneas de código se encapsula una funcionalidad que después cualquier persona del equipo, sin conocimientos técnicos, podrá insertar en el contenido. Es una forma estupenda de estandarizar elementos repetitivos dentro de un proyecto.

Generan dependencia

La principal desventaja es la dependencia. Si el shortcode procede de un plugin o de un tema y lo desactivas o lo cambias, las etiquetas dejan de interpretarse y aparecen en el contenido como texto plano, del tipo [mi_shortcode], a la vista de los visitantes. Por eso conviene usar shortcodes de fuentes fiables, documentar cuáles empleas y tener cuidado al migrar o rehacer una web para no romper las páginas existentes.

Shortcodes y el editor de bloques de WordPress

Con la llegada del editor de bloques (Gutenberg), muchas funciones que antes dependían de shortcodes se ofrecen ahora como bloques visuales que se insertan arrastrando y configurando opciones en un panel lateral. Aun así, los shortcodes siguen plenamente vigentes: el propio editor incluye un bloque llamado Shortcode que permite pegar cualquier etiqueta clásica, y miles de plugins continúan distribuyendo sus funciones de esta manera por compatibilidad. En la práctica conviven los dos sistemas. Si partes de una web antigua basada en shortcodes, no necesitas reescribir todo de golpe; puedes mantener las etiquetas existentes mientras incorporas bloques en el contenido nuevo. Lo importante es ser coherente, evitar duplicar la misma función con dos métodos distintos y comprobar siempre, tras cualquier cambio de tema o plugin, que las etiquetas se siguen interpretando correctamente y no quedan visibles como texto en mitad de tus páginas.

Un consejo práctico para trabajar con shortcodes de forma ordenada es llevar un pequeño registro de los que utilizas en cada proyecto: de qué plugin proceden, qué atributos aceptan y en qué páginas aparecen. Así ahorras tiempo cuando tengas que actualizar el sitio, cambiar de plantilla o trasladar la web a otro servidor, y reduces el riesgo de que una etiqueta deje de funcionar sin que te des cuenta.

Preguntas frecuentes

¿Dónde puedo insertar un shortcode en WordPress?

Puedes colocarlo en el contenido de entradas y páginas, en widgets y, con el editor de bloques, mediante el bloque específico llamado Shortcode. También es posible ejecutarlo dentro de un archivo de plantilla del tema usando la función do_shortcode(), lo que resulta útil para mostrarlo en zonas fijas como cabeceras o pies de página.

¿Por qué veo el shortcode como texto en lugar de su contenido?

Suele ocurrir cuando el plugin o el tema que definía esa etiqueta está desactivado, se ha eliminado o se ha escrito mal el nombre. WordPress no encuentra la función asociada y, por tanto, muestra la etiqueta tal cual. Revisa que el plugin esté activo y que el shortcode esté bien escrito.

¿Los shortcodes afectan al rendimiento de la web?

Un shortcode bien programado apenas afecta al rendimiento, pero abusar de plugins que cargan muchos recursos sí puede ralentizar la web. Para mantener una buena velocidad conviene usar solo los necesarios y alojar el sitio en un servidor rápido, con discos NVMe y tecnología como LiteSpeed, que ayuda a servir las páginas con mayor agilidad.