Índice
Requisitos técnicos OpenCart
A tradução neural automática a ser usada com OpenCart 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 PrestaShop
Como instalar a tradução OpenCart
1. Gere a chave API para ativar a tradução
A chave API é o que é necessário para ativar a tradução em seu OpenCart . 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.

2. Carregue e conecte o script Linguise com OpenCart
O script de tradução Linguise precisa ser carregado em seu servidor onde OpenCart 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 OpenCart estão localizados)
- Certifique-se de que a pasta mantenha seu nome padrão “ linguise ”

Como acessar a interface de script Linguise ?
Depois de concluir a Linguise , você pode acessar o painel visitando seu site com o seguinte formato de URL:
https://www.domain.com/ linguise
Altere o endereço do domínio de acordo com o endereço do seu site*
Garanta que Linguise tenha permissão de leitura e gravação adequada*
Configuração de senha e conexão com o banco de dados
Depois de acessar a interface de script, você receberá uma tela de configuração, onde pode criar uma senha e conectar -se ao seu banco de dados preferido.
Você pode:
- Defina uma senha, que será necessária para acesso futuro a esta interface.
- Escolha o seu 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 configurar o script de acordo com o seu ambiente.

Conexão do banco de dados MySQL
Se você escolher o MySQL, uma interface diferente aparecerá solicitando os seguintes detalhes da conexão dos campos de configuração do MySQL abaixo:

Verifique se as informações estão corretas para estabelecer uma conexão bem -sucedida com o seu banco de dados MySQL.
MySQL vs Sqlite - Qual é a diferença?
Tanto o MySQL quanto o SQLite são sistemas populares de banco de dados usados para armazenar e gerenciar dados para sites e aplicativos. No entanto, eles são projetados para diferentes casos de uso e têm algumas diferenças importantes:
Recurso | Sqlite | Mysql |
---|---|---|
Configurar | Muito fácil (instalação sqlite necessária) | Requer configuração do servidor |
Armazenar | Arquivo único | Gerenciado pelo MySQL Server |
Desempenho | Ótimo para aplicativos de pequena escala | Melhor para sistemas grandes e de alto tráfego |
Caso de uso | Aplicativos locais, testes, pequenos sites | Aplicativos da Web, comércio eletrônico, sistemas corporativos |
Interface de script Linguise : configuração para plataforma php
O painel de tradução Linguise , anteriormente disponível apenas para Joomla e WordPress, agora estende o suporte a PHP e plataformas adicionais. Esta atualização permite que os usuários definam perfeitamente as configurações de linguagem - como opções de exibição, estilos de sinalização e personalização da aparência - diretamente de uma interface unificada, independentemente de seu CMS ou estrutura.

Os administradores podem gerenciar configurações Linguise com mais eficiência, com recursos consistentes, como pop-ups de seleção de idiomas, efeitos de sombra e variantes de opções de sinalizador específicas da região. O painel mantém seu design fácil de usar, oferecendo compatibilidade mais ampla para diversos ambientes da Web.


3. Configure os URLs de idioma no OpenCart
A reescrita de URL geralmente é ativada para fins de SEO no OpenCart. A reescrita de URL está usando um arquivo .htaccess disponível na raiz do seu servidor.

Nas OpenCart , verifique se a reescrita de URL está ativada. Use o OpenCart :
Sistema > Configurações > Padrão > Servidor

A URL por idioma precisa ser configurada no .htaccess. Basta copiar este código após o código “RewriteBase /” disponível no .htaccess padrão OpenCart .
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]
Certifique-se de que o caminho linguise/linguise.php seja o mesmo em seu servidor, /linguise/ é o nome padrão ao descompactar o script.
4. Ative o alternador de idioma
Agora você pode carregar todas as suas páginas traduzidas usando o URL, por exemplo: www.domain.com/fr/

O alternador de idioma é o pop-up da bandeira para selecionar o idioma desejado. Para carregá-lo, você precisará copiar o link para o Linguise fornecido no OpenCart de todas as suas páginas. O alternador de idioma da bandeira será então carregado automaticamente. Aqui está o link do script que você pode encontrar em:
painel.linguise.com > Configurações

Em seguida, para adicioná-lo à instalação do OpenCart , vá em Design > Editor de tema e edite o padrão/cabeçalho do modelo.
O seletor de idioma será exibido por padrão em uma posição flutuante no canto superior direito do seu site. Você está pronto para personalizá-lo no painel do Linguise na próxima etapa.

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 alternador de idioma pode ser personalizado no 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 prévia 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 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 OpenCart

Para exibir o seletor de idioma em um local específico, no conteúdo do CMS, 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.
[linguise]
Depois de adicionado, no frontend você terá a bandeira e os nomes dos idiomas exibidos na área HTML onde você adicionou o código.
Ativar sistema de cache local de tradução
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
Configurações específicas para OpenCart CMS
No arquivo Configuration.php também temos uma configuração que permite passar algumas configurações específicas para o CMS. Por padrão, é automático, mas a equipe de suporte pode solicitar que você o personalize para usar algumas configurações especiais.
Aqui está o código a ser adicionado para OpenCart , este é o nome do CMS em letras minúsculas:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'opencart';
Do SQLite ao MySQL
Ainda no Configuration.php existe uma configuração para forçar o uso do MySQL ao invés do SQLite, caso o SQLite não esteja instalado no servidor.
Neste caso, você precisará preencher as informações do MySQL nesta parte do arquivo Configuration.php:
/** Advanced database configuration **/
/*
* In case you don't want to use Sqlite, you can use MySQL
* To do so, you need to fill the following variables
* Linguise will create the tables for you
*/
public static $db_host = '';
public static $db_user = '';
public static $db_password = '';
public static $db_name = '';
public static $db_prefix = '';
Tradução automática em servidores Windows IIS
Adicione a linha correspondente ao seu construtor de sites no arquivo Web.config.
Deve ser definido antes de qualquer outro redirecionamento, especialmente o redirecionamento para o arquivo principal do PHP:
Tradução automática em servidores NGINX
rewrite ^/(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 last;