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

1. Principais shortcodes convertidos automaticamente

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

Um shortcode para apresentar várias imagens num esquema.

  • Especificações: Resolve os IDs no atributo ids para URLs de imagens reais e apresenta-os como um esquema de grelha com base na configuração de columns.
  • Exemplo de saída: Cada imagem é envolvida numa etiqueta figure, e todo o conjunto é envolvido num contentor 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 etiqueta da imagem do texto e converte-os numa estrutura semântica <figure> e <figcaption>.

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

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

  • Especificações: Convertidos em etiquetas 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 o YouTube ou o Vimeo.

  • Especificações: Identifica automaticamente URLs do YouTube ou do Vimeo e converte-os em reprodutores <iframe> incorporados. Outras URLs são apresentadas como ligações externas por segurança.

[playlist] (Lista de reprodução)

Um shortcode para apresentar uma lista de vários ficheiros de áudio ou vídeo.

  • Especificações: Apresenta os itens como uma lista com marcadores, incluindo imagens ou nomes de ficheiros para evitar ligações quebradas.

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

Para garantir que os parênteses retos [...] que aparecem no texto normal não sejam eliminados 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 etiquetas 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 parênteses retos duplos

Semelhante às especificações padrão do WordPress, pode evitar a conversão utilizando parênteses retos duplos.

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

Proteção de etiquetas indefinidas

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

  • Tipo envolvente [tag]Conteúdo[/tag]: Somente as partes da etiqueta 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 plugins que se tornam desnecessários durante a migração para a 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 etiquetas que começam com vc_ (da WPBakery) ou et_pb_ (da Divi).

Estas configurações são geridas num ficheiro de configuração para programadores (shortcode-config.ts), e etiquetas específicas podem ser adicionadas à lista de remoção conforme necessário.