Avec l’option de nettoyage des shortcodes de notre service de migration, les shortcodes inclus dans les articles WordPress sont automatiquement convertis dans des formats qui s’affichent correctement dans les thèmes Shopify pendant le processus d’importation. Cette page explique le comportement spécifique de chaque shortcode et les fonctions de sécurité mises en place pour éviter les écrasements involontaires.

1. Principaux shortcodes convertis automatiquement

Les shortcodes suivants sont automatiquement remplacés par des balises HTML ou des lecteurs intégrés qui fonctionnent dans le corps de Shopify (body_html).

Un shortcode pour afficher plusieurs images dans une mise en page.

  • Spécifications : Résout les identifiants de l’attribut ids en URL d’images réelles et les affiche sous forme de grille en fonction du paramètre columns.
  • Exemple de sortie : Chaque image est enveloppée dans une balise figure, et l’ensemble est enveloppé dans un conteneur div avec une classe pour les ajustements de style.

[caption] (Légende d’image)

Un shortcode pour ajouter des descriptions (légendes) aux images.

  • Spécifications : Sépare la balise image du texte et les convertit en une structure sémantique <figure> et <figcaption>.

[audio] / [video] (Lecteurs audio et vidéo)

Shortcodes pour lire des fichiers audio ou vidéo dans un article.

  • Spécifications : Convertis en balises standard du navigateur <audio controls> ou <video controls>. Pour les vidéos, l’attribut poster (vignette) est également préservé.

[embed] (Intégration de contenu externe)

Un shortcode pour intégrer des sites externes tels que YouTube ou Vimeo.

  • Spécifications : Identifie automatiquement les URL YouTube ou Vimeo et les convertit en lecteurs <iframe> intégrés. Les autres URL sont affichées sous forme de liens externes par sécurité.

[playlist] (Liste de lecture)

Un shortcode pour afficher une liste de plusieurs fichiers audio ou vidéo.

  • Spécifications : Affiche les éléments sous forme de liste à puces comprenant des images ou des noms de fichiers pour éviter les liens brisés.

2. Fonctions de sécurité pour éviter les conversions involontaires

Pour garantir que les crochets [...] apparaissant dans le texte normal ne soient pas accidentellement supprimés ou convertis, nous utilisons les spécifications de sécurité suivantes :

Minuscules uniquement (sensible à la casse)

Seules les balises écrites entièrement en minuscules sont reconnues comme des shortcodes.

  • Cible de la conversion : [gallery], [audio], etc.
  • Protégé : Les notations contenant des majuscules ou des chiffres comme [Any], [This] ou [123] sont conservées exactement telles quelles en tant que texte.

Échappement avec doubles crochets

Similairement aux spécifications standard de WordPress, vous pouvez éviter la conversion en utilisant des doubles crochets.

  • Entrée : [[gallery]]
  • Sortie : [gallery] (S’affiche sous forme de texte au lieu d’être exécuté comme un shortcode)

Protection des balises non définies

Les balises inconnues non définies dans le système sont traitées comme suit :

  • Type fermant [tag]Contenu[/tag] : Seules les parties de la balise sont supprimées ; le « Contenu » est toujours préservé.
  • Type autonome [tag] : À moins qu’il ne figure dans la liste noire mentionnée ci-dessous, il est traité comme du texte et conservé tel quel.

3. Suppression automatique du code inutile (Liste noire)

Le code connu provenant d’extensions qui devient inutile lors de la migration vers Shopify est automatiquement supprimé.

  • Mots-clés cibles : contact-form-7, mwform_formkey, gravityform, contact-form, rev_slider, layerslider, sitemap, addtoany, yoast_breadcrumb, etc.
  • Préfixes cibles : Toutes les balises commençant par vc_ (de WPBakery) ou et_pb_ (de Divi).

Ces paramètres sont gérés dans un fichier de configuration pour les développeurs (shortcode-config.ts), et des balises spécifiques peuvent être ajoutées à la liste de suppression si nécessaire.