Índice
Requisitos técnicos Magento
A tradução neural automática a ser usada com Magento exigirá o uso do script PHP (pode ser baixado abaixo). Para instalar o Linguise , você precisará dos seguintes requisitos:
- Execute PHP 7+
- Apache, LiteSpeed, NGINX, servidor IIS
- Ative a reescrita de URL através da configuração do Magento
- Magento 2+
- A pasta raiz do Magento /pub ”, certifique-se de instalar Linguise dentro desta pasta
Gere a chave de API
A chave API é o que é necessário para ativar a tradução em seu site Magento . Basicamente, a chave API verificará qual idioma está ativado em qual domínio e permitirá que as páginas de tradução neural sejam geradas.
Copie a chave API e mantenha-a na área de transferência.
Então clicando na aba “Script PHP” você terá as instruções de instalação que seguiremos aqui detalhadamente.
Carregue e conecte o script de tradução Linguise
O script de tradução Linguise precisa ser carregado no servidor onde Magento está instalado:
Após o download do script, descompacte-o e carregue-o na pasta raiz onde o CMS está instalado.
- Certifique-se de que esteja no nível raiz do seu site (onde seus Magento estão localizados, por padrão está na pasta /pub
- Certifique-se de que a pasta mantenha seu nome padrão “ linguise ”
A Linguise precisará ser copiada no Configuration.php que você carregou em seu servidor, edite o arquivo e copie sua chave API entre aspas simples, substitua o texto REPLACE_BY_TOUR TOKEN.
Configuração Extra Magento
Na barra lateral do administrador, vá para Lojas > Configurações > Configuração > Geral > Web > Opções de URL e defina a opção Adicionar código da loja aos URLs Não ”.
Acesse o código do seu site e abra app/etc/env.php . Defina 'document_root_is_pub' como verdadeiro.
Certifique-se de definir essas duas etapas e continue com a reescrita de URL de configuração para garantir que Linguise possa ser executado corretamente em seu site Magento sem problemas.
Configure a reescrita de URLs
Na barra lateral do administrador, vá para Lojas > Configurações > Configuração > Geral > Web > Otimização de mecanismos de pesquisa e ative a opção Usar reescrita do servidor Web Mais informações na documentação oficial Magento
A URL por idioma precisa ser configurada no .htaccess. Basta copiar este código após o código “ RewriteEngine on ” disponível no .htaccess padrão Magento 2 :
RewriteEngine On
RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA,END]
Finalmente, seu .htaccess Magento deve ser parecido com isto:
Ative o seletor de idioma
Carregar o script Linguise JS
Agora você pode carregar todas as suas páginas traduzidas usando o URL, por exemplo: www.shop.com /fr/
O alternador de idioma é o pop-up da bandeira para selecionar o idioma desejado. Para carregá-lo, você precisará copiar o código fornecido no final da configuração do site para o cabeçalho da sua página HTML. O alternador de idioma da bandeira será então carregado automaticamente.
O código para copiar e carregar no cabeçalho do seu site está disponível em seu Linguise > Seu domínio > Configuração > Guia: Script PHP
Ele precisa ser carregado no cabeçalho da sua página. Magento 2 oferece a capacidade de adicionar conteúdo no cabeçalho da sua página por meio da configuração.
No painel de administração, vá para Conteúdo > Configuração , edite sua visualização de tema de loja padrão, clique na seção Cabeçalho HTML e adicione o script copiado à entrada Scripts e Folhas de estilo. Por fim, salve a configuração.
Instale o módulo de segurança Magento
Desde Magento 2.3.5 você precisa adicionar um módulo de segurança para permitir que Magento carregue arquivos do domínio Linguise . Se você está familiarizado com Magento isso não será um problema, caso contrário aqui está um guia passo a passo:
- Baixe o módulo neste link
- Descompacte o conteúdo do zip em sua instalação Magento no diretório app/code/
- Em seguida, execute os comandos:
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
O seletor de idioma será exibido por padrão em uma posição flutuante no canto inferior direito do seu site. Você pode personalizá-lo no painel Linguise .
Observação importante de SEO: o número de idiomas que você configura tem um grande impacto no SEO. Ao configurar seus idiomas de tradução, se você tiver uma grande quantidade de páginas indexadas (>500), o mecanismo de pesquisa poderá demorar muito para processá-las. Isso pode afetar seu SEO em seu idioma original. É por isso que recomendamos adicionar inicialmente no máximo 5 idiomas, depois, quando estiver indexado, você pode adicionar idiomas em um lote de 3 por mês.
Configurar o seletor de idioma
O seletor de idioma pode ser personalizado no painel Linguise > Configurações > Exibição de sinalizadores de idioma. Cada modificação aqui será refletida no site.
No lado direito da tela, você tem a visualização do seletor de idioma. Aqui estão os elementos que você pode configurar:
- 3 layouts: lado a lado, suspenso ou pop-up
- A posição do seletor de idioma
- O conteúdo do seletor de idioma
- Nomes de idiomas em inglês ou idioma nativo
- Formas e tamanhos das bandeiras
- Cores e sombra da caixa
Carregue o alternador de idioma no conteúdo Magento
Para exibir o seletor de idioma em um local específico, no Magento , você deve definir a posição como “In place”.
Depois de definir a posição no Linguise , você pode adicionar o código de acesso abaixo para incluí-la. Clique no código abaixo para colocá-lo na área de transferência.
Depois de adicionado, no frontend você terá a bandeira e os nomes dos idiomas exibidos na área HTML onde você adicionou o código.
Ative o sistema de cache local
Como opção, você pode ativar um sistema de cache local que armazena URLs e seu conteúdo multilíngue relacionado para servir as páginas mais rapidamente. O cache local salvará algumas transferências de dados entre o servidor Linguise e o servidor do seu site. O cache é usado apenas quando uma página já foi traduzida e não foi atualizada. O cache mantido em prioridade será o cache das páginas multilíngues mais visualizadas.
Como opção, você pode definir a quantidade de cache armazenada em MB. No exemplo a seguir, o cache é ativado e a quantidade de cache a ser mantida é de 500 MB:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte