Con la opción de Limpieza de Shortcodes en nuestro servicio de migración, los shortcodes incluidos en las entradas de WordPress se convierten automáticamente en formatos que se muestran correctamente en los temas de Shopify durante el proceso de importación. Esta página explica el comportamiento específico de cada shortcode y las funciones de seguridad implementadas para evitar sobrescrituras no deseadas.

1. Principales shortcodes convertidos automáticamente

Los siguientes shortcodes se reemplazan automáticamente por etiquetas HTML o reproductores incrustados que funcionan dentro del contenido de Shopify (body_html).

Un shortcode para mostrar varias imágenes en un diseño.

  • Especificaciones: Resuelve los IDs en el atributo ids a URLs de imágenes reales y las presenta en un diseño de cuadrícula basado en el ajuste de columns.
  • Ejemplo de salida: Cada imagen se envuelve en una etiqueta figure, y todo el conjunto se envuelve en un contenedor div con una clase para ajustes de estilo.

[caption] (Leyenda de imagen)

Un shortcode para añadir descripciones (leyendas) a las imágenes.

  • Especificaciones: Separa la etiqueta de imagen del texto y los convierte en una estructura semántica <figure> y <figcaption>.

[audio] / [video] (Reproductores de audio y video)

Shortcodes para reproducir archivos de audio o video dentro de un artículo.

  • Especificaciones: Se convierten en etiquetas estándar del navegador <audio controls> o <video controls>. Para los videos, también se conserva el atributo poster (miniatura).

[embed] (Incrustación de contenido externo)

Un shortcode para incrustar sitios externos como YouTube o Vimeo.

  • Especificaciones: Identifica automáticamente las URLs de YouTube o Vimeo y las convierte en reproductores <iframe> incrustados. Otras URLs se muestran como enlaces externos por seguridad.

[playlist] (Lista de reproducción)

Un shortcode para mostrar una lista de múltiples archivos de audio o video.

  • Especificaciones: Muestra los elementos como una lista con viñetas que incluye imágenes o nombres de archivo para evitar enlaces rotos.

2. Funciones de seguridad para evitar conversiones no deseadas

Para asegurar que los corchetes [...] que aparecen en el texto normal no se eliminen o conviertan accidentalmente, empleamos las siguientes especificaciones de seguridad:

Solo minúsculas (sensible a mayúsculas y minúsculas)

Solo las etiquetas escritas totalmente en minúsculas se reconocen como shortcodes.

  • Objetivo de conversión: [gallery], [audio], etc.
  • Protegido: Las anotaciones que contienen letras mayúsculas o números como [Any], [This] o [123] se mantienen exactamente como están, como texto.

Escape con corchetes dobles

Al igual que en las especificaciones estándar de WordPress, puede evitar la conversión utilizando corchetes dobles.

  • Entrada: [[gallery]]
  • Salida: [gallery] (Se muestra como texto en lugar de ejecutarse como un shortcode)

Protección de etiquetas no definidas

Las etiquetas desconocidas no definidas en el sistema se manejan de la siguiente manera:

  • Tipo envolvente [tag]Contenido[/tag]: Solo se eliminan las partes de la etiqueta; el “Contenido” siempre se conserva.
  • Tipo independiente [tag]: A menos que se incluya en la lista negra mencionada a continuación, se trata como texto y se mantiene tal cual.

3. Eliminación automática de código innecesario (Lista negra)

El código conocido de plugins que resulta innecesario durante la migración a Shopify se elimina automáticamente.

  • Palabras clave objetivo: contact-form-7, mwform_formkey, gravityform, contact-form, rev_slider, layerslider, sitemap, addtoany, yoast_breadcrumb, etc.
  • Prefijos objetivo: Todas las etiquetas que comienzan con vc_ (de WPBakery) o et_pb_ (de Divi).

Estos ajustes se gestionan en un archivo de configuración para desarrolladores (shortcode-config.ts), y se pueden añadir etiquetas específicas a la lista de eliminación según sea necesario.