Plugins de tradução padrão muitas vezes degradam o desempenho do WooCommerce ao criar entradas de post duplicadas para cada produto em cada idioma. O MultiLipi elimina esta sobrecarga. Ao injetar o nosso Script de Infraestrutura de Comércio no cabeçalho do seu tema, ativa a tradução neural em tempo real para todo o seu catálogo — carrinho, checkout e feeds dinâmicos incluídos — sem impactar os tempos de resposta do seu servidor.

Este guia detalha o processo de integração utilizando a arquitetura padrão de temas do WordPress/WooCommerce.

1. Pré-requisitos para o desdobramento

Antes de editar os seus ficheiros de tema, certifique-se de que tem:

Acesso de Administrador

Acesso FTP/SFTP ou permissões para usar o Editor de Ficheiros do Tema do WordPress.

Tema Filho (Recomendado)

Sugerimos vivamente que faça estas alterações num Tema Filho. Se editar diretamente o tema pai, as suas alterações poderão ser substituídas durante uma atualização do tema.

Chave API MultiLipi

Localizado no seu Painel em Definições > Geral.

2. Passo 1: Aceder à Arquitetura do Tema

Injetaremos o script no cabeçalho global (header.php) para garantir que ele seja carregado antes dos fragmentos do carrinho do WooCommerce.

Opção A: Usando o Admin do WordPress (Mais Fácil)

Faça login no seu painel do WordPress.
Navegue até Aparência > Editor de Arquivos do Tema .
Na lista de arquivos à direita, localize Cabeçalho do Tema (header.php) .

Opção B: Usando FTP/CPanel (Avançado)

Navegue até /wp-content/themes/o-seu-tema-ativo/ .
Aberto header.php .

3. Passo 2: Injetar o Script de Comércio

Percorra header.php para encontrar o fecho </head> tag.

Ação: Cole o seguinte bloco de infraestrutura imediatamente acima do </head> linha.

HTML

<script 
    src="https://multilipistorage.blob.core.windows.net/static/JS/page_translations.js" 
    multilipi-key="YOUR_API_KEY_HERE" 
    mode="auto" 
    data-pos-x="50" 
    data-pos-y="50" 
    crossorigin="anonymous">
</script>

⚠️ Configuração Crítica:

Substituir YOUR_API_KEY_HERE com a sua Chave API MultiLipi real.
Observação: O data-pos-x e ainda data-pos-y os atributos controlam a posição padrão do widget. Pode ajustar estes valores (0-100) para mover o seletor flutuante caso ele se sobreponha aos seus botões "Chat" ou "Voltar ao topo".

Clique em Atualizar Arquivo (ou Guardar via FTP).

4. Passo 3: Validação e Teste de Funil

O comércio requer testes rigorosos. Verifique a integração em toda a jornada do comprador.

Limpar Caches

Se utilizar WP Rocket, W3 Total Cache ou cache a nível de servidor (Varnish/Nginx), limpe todas as caches imediatamente.

Verificação Visual

Recarregue sua loja. O Seletor de Idioma deve aparecer na posição configurada (Canto Inferior Esquerdo por padrão).

Verificação do Checkout

Adicione um produto ao carrinho. Mude de idioma. Prossiga para o Checkout.

Critérios de Sucesso:

Certifique-se de que os campos de Checkout (Endereço de Cobrança, Métodos de Pagamento) sejam traduzidos e funcionais.

5. Otimização de Comércio

A MultiLipi foi concebida para lidar com elementos dinâmicos do WooCommerce de imediato.

⚡

Zero Carga na Base de Dados

Ao contrário do WPML ou Polylang, não criamos publicações separadas para cada tradução de produto. A sua base de dados permanece leve, garantindo consultas rápidas.

🛒

Fragmentos Dinâmicos do Carrinho

Nosso motor detecta automaticamente as atualizações do carrinho AJAX (por exemplo, quando um usuário altera a quantidade) e traduz os novos totais instantaneamente.

🎯

Automação SEO

Geramos automaticamente etiquetas hreflang para as suas páginas de produto, garantindo que o Google Shopping e os motores de busca locais indexam os seus artigos no contexto de moeda e idioma correto.

MultiLipi – Guia de Integração WooCommerce