Dzięki opcji oczyszczania shortcodów w naszej usłudze migracji, shortcody zawarte we wpisach WordPress są automatycznie konwertowane podczas procesu importu na formaty, które wyświetlają się poprawnie w motywach Shopify. Ta strona wyjaśnia specyficzne zachowanie każdego shortcodu oraz funkcje bezpieczeństwa wprowadzone w celu zapobiegania niezamierzonemu nadpisaniu.

1. Główne shortcody konwertowane automatycznie

Następujące shortcody są automatycznie zastępowane tagami HTML lub wbudowanymi odtwarzaczami, które działają w treści Shopify (body_html).

Shortcode do wyświetlania wielu zdjęć w układzie.

  • Specyfikacja: Rozwiązuje identyfikatory w atrybucie ids na rzeczywiste adresy URL obrazów i wyświetla je w układzie siatki na podstawie ustawienia columns.
  • Przykład wyjściowy: Każdy obraz jest zawinięty w tag figure, a cały zestaw jest zawinięty w kontener div z klasą do regulacji stylu.

[caption] (Podpis pod zdjęciem)

Shortcode do dodawania opisów (podpisów) do zdjęć.

  • Specyfikacja: Oddziela tag obrazu od tekstu i konwertuje je na semantyczną strukturę <figure> i <figcaption>.

[audio] / [video] (Odtwarzacze audio i wideo)

Shortcody do odtwarzania plików audio lub wideo wewnątrz artykułu.

  • Specyfikacja: Konwertowane na standardowe tagi przeglądarki <audio controls> lub <video controls>. W przypadku filmów zachowywany jest również atrybut poster (miniatura).

[embed] (Osadzanie treści zewnętrznych)

Shortcode do osadzania stron zewnętrznych, takich jak YouTube czy Vimeo.

  • Specyfikacja: Automatycznie identyfikuje adresy URL YouTube lub Vimeo i konwertuje je na osadzone odtwarzacze <iframe>. Inne adresy URL są ze względów bezpieczeństwa wyświetlane jako linki zewnętrzne.

[playlist] (Playlista)

Shortcode do wyświetlania listy wielu plików audio lub wideo.

  • Specyfikacja: Wyświetla elementy jako listę punktowaną zawierającą obrazy lub nazwy plików, aby zapobiec niedziałającym linkom.

2. Funkcje bezpieczeństwa zapobiegające niezamierzonej konwersji

Aby zapewnić, że nawiasy kwadratowe [...] pojawiające se w zwykłym tekście nie zostaną przypadkowo usunięte lub przekonwertowane, stosujemy następujące specyfikacje bezpieczeństwa:

Tylko małe litery (rozróżnianie wielkości liter)

Tylko tagi napisane wyłącznie małymi literami są rozpoznawane jako shortcody.

  • Przeznaczone do konwersji: [gallery], [audio] itp.
  • Chronione: Zapisy zawierające wielkie litery lub cyfry, takie jak [Any], [This] czy [123], są zachowywane dokładnie w takiej formie, jako tekst.

Eskapowanie podwójnymi nawiasami

Podobnie jak w standardowych specyfikacjach WordPress, można uniknąć konwersji, używając podwójnych nawiasów.

  • Wejście: [[gallery]]
  • Wyjście: [gallery] (Wyświetla się jako tekst zamiast być wykonywanym jako shortcode)

Ochrona niezdefiniowanych tagów

Nieznane tagi niezdefiniowane w systemie są obsługiwane w następujący sposób:

  • Typ otaczający [tag]Treść[/tag]: Usuwane są tylko części tagów; „Treść” jest zawsze zachowywana.
  • Typ samodzielny [tag]: O ile nie znajduje się na poniższej czarnej liście, jest traktowany jako tekst i zachowywany bez zmian.

3. Automatyczne usuwanie niepotrzebnego kodu (Czarna lista)

Znany kod z wtyczek, który staje się niepotrzebny podczas migracji do Shopify, jest automatycznie usuwany.

  • Docelowe słowa kluczowe: contact-form-7, mwform_formkey, gravityform, contact-form, rev_slider, layerslider, sitemap, addtoany, yoast_breadcrumb itp.
  • Docelowe prefiksy: Wszystkie tagi zaczynające się od vc_ (z WPBakery) lub et_pb_ (z Divi).

Ustawienia te są zarządzane w pliku konfiguracyjnym dla programistów (shortcode-config.ts), a konkretne tagi mogą być dodawane do listy usuwania w razie potrzeby.