WordPress.org

Idiomas: English – Français – 日本語 (Añade tu idioma)

Desde la versión 2.5 WordPress soporta los llamados Shortcodes. Se han introducido para crear macros que se utilizan en el contenido de un post. Para ver ejemplos de shortcodes y cómo utilizarlos, consulta WordPress.com Shortcodes, aunque algunos shortcodes que aparecen allí son exclusivos de WordPress.com.

Un shortcode trivial para una galería tiene este aspecto:

Los shortcodes también pueden usarse con atributos adicionales, como muestra el siguiente ejemplo:

Ambos ejemplos mostrarán una galería de imágenes, que sería difícil de mantener al escribir el marcado HTML para ella y mantenerlo sincronizado con las imágenes subidas. Utilizando un shortcode, el marcado de la galería se creará de forma dinámica y automática.

Cortocircuitos incorporados y adicionales

WordPress ofrece algunos de los shortcodes por defecto (por ejemplo el de la galería) y los plugins pueden añadir los suyos propios también a través de la API de Shortcode.

Los siguientes shortcodes se incluyen con WordPress:

Escapando Shortcodes

A veces puedes querer utilizar el texto que suele representar un shortcode en tus posts. Para ello, debes escapar el shortcode utilizando dos conjuntos de paréntesis en lugar de uno solo. Así que para mostrar esto en tu post:

Escribirías esto:

]

Para los shortcodes que tienen una etiqueta de inicio y otra de fin, sólo necesitas escapar el primer y último paréntesis:

 ... ]

Tenga en cuenta que sólo los códigos cortos que están actualmente disponibles pueden ser escapados de esta manera. El uso de corchetes dobles alrededor del texto que no está registrado actualmente como un shortcode dará lugar a que se muestren ambos conjuntos de corchetes en su publicación, no sólo uno como cuando se escapan los shortcodes registrados.

Códigos cortos en los widgets

Por defecto, WordPress no admite los shortcodes dentro de los widgets de la barra lateral hasta la versión 4.9. Sólo expande los shortcodes dentro del contenido de un Post, Página o tipo de post personalizado. Para añadir el soporte de shortcodes a los widgets de la barra lateral, puedes instalar un plugin, usar el siguiente código o revisar las Mejoras de los Widgets en 4.9:

add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );

Es importante que estas líneas se añadan en este orden. La primera línea evita que WordPress convierta los saltos de línea en etiquetas de párrafo, ya que esto hace que los shortcodes no funcionen. La segunda línea es la que hace que los shortcodes funcionen.

Cortocircuitos para los plugins que faltan (nombres no registrados)

Aparte de los shortcodes incorporados todos los demás se añaden a través de plugins. Si el plugin que proporciona un determinado shortcode falta o está desactivado WordPress tratará todo el shortcode, sus atributos y el contenido dentro de él como texto plano normal y preservará los caracteres especiales en el HTML de salida.

.

<(^_^)> -- Yay!

<(^_^<) -- <Yay>

Yay!

<(^_^)>

Yay!

<Yay>