Com a opção de Limpeza de Shortcodes em nosso serviço de migração, os shortcodes incluídos nas postagens do WordPress são convertidos automaticamente em formatos que são exibidos corretamente nos temas do Shopify durante o processo de importação. Esta página explica o comportamento específico de cada shortcode e os recursos de segurança implementados para evitar substituições não intencionais.

1. Principais shortcodes convertidos automaticamente

Os shortcodes a seguir são substituídos automaticamente por tags HTML ou players incorporados que funcionam no corpo do Shopify (body_html).

Um shortcode para exibir várias imagens em um layout.

  • Especificações: Resolve os IDs no atributo ids para URLs de imagens reais e os exibe como um layout de grade com base na configuração de columns.
  • Exemplo de saída: Cada imagem é envolvida em uma tag figure, e todo o conjunto é envolvido em um contêiner div com uma classe para ajustes de estilo.

[caption] (Legenda da imagem)

Um shortcode para adicionar descrições (legendas) às imagens.

  • Especificações: Separa a tag da imagem do texto e os converte em uma estrutura semântica <figure> e <figcaption>.

[audio] / [video] (Players de áudio e vídeo)

Shortcodes para reproduzir arquivos de áudio ou vídeo dentro de um artigo.

  • Especificações: Convertidos em tags padrão do navegador <audio controls> ou <video controls>. Para vídeos, o atributo poster (miniatura) também é preservado.

[embed] (Incorporação de conteúdo externo)

Um shortcode para incorporar sites externos, como YouTube ou Vimeo.

  • Especificações: Identifica automaticamente URLs do YouTube ou Vimeo e os converte em players <iframe> incorporados. Outras URLs são exibidas como links externos por segurança.

[playlist] (Lista de reprodução)

Um shortcode para exibir uma lista de vários arquivos de áudio ou vídeo.

  • Especificações: Exibe os itens como uma lista com marcadores, incluindo imagens ou nomes de arquivos para evitar links quebrados.

2. Recursos de segurança para evitar conversão não intencional

Para garantir que os colchetes [...] que aparecem no texto normal não sejam excluídos ou convertidos acidentalmente, utilizamos as seguintes especificações de segurança:

Apenas letras minúsculas (sensível a maiúsculas e minúsculas)

Apenas as tags escritas totalmente em letras minúsculas são reconhecidas como shortcodes.

  • Alvo de conversão: [gallery], [audio], etc.
  • Protegido: Notações contendo letras maiúsculas ou números, como [Any], [This] ou [123], são mantidas exatamente como estão, como texto.

Escape com colchetes duplos

Semelhante às especificações padrão do WordPress, você pode evitar a conversão usando colchetes duplos.

  • Entrada: [[gallery]]
  • Saída: [gallery] (Exibido como texto em vez de ser executado como um shortcode)

Proteção de tags indefinidas

Tags desconhecidas não definidas no sistema são tratadas da seguinte forma:

  • Tipo envolvente [tag]Conteúdo[/tag]: Somente as partes da tag são removidas; o “Conteúdo” é sempre preservado.
  • Tipo autônomo [tag]: A menos que esteja incluído na lista negra mencionada abaixo, é tratado como texto e mantido como está.

3. Remoção automática de código desnecessário (Lista negra)

Códigos conhecidos de plug-ins que se tornam desnecessários durante a migração para o Shopify são removidos automaticamente.

  • Palavras-chave de destino: contact-form-7, mwform_formkey, gravityform, contact-form, rev_slider, layerslider, sitemap, addtoany, yoast_breadcrumb, etc.
  • Prefixos de destino: Todas as tags que começam com vc_ (da WPBakery) ou et_pb_ (da Divi).

Essas configurações são gerenciadas em um arquivo de configuração para desenvolvedores (shortcode-config.ts), e tags específicas podem ser adicionadas à lista de remoção conforme necessário.