Met de Shortcode Opschoonoptie in onze migratieservice worden shortcodes in WordPress-berichten tijdens het importproces automatisch geconverteerd naar formaten die correct worden weergegeven in Shopify-thema’s. Deze pagina legt het specifieke gedrag van elke shortcode uit en de beveiligingsfuncties die zijn ingesteld om onbedoelde overschrijvingen te voorkomen.

1. Belangrijkste shortcodes die automatisch worden geconverteerd

De volgende shortcodes worden automatisch vervangen door HTML-tags of ingebedde spelers die werken binnen de Shopify-body (body_html).

Een shortcode voor het weergeven van meerdere afbeeldingen in een lay-out.

  • Specificaties: Vertaalt ID’s in het ids-attribuut naar werkelijke afbeeldings-URL’s en geeft deze weer als een rasterlay-out op basis van de columns-instelling.
  • Voorbeeld van uitvoer: Elke afbeelding wordt omringd door een figure-tag, en de hele set wordt verpakt in een div-container met een klasse voor stijlaanpassingen.

[caption] (Afschrift van afbeelding)

Een shortcode voor het toevoegen van beschrijvingen (bijschriften) aan afbeeldingen.

  • Specificaties: Scheidt de afbeeldingstag van de tekst en converteert deze naar een semantische <figure>- en <figcaption>-structuur.

[audio] / [video] (Audio- en videospelers)

Shortcodes voor het afspelen van audio- of videobestanden binnen een artikel.

  • Specificaties: Geconverteerd naar standaard browser <audio controls> of <video controls> tags. Voor video’s blijft ook het poster-attribuut (thumbnail) behouden.

[embed] (Externe inhoud insluiten)

Een shortcode voor het insluiten van externe sites zoals YouTube of Vimeo.

  • Specificaties: Identificeert automatisch YouTube- of Vimeo-URL’s en converteert deze naar ingebedde <iframe>-spelers. Andere URL’s worden voor de veiligheid als externe links weergegeven.

[playlist] (Afspeellijst)

Een shortcode voor het weergeven van een lijst met meerdere audio- of videobestanden.

  • Specificaties: Geeft de items weer als een lijst met opsommingstekens, inclusief afbeeldingen of bestandsnamen, om verbroken links te voorkomen.

2. Beveiligingsfuncties om onbedoelde conversie te voorkomen

Om ervoor te zorgen dat haakjes [...] in normale tekst niet per ongeluk worden verwijderd of geconverteerd, gebruiken we de volgende beveiligingsspecificaties:

Alleen kleine letters (hoofdlettergevoelig)

Alleen tags die volledig in kleine letters zijn geschreven, worden als shortcodes herkend.

  • Doel voor conversie: [gallery], [audio], enz.
  • Beschermd: Notaties met hoofdletters of cijfers zoals [Any], [This] of [123] worden exact zo gelaten als tekst.

Escapen met dubbele haakjes

Net als bij de standaard WordPress-specificaties, kun je conversie voorkomen door dubbele haakjes te gebruiken.

  • Invoer: [[gallery]]
  • Uitvoer: [gallery] (Wordt weergegeven als tekst in plaats van te worden uitgevoerd als shortcode)

Bescherming van ongedefinieerde tags

Onbekende tags die niet in het systeem zijn gedefinieerd, worden als volgt afgehandeld:

  • Insluitend type [tag]Inhoud[/tag]: Alleen de tag-delen worden verwijderd; de “Inhoud” blijft altijd behouden.
  • Zelfstandig type [tag]: Tenzij opgenomen in de hieronder genoemde zwarte lijst, wordt het behandeld als tekst en als zodanig bewaard.

3. Automatische verwijdering van onnodige code (Zwarte lijst)

Bekende code van plug-ins die onnodig wordt tijdens Shopify-migratie, wordt automatisch verwijderd.

  • Doelzoekwoorden: contact-form-7, mwform_formkey, gravityform, contact-form, rev_slider, layerslider, sitemap, addtoany, yoast_breadcrumb, enz.
  • Doelvoorvoegsels: Alle tags die beginnen met vc_ (van WPBakery) of et_pb_ (van Divi).

Deze instellingen worden beheerd in een configuratiebestand voor ontwikkelaars (shortcode-config.ts), en specifieke tags kunnen indien nodig aan de verwijderingslijst worden toegevoegd.