Con l’opzione di pulizia degli shortcode nel nostro servizio di migrazione, gli shortcode inclusi negli articoli di WordPress vengono convertiti automaticamente in formati che vengono visualizzati correttamente nei temi Shopify durante il processo di importazione. Questa pagina spiega il comportamento specifico di ogni shortcode e le funzioni di sicurezza implementate per evitare sovrascritture involontarie.

1. Principali shortcode convertiti automaticamente

I seguenti shortcode vengono sostituiti automaticamente con tag HTML o lettori incorporati che funzionano all’interno del corpo di Shopify (body_html).

Uno shortcode per visualizzare più immagini in un layout.

  • Specifiche: Risolve gli ID nell’attributo ids in URL di immagini reali e li visualizza in un layout a griglia basato sull’impostazione columns.
  • Esempio di output: Ogni immagine è avvolta in un tag figure e l’intero set è racchiuso in un contenitore div con una classe per le regolazioni dello stile.

[caption] (Didascalia immagine)

Uno shortcode per aggiungere descrizioni (didascalie) alle immagini.

  • Specifiche: Separa il tag dell’immagine dal testo e li converte in una struttura semantica <figure> e <figcaption>.

[audio] / [video] (Lettori audio e video)

Shortcode per riprodurre file audio o video all’interno di un articolo.

  • Specifiche: Convertiti nei tag standard del browser <audio controls> o <video controls>. Per i video, viene conservato anche l’attributo poster (miniatura).

[embed] (Incorporamento di contenuti esterni)

Uno shortcode per incorporare siti esterni come YouTube o Vimeo.

  • Specifiche: Identifica automaticamente gli URL di YouTube o Vimeo e li converte in lettori <iframe> incorporati. Gli altri URL vengono visualizzati come collegamenti esterni per sicurezza.

[playlist] (Playlist)

Uno shortcode per visualizzare un elenco di più file audio o video.

  • Specifiche: Visualizza gli elementi come un elenco puntato che include immagini o nomi di file per evitare collegamenti interrotti.

2. Funzioni di sicurezza per prevenire conversioni involontarie

Per garantire che le parentesi quadre [...] che appaiono nel testo normale non vengano accidentalmente eliminate o convertite, utilizziamo le seguenti specifiche di sicurezza:

Solo minuscole (case-sensitive)

Solo i tag scritti interamente in minuscolo vengono riconosciuti come shortcode.

  • Destinatari della conversione: [gallery], [audio], ecc.
  • Protetti: Le notazioni contenenti lettere maiuscole o numeri come [Any], [This] o [123] vengono mantenute esattamente così come sono, come testo.

Escape con doppie parentesi quadre

Analogamente alle specifiche standard di WordPress, puoi evitare la conversione utilizzando le doppie parentesi quadre.

  • Input: [[gallery]]
  • Output: [gallery] (Viene visualizzato come testo invece di essere eseguito come shortcode)

Protezione dei tag non definiti

I tag sconosciuti non definiti nel sistema vengono gestiti come segue:

  • Tipo racchiuso [tag]Contenuto[/tag]: Vengono rimosse solo le parti dei tag; il “Contenuto” viene sempre preservato.
  • Tipo autonomo [tag]: A meno che non sia incluso nella blacklist menzionata di seguito, viene trattato come testo e mantenuto così com’è.

3. Rimozione automatica del codice non necessario (Blacklist)

Il codice noto proveniente da plugin che diventa non necessario durante la migrazione a Shopify viene rimosso automaticamente.

  • Parole chiave di destinazione: contact-form-7, mwform_formkey, gravityform, contact-form, rev_slider, layerslider, sitemap, addtoany, yoast_breadcrumb, ecc.
  • Prefissi di destinazione: Tutti i tag che iniziano con vc_ (da WPBakery) o et_pb_ (da Divi).

Queste impostazioni sono gestite in un file di configurazione per gli sviluppatori (shortcode-config.ts) e tag specifici possono essere aggiunti all’elenco di rimozione secondo necessità.