Índice de Conteúdo
Requisitos técnicos Magento
A tradução automática neural para uso com Magento requer o script PHP (disponível para download abaixo). Para instalar o Linguise , você precisará dos seguintes requisitos:
- Execute PHP 7+
- Servidor Apache, LiteSpeed, NGINX, IIS
- Ative a reescrita de URLs através da configuração Magento
- Magento 2+
- A pasta raiz do Magento /pub ”, certifique-se de instalar Linguise dentro dessa pasta.
Gere a chave da API
Após conectar-se ao painel de controle Linguise , você precisará configurar um novo domínio e salvar suas configurações para obter a chave da API.
A chave de API é necessária para ativar a tradução no seu site Magento . Basicamente, a chave de API verifica qual idioma está ativado em qual domínio e permite que as páginas de tradução neural sejam geradas.
Copie a chave da API e guarde-a na sua área de transferência.
Em seguida, clicando na aba “Script PHP”, você encontrará as instruções de instalação que seguiremos aqui em detalhes.
Faça o upload 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 baixar o 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, fica dentro /pub ).
- Certifique-se de que a pasta mantenha seu nome padrão “ linguise ”.
Como acessar a interface de script Linguise ?
Após concluir a Linguise , você pode acessar o painel de controle visitando seu site com o seguinte formato de URL
linguise https://www.domain.com/linguise
Altere o endereço do domínio de acordo com o endereço do seu site*.
Certifique-se de que Linguise tenha as permissões de leitura e gravação adequadas*.
Configurar senha e conexão com o banco de dados
Após acessar a interface do script, você verá uma tela de configuração onde poderá criar uma senha e se conectar ao banco de dados de sua preferência.
Você pode:
- Defina uma senha, que será necessária para acessos futuros a esta interface.
- Escolha o tipo de banco de dados — MySQL ou SQLite, dependendo da sua configuração e preferência.
Essa configuração inicial garante acesso seguro e permite que você configure o script de acordo com seu ambiente.
Conexão com banco de dados MySQL
Se você escolher MySQL, uma interface diferente será exibida, solicitando os seguintes detalhes de conexão nos campos de configuração do MySQL, conforme abaixo:
Certifique-se de que as informações estejam corretas para estabelecer uma conexão bem-sucedida com seu banco de dados MySQL.
MySQL vs SQLite – Qual a diferença?
Tanto o MySQL quanto o SQLite são sistemas de banco de dados populares usados para armazenar e gerenciar dados de sites e aplicativos. No entanto, eles são projetados para casos de uso diferentes e apresentam algumas diferenças importantes:
| Recurso | SQLite | MySQL |
|---|---|---|
| Configurar | Muito fácil (requer instalação do SQLite) | Requer configuração do servidor |
| Armazenamento | Fila única | Gerenciado pelo servidor MySQL |
| Desempenho | Ótimo para aplicativos de pequena escala | Melhor opção para sistemas grandes e de alto tráfego |
| Caso de uso | Aplicativos locais, testes, sites pequenos | Aplicativos web, comércio eletrônico, sistemas empresariais |
Interface de script Linguise : Configuração para a plataforma PHP
O painel de tradução Linguise , anteriormente disponível apenas para Joomla e WordPress, agora oferece suporte ao PHP e a outras plataformas. Essa atualização permite que os usuários configurem facilmente as definições de idioma — como opções de exibição, estilos de bandeiras e personalização da aparência — diretamente de uma interface unificada, independentemente do CMS ou framework utilizado.
Os administradores podem gerenciar as configurações Linguise com mais eficiência, graças a recursos consistentes como janelas pop-up de seleção de idioma, efeitos de sombra e variantes de opções de sinalização específicas para cada região. O painel de controle mantém seu design intuitivo, oferecendo ao mesmo tempo maior compatibilidade com diversos ambientes web.
Configuração adicional Magento
Na barra lateral de administração, acesse 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 o arquivo app/etc/env.php . Defina 'document_root_is_pub' como verdadeiro.
Certifique-se de configurar ambas as etapas e continue com a Configuração de reescrita de URL para garantir que Linguise funcione corretamente em seu site Magento sem problemas.
Configure a reescrita de URLs
Na barra lateral de administração, acesse Lojas > Configurações > Configuração > Geral > Web > Otimização para mecanismos de busca e habilite a Usar reescrita do servidor web . Mais informações na documentação oficial Magento
A configuração de URLs por idioma precisa ser feita no arquivo .htaccess. Basta copiar este código após a linha “ RewriteEngine on ”, presente no arquivo .htaccess padrão Magento 2 :
<IfModule mod_rewrite.c>
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]
</IfModule>
Por fim, seu arquivo .htaccess Magento deve ter uma aparência semelhante a esta:
Ative o seletor de idiomas
Carregar o script JS Linguise
Agora você pode carregar todas as suas páginas traduzidas usando a URL, por exemplo: www.shop.com/fr/
O seletor de idiomas é o ícone de bandeira que permite escolher o idioma desejado. Para acessá-lo, você precisará copiar o código fornecido ao final da configuração do site e colá-lo no cabeçalho da sua página HTML. O seletor de idiomas com a bandeira será carregado automaticamente.
O código para copiar e carregar no cabeçalho do seu site está disponível no seu Linguise > Seu domínio > Configurações > Aba: Script PHP
É necessário carregar o conteúdo no cabeçalho da página. Magento 2 permite adicionar conteúdo ao cabeçalho da página através da configuração.
No painel de administração, acesse Conteúdo > Configuração , edite a visualização do tema padrão da sua loja, clique na seção Cabeçalho HTML e adicione o script copiado no campo Scripts e Folhas de Estilo. Por fim, salve a configuração.
Instale o módulo de segurança Magento
A partir do Magento 2.3.5, é necessário adicionar um módulo de segurança para permitir que Magento carregue arquivos do domínio Linguise . Se você já está familiarizado com Magento , isso não será um problema; caso contrário, aqui está um guia passo a passo:
- Faça o download do módulo através deste link.
- Descompacte o conteúdo do arquivo zip na 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 idiomas será exibido por padrão em uma posição flutuante no canto inferior direito do seu site. Você pode personalizá-lo no painel de controle Linguise .
Nota importante sobre 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 (mais de 500), o mecanismo de busca pode levar muito tempo para processá-las. Isso pode afetar o SEO no seu idioma original. Por isso, recomendamos adicionar inicialmente um máximo de 5 idiomas e, à medida que a indexação for concluída, você poderá adicionar idiomas em lotes de 3 por mês.
Configurar o seletor de idioma
O seletor de idiomas pode ser personalizado no painel de controle Linguise > Configurações > Exibição de indicadores de idioma. Todas as alterações feitas aqui serão refletidas no site.
No lado direito da tela, você encontra a pré-visualização do seletor de idiomas. 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 dos idiomas em inglês ou no idioma nativo
- Formas e tamanho das bandeiras
- Cores e sombra da caixa
Carregar o seletor de idiomas no conteúdo Magento
Para exibir o seletor de idiomas em um local específico no Magento , você deve definir a posição como "No local".
Depois de definir a posição no Linguise , você pode adicionar o shortcode abaixo para incluí-lo. Clique no código abaixo para copiá-lo para a sua área de transferência.
<div>[linguise]</div>
Depois de adicionado, no frontend você verá os nomes das bandeiras e dos idiomas exibidos na área HTML onde você inseriu o código.
Ativar 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 carregar as páginas mais rapidamente. O cache local reduzirá a transferência de dados entre o servidor Linguise e o servidor do seu site. O cache é usado somente quando uma página já foi traduzida e não foi atualizada. O cache das páginas multilíngues mais visualizadas terá prioridade.
Como opção, você pode definir a quantidade de cache armazenada em MB. No exemplo a seguir, o cache está 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