¿Qué es un shortcode en WordPress?
Un shortcode es una etiqueta corta entre corchetes, como , que WordPress reemplaza con contenido dinámico al cargar la página. Como WordPress no ejecuta PHP dentro del contenido de las entradas de forma predeterminada, los shortcodes, introducidos en WordPress 2.5, te permiten agregar galerías, audio, video y funciones de plugins al invocar código que un desarrollador ya registró.
Más sobre los shortcodes
WordPress incluye seis shortcodes integrados:
- `[audio]` inserta y reproduce archivos de audio
- `[caption]` agrega leyendas al contenido, normalmente imágenes
- `[embed]` encierra contenido incrustado
- `[gallery]` muestra galerías de imágenes
- `[playlist]` presenta una colección de archivos de audio o video
- `[video]` inserta y reproduce archivos de video
Todo lo demás, como un formulario de contacto o una presentación de diapositivas, viene de los plugins. Muchos plugins registran sus propios shortcodes como la forma de colocar su contenido: pones la etiqueta donde quieres que aparezca el resultado y el plugin se encarga de llenarla.
Cómo funcionan los shortcodes
Cuando WordPress procesa una entrada, revisa el contenido en busca de etiquetas entre corchetes registradas y reemplaza cada una con el resultado de la función PHP asociada a esa etiqueta. Tus visitantes ven la galería o el reproductor; la etiqueta nunca aparece en la página publicada.
Esta función existe porque WordPress no ejecuta PHP dentro del contenido de las entradas de forma predeterminada. El manual de plugins de WordPress (en inglés) describe esa restricción como una precaución de seguridad. Los shortcodes, que llegaron con WordPress 2.5, permiten que quien escribe contenido ejecute código registrado sin escribir PHP. Eso sí: el código detrás de un shortcode sigue siendo PHP, así que es tan seguro como lo haya hecho su desarrollador; las buenas prácticas del manual piden sanitizar los datos de entrada y escapar los de salida.
Cómo agregar un shortcode a una entrada o página
Para agregar un shortcode a una entrada o a una página, ábrela en el editor de bloques, haz clic en el botón para añadir un bloque e inserta el bloque Shortcode; lo encuentras en la sección Widgets del insertador de bloques. También puedes escribir /shortcode y presionar Enter. Después escribe la etiqueta dentro del bloque.
Los shortcodes se escriben entre corchetes. Por ejemplo, para agregar una galería, escribe:
`[gallery ids="1,2,3,4,5,6" columns="3" size="large"]`
Esto muestra las imágenes cuyos ID de adjunto son del 1 al 6, en 3 columnas y en el tamaño registrado "large" (el predeterminado es "thumbnail"). Los ID de adjunto se comparten con las entradas y páginas, así que tus imágenes casi nunca tendrán los ID del 1 al 6. Para encontrar el ID real de una imagen, ábrela en la biblioteca de medios.
¿Shortcodes o bloques?
Hoy casi nunca escribirás los shortcodes integrados a mano. Desde que el editor de bloques se volvió el predeterminado de WordPress, las galerías, el audio, el video y el contenido incrustado tienen sus propios bloques. Aun así, los shortcodes siguen siendo la forma estándar en que muchos plugins colocan su contenido.
- Usa un bloque cuando exista uno para la tarea. Los bloques Galería, Audio, Video e Incrustar cubren lo mismo que los shortcodes equivalentes y te muestran el resultado mientras editas.
- Usa un shortcode cuando un plugin lo ofrezca, o cuando necesites repetir el mismo contenido dinámico en muchas páginas.
Cómo crear shortcodes personalizados
Los desarrolladores registran un shortcode con la función add_shortcode(), que asocia una etiqueta entre corchetes con una función PHP (callback) en un plugin o en el archivo functions.php de un tema. Lo que esa función devuelve reemplaza a la etiqueta en la página.
Para ver más ejemplos, incluido un tutorial para crear el tuyo, consulta nuestra guía Introducción a los shortcodes de WordPress (con ejemplos).
Preguntas frecuentes
- WordPress solo reemplaza las etiquetas registradas. Si el plugin o el tema que registró un shortcode está desactivado o eliminado, el texto entre corchetes se muestra tal cual a tus visitantes; una etiqueta mal escrita falla de la misma forma. Reactiva o reemplaza el plugin, o borra las etiquetas que quedaron.
- Sí, en entradas, páginas y el widget de Texto, que procesa shortcodes automáticamente. Las plantillas del tema no: ahí un shortcode solo se ejecuta si lo pasas por la función do_shortcode(), por ejemplo echo do_shortcode('[gallery]').
- El que se carga al final tiene prioridad. WordPress guarda una sola función (callback) por etiqueta de shortcode, así que cuando dos plugins registran el mismo nombre, uno sobrescribe al otro. Por eso WordPress recomienda a los desarrolladores usar un prefijo en los nombres de sus shortcodes. Si el resultado de un shortcode cambia de repente, revisa si hay una colisión de nombres.
Hosting potente para WordPress
Disfruta de un hosting confiable y ultrarrápido, optimizado especialmente para WordPress. Haz clic para encontrar el plan perfecto para ti.
Planes de WordPress Hosting