S volbou Vyčištění shortcode v naší službě pro migraci jsou shortcode obsažené v příspěvcích WordPressu během procesu importu automaticky převedeny do formátů, které se správně zobrazují v tématech Shopify. Tato stránka vysvětluje konkrétní chování každého shortcode a bezpečnostní funkce zavedené k zabránění neúmyslnému přepsání.

1. Hlavní automaticky převáděné shortcode

Následující shortcode jsou automaticky nahrazeny HTML tagy nebo vestavěnými přehrávači, které fungují v rámci těla Shopify (body_html).

Shortcode pro zobrazení více obrázků v rozvržení.

  • Specifikace: Rozliší ID v atributu ids na skutečné URL obrázků a vypíše je jako mřížkové rozvržení na základě nastavení columns.
  • Příklad výstupu: Každý obrázek je uzavřen v tagu figure a celá sada je zabalena v kontejneru div s třídou pro úpravy stylů.

[caption] (Titulek obrázku)

Shortcode pro přidání popisků (titulků) k obrázkům.

  • Specifikace: Oddělí tag obrázku od textu a převede je na sémantickou strukturu <figure> a <figcaption>.

[audio] / [video] (Audio a video přehrávače)

Shortcode pro přehrávání zvukových nebo video souborů v článku.

  • Specifikace: Převedeno na standardní prohlížečové tagy <audio controls> nebo <video controls>. U videí je zachován také atribut poster (náhled).

[embed] (Vkládání externího obsahu)

Shortcode pro vkládání externích stránek, jako je YouTube nebo Vimeo.

  • Specifikace: Automaticky identifikuje URL YouTube nebo Vimeo a převede je na vložené přehrávače <iframe>. Ostatní URL jsou z důvodu bezpečnosti vypsány jako externí odkazy.

[playlist] (Seznam stop)

Shortcode pro zobrazení seznamu více zvukových nebo video souborů.

  • Specifikace: Vypíše položky jako seznam s odrážkami včetně obrázků nebo názvů souborů, aby se zabránilo nefunkčním odkazům.

2. Bezpečnostní funkce zabraňující nechtěnému převodu

Aby bylo zajištěno, že hranaté závorky [...] objevující se v běžném textu nebudou náhodně smazány nebo převedeny, používáme následující bezpečnostní specifikace:

Pouze malá písmena (citlivost na velikost písmen)

Jako shortcode jsou rozpoznány pouze tagy napsané zcela malými písmeny.

  • Cíleno pro převod: [gallery], [audio] atd.
  • Chráněno: Zápisy obsahující velká písmena nebo čísla jako [Any], [This] nebo [123] jsou ponechány přesně tak, jak jsou, jako text.

Escapování dvojitými závorkami

Podobně jako u standardních specifikací WordPressu se můžete vyhnout převodu použitím dvojitých závorek.

  • Vstup: [[gallery]]
  • Výstup: [gallery] (Zobrazí se jako text, místo aby byl proveden jako shortcode)

Ochrana nedefinovaných tagů

Neznámé tagy nedefinované v systému jsou zpracovány následovně:

  • Uzavírací typ [tag]Obsah[/tag]: Jsou odstraněny pouze části tagů; „Obsah“ je vždy zachován.
  • Samostatný typ [tag]: Pokud není zahrnut v níže uvedeném blacklistu, je považován za text a ponechán tak, jak je.

3. Automatické odstranění nepotřebného kódu (Blacklist)

Známý kód z pluginů, který se stává při migraci na Shopify nepotřebným, je automaticky odstraněn.

  • Cílová klíčová slova: contact-form-7, mwform_formkey, gravityform, contact-form, rev_slider, layerslider, sitemap, addtoany, yoast_breadcrumb atd.
  • Cílové předpony: Všechny tagy začínající na vc_ (od WPBakery) nebo et_pb_ (od Divi).

Tato nastavení jsou spravována v konfiguračním souboru pro vývojáře (shortcode-config.ts) a konkrétní tagy mohou být podle potřeby přidány na seznam pro odstranění.