Mit der Option zur Bereinigung von Shortcodes in unserem Migrationsservice werden in WordPress-Beiträgen enthaltene Shortcodes während des Importvorgangs automatisch in Formate umgewandelt, die in Shopify-Themes korrekt angezeigt werden. Diese Seite erklärt das spezifische Verhalten jedes Shortcodes und die Sicherheitsfunktionen, die implementiert wurden, um unbeabsichtigte Überschreibungen zu verhindern.

1. Wichtige Shortcodes, die automatisch konvertiert werden

Die folgenden Shortcodes werden automatisch durch HTML-Tags oder eingebettete Player ersetzt, die im Shopify-Inhalt (body_html) funktionieren.

Ein Shortcode zur Anzeige mehrerer Bilder in einem Layout.

  • Spezifikationen: Löst IDs im Attribut ids in tatsächliche Bild-URLs auf und gibt sie basierend auf der Einstellung columns als Grid-Layout aus.
  • Beispiel für die Ausgabe: Jedes Bild wird in ein figure-Tag eingeschlossen, und das gesamte Set wird in einen div-Container mit einer Klasse für Stiländerungen gepackt.

[caption] (Bildunterschrift)

Ein Shortcode zum Hinzufügen von Beschreibungen (Bildunterschriften) zu Bildern.

  • Spezifikationen: Trennt das Bild-Tag vom Text und wandelt sie in eine semantische <figure>- und <figcaption>-Struktur um.

[audio] / [video] (Audio- und Video-Player)

Shortcodes zum Abspielen von Audio- oder Videodateien in einem Artikel.

  • Spezifikationen: Umgewandelt in Standard-Browser-Tags <audio controls> oder <video controls>. Bei Videos bleibt auch das Attribut poster (Vorschaubild) erhalten.

[embed] (Einbetten externer Inhalte)

Ein Shortcode zum Einbetten externer Websites wie YouTube oder Vimeo.

  • Spezifikationen: Identifiziert automatisch YouTube- oder Vimeo-URLs und wandelt sie in eingebettete <iframe>-Player um. Andere URLs werden zur Sicherheit als externe Links ausgegeben.

[playlist] (Wiedergabeliste)

Ein Shortcode zur Anzeige einer Liste mehrerer Audio- oder Videodateien.

  • Spezifikationen: Gibt die Elemente als Aufzählungsliste einschließlich Bildern oder Dateinamen aus, um defekte Links zu vermeiden.

2. Sicherheitsfunktionen zur Vermeidung unbeabsichtigter Konvertierung

Um sicherzustellen, dass eckige Klammern [...], die im normalen Text erscheinen, nicht versehentlich gelöscht oder konvertiert werden, setzen wir folgende Sicherheitsvorgaben ein:

Nur Kleinschreibung (Groß-/Kleinschreibung beachten)

Nur Tags, die vollständig in Kleinschreibung geschrieben sind, werden als Shortcodes erkannt.

  • Ziel der Konvertierung: [gallery], [audio] usw.
  • Geschützt: Notationen, die Großbuchstaben oder Zahlen enthalten, wie [Any], [This] oder [123], werden exakt so beibehalten, wie sie sind, als Text.

Escaping mit doppelten Klammern

Ähnlich wie bei den WordPress-Standardspezifikationen können Sie die Konvertierung vermeiden, indem Sie doppelte Klammern verwenden.

  • Eingabe: [[gallery]]
  • Ausgabe: [gallery] (Wird als Text angezeigt, anstatt als Shortcode ausgeführt zu werden)

Schutz nicht definierter Tags

Unbekannte Tags, die nicht im System definiert sind, werden wie folgt behandelt:

  • Umschließender Typ [tag]Inhalt[/tag]: Nur die Tag-Teile werden entfernt; der „Inhalt“ bleibt immer erhalten.
  • Eigenständiger Typ [tag]: Sofern er nicht in der unten genannten Blacklist enthalten ist, wird er als Text behandelt und unverändert beibehalten.

3. Automatisches Entfernen von unnötigem Code (Blacklist)

Bekannter Code von Plugins, der bei der Migration zu Shopify überflüssig wird, wird automatisch entfernt.

  • Ziel-Keywords: contact-form-7, mwform_formkey, gravityform, contact-form, rev_slider, layerslider, sitemap, addtoany, yoast_breadcrumb usw.
  • Ziel-Präfixe: Alle Tags, die mit vc_ (von WPBakery) oder et_pb_ (von Divi) beginnen.

Diese Einstellungen werden in einer Konfigurationsdatei für Entwickler (shortcode-config.ts) verwaltet, und spezifische Tags können bei Bedarf zur Liste der zu entfernenden Tags hinzugefügt werden.