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).
[gallery] (Galerie d’images)
Un shortcode pour afficher plusieurs images dans une mise en page.
- Spécifications : Résout les identifiants de l’attribut
idsen URL d’images réelles et les affiche sous forme de grille en fonction du paramètrecolumns. - Exemple de sortie : Chaque image est enveloppée dans une balise
figure, et l’ensemble est enveloppé dans un conteneurdivavec 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’attributposter(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 plusieurs lecteurs
<audio controls>ou<video controls>à la suite.
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 :
Reconnaissance des balises définies
Les noms des balises définies sont reconnus sans distinction de casse. [gallery] et [GALLERY] sont convertis. Les noms non définis comme [gallery-custom] sont conservés.
É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]: Le shortcode entier, y compris les balises et le contenu, est conservé. - 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.
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.
4. Restauration du contenu des constructeurs de pages
Les balises de structure connues de WPBakery et Divi sont retirées en conservant leur texte. Les balises ci-dessous restaurent les images, galeries, boutons et vidéos à partir de leurs attributs en HTML standard. La mise en page et le CSS d’origine ne sont pas reproduits.
| Type | Balises prises en charge |
|---|---|
| Images | vc_single_image, et_pb_image |
| Galeries | vc_gallery, et_pb_gallery |
| Boutons | vc_btn, vc_button, et_pb_button |
| Vidéos | vc_video, et_pb_video |
Les identifiants d’image nécessitent les URL des pièces jointes du XML ou les médias récupérés par le WP Plugin. Un JSON sans médias ne peut pas résoudre les identifiants seuls. Les composants non pris en charge, images introuvables et attributs invalides conservent leurs shortcodes d’origine. Les articles concernés sont affichés.
5. Formatage automatique des sauts de ligne
Par défaut, les blocs existants sont conservés et le texte hors des blocs reçoit des paragraphes. Le formatage à l’intérieur des blocs est désactivé au départ et nécessite le formatage des paragraphes. Sans frais supplémentaires.
Une fois activé, le texte libre dans les conteneurs comme div reçoit des paragraphes. Les éléments p, li et td conservent leur structure et leurs sauts de ligne textuels deviennent des br. L’indentation composée d’espaces, les balises, attributs, commentaires, code, SVG et MathML sont conservés. Vérifiez l’aperçu.
La détection vérifie tous les contenus et extraits exportés selon les correspondances de champs et la sélection des articles publiés ou brouillons. L’aperçu et le CSV utilisent le même traitement.
Si un média de gallery ou playlist ne peut pas être résolu, le shortcode entier est conservé et l’article concerné est signalé. Les audio et video dont l’URL ne peut pas être convertie de façon sûre sont également conservés. Le contenu des balises englobantes inconnues et les retours à la ligne des attributs restent inchangés. Les retours utilisés pour disposer les images ne reçoivent pas de balise br.