Os plugins de tradução standard degradam frequentemente o desempenho do WooCommerce ao criarem entradas de publicações 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 — incluindo carrinho, finalização de compra e feeds dinâmicos — sem afetar os tempos de resposta do seu servidor.
Este guia detalha o processo de integração utilizando a arquitetura de temas standard do WordPress/WooCommerce.
1. Pré-requisitos de Implementação
Antes de editar os ficheiros do seu tema, certifique-se de que tem:
Acesso de Administrador
Acesso FTP/SFTP ou permissões para utilizar o Editor de Ficheiros de Temas do WordPress.
Tema Filho (Recomendado)
Sugerimos vivamente que efetue estas alterações num Tema Filho (Child Theme). Se editar o tema principal diretamente, as suas alterações poderão ser substituídas durante uma atualização do tema.
Chave API MultiLipi
Localizado no seu Painel de Controlo em Definições > Geral.
2. Passo 1: Aceder à Arquitetura do Tema
Iremos injetar o script no cabeçalho global (header.php) para garantir que o mesmo é carregado antes dos fragmentos do carrinho do WooCommerce.
Opção A: Utilizar o Painel do WordPress (Mais fácil)
- Inicie sessão no seu Painel de Controlo do WordPress.
- Navegue até Aparência > Editor de Ficheiros do Tema.
- Na lista de ficheiros à direita, localize Cabeçalho do Tema (header.php).
Opção B: Utilizar FTP/cPanel (Avançado)
- Navegue até
/wp-content/themes/o-seu-tema-ativo/. - Abrir header.php.
3. Passo 2: Injetar o Script de Comércio
Desloque-se através de header.php para encontrar o fecho de </head> etiqueta.
Ação: Cole o seguinte bloco de infraestrutura imediatamente acima da linha </head> .
<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
SUA_CHAVE_DE_API_AQUIcom a sua Chave de API MultiLipi real. - Nota: O
data-pos-xedata-pos-yos atributos controlam a posição predefinida do widget. Pode ajustar estes valores (0-100) para mover o seletor flutuante caso este sobreponha os seus botões "Chat" ou "Voltar ao Topo".
Clique Atualizar Ficheiro (ou Guardar via FTP).
4. Passo 3: Validação e Testes de Funil
O comércio eletrónico exige testes rigorosos. Verifique a integração em toda a jornada do comprador.
Limpar Cache
Se utilizar WP Rocket, W3 Total Cache ou cache ao nível do servidor (Varnish/Nginx), purgue todas as caches imediatamente.
Verificação Visual
Recarregue a sua montra digital. O Seletor de Idioma deve aparecer na posição configurada (Inferior Esquerdo por predefinição).
Verificação da Finalização da Compra
Adicione um produto ao carrinho. Altere o idioma. Avance para a Finalização da Compra.
Critérios de Sucesso:
Certifique-se de que os campos de Finalização da Compra (Morada de Faturação, Métodos de Pagamento) estão traduzidos e funcionais.
5. Otimização de Comércio
MultiLipi foi concebido para processar elementos dinâmicos do WooCommerce de forma nativa.
Carga de Base de Dados Zero
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 de Carrinho Dinâmicos
O nosso motor deteta automaticamente atualizações do carrinho AJAX (por exemplo, quando um utilizador altera a quantidade) e traduz os novos totais instantaneamente.
Automação de 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 correto de moeda e idioma.