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 vários players <audio controls> ou <video controls> em sequência.

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:

Reconhecimento de tags definidas

Os nomes definidos são reconhecidos sem diferenciar maiúsculas e minúsculas. [gallery] e [GALLERY] são convertidos. Nomes não definidos, como [gallery-custom], são preservados.

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]: O shortcode completo, incluindo tags e conteúdo, é 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.

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.

4. Restaurar conteúdo de construtores de páginas

As tags de estrutura conhecidas do WPBakery e Divi são removidas mantendo o texto. As tags abaixo restauram imagens, galerias, botões e vídeos dos atributos como HTML padrão. O layout e o CSS originais não são reproduzidos.

TipoTags compatíveis
Imagensvc_single_image, et_pb_image
Galeriasvc_gallery, et_pb_gallery
Botõesvc_btn, vc_button, et_pb_button
Vídeosvc_video, et_pb_video

Os IDs de imagem exigem URLs de anexos no XML ou dados de mídia obtidos pelo WP Plugin. JSON sem mídia não pode resolver apenas IDs. Componentes não compatíveis, imagens não resolvidas e atributos inválidos preservam os shortcodes originais. Os artigos afetados são listados na tela.

5. Formatação automática de quebras de linha

Por padrão, os blocos existentes são preservados e o texto fora deles recebe parágrafos. A formatação interna fica inicialmente desativada e requer formatação de parágrafos. Sem custo adicional.

Quando ativada, o texto solto em contêineres como div recebe parágrafos. Os elementos p, li e td mantêm a estrutura, convertendo quebras de linha do texto em br. Indentação só de espaços, tags, atributos, comentários, código, SVG e MathML são preservados. Confira a prévia.

A detecção verifica todos os conteúdos e resumos exportados segundo o mapeamento de campos e a seleção de publicados ou rascunhos. A prévia e o CSV usam o mesmo processamento.

Se alguma mídia de gallery ou playlist não puder ser resolvida, o shortcode inteiro será preservado e o artigo afetado será indicado. Audio e video com URLs que não podem ser convertidas com segurança também são preservados. O conteúdo de tags envolventes desconhecidas e as quebras de linha nos atributos permanecem inalterados. Quebras usadas para organizar imagens não recebem tags br.