Índice
Requisitos técnicos Concrete CMS
A tradução automática neural para uso com Concrete CMS requer o script PHP (disponível para download abaixo). Para instalar o script Linguise , você precisará dos seguintes requisitos:
- Execute PHP 7.3 ou superior
- Apache, servidor IIS, NGINX
- Certifique-se de que a reescrita de URLs esteja ativada em seu servidor
- Concrete CMS 9 e superior
1. Gere a chave da API
Após conectar-se ou registrar-se no painel de controle Linguise , você precisará configurar um novo domínio e salvar suas configurações para obter a chave da API.
Você pode selecionar a plataforma “Outro PHP” para prosseguir com o registro de domínio Linguise , conforme esta documentação, e os idiomas de origem e destino.
Depois disso, você receberá:
- A chave da API que valida sua assinatura
- O link para o script Linguise do seletor de idiomas
A chave da API é necessária para ativar a tradução no seu site Concrete CMS . Basicamente, a chave da API verifica qual idioma está ativado no seu domínio e permite a tradução automática do conteúdo.
Por enquanto, você pode copiar a chave da API e mantê-la na sua área de transferência.
2. Carregue e conecte o script de tradução Linguise
O script de tradução Linguise precisa ser carregado no servidor onde Concrete CMS está instalado. Faça o download aqui.
Após baixar o script, descompacte-o e carregue-o na pasta raiz onde o Concrete CMS está instalado.
- Certifique-se de que ele esteja localizado na raiz do seu site (onde estão os arquivos Concrete CMS
- 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.
3. Configure a reescrita de URLs Concrete CMS
Por padrão, a reescrita de URLs está ativa no Concrete CMS. Caso contrário, você pode ativá-la junto ao seu provedor de hospedagem.
A URL por idioma precisa ser configurada no arquivo .htaccess. Basta copiar o código abaixo após o código “ RewriteEngine on ” , disponível no Concrete CMS .htaccess.
<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]
</IfModule>
Por fim , seu Concrete CMS deve ter uma aparência semelhante a esta:
<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)(?:$|/)(.*)$ /concretee/linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME}/index.html !-f
RewriteCond %{REQUEST_FILENAME}/index.php !-f
RewriteRule . /concretee/index.php [L]
</IfModule>
Agora você pode carregar todas as suas páginas traduzidas usando a URL, por exemplo: www.concretewebsite.com/fr/
Vamos agora carregar o seletor de idiomas.
4. Ative o seletor de idiomas
4.1 Carregar o script JS Linguise
O link do script Linguise JS precisa ser carregado em todas as suas páginas Concrete CMS para exibir o seletor de idiomas com sinalizadores e URLs alternativos nos seus cabeçalhos HTML (para fins de SEO).
Para copiar o link do script, no painel de controle Linguise , acesse as configurações do domínio e copie o link do script.
A maneira mais fácil de carregar esse código no Concrete CMS é adicioná-lo dentro do arquivo header.php . código.
Você pode configurar isso seguindo estes passos: Acesse o painel de administração e, em seguida, no lado direito, vá para Sistema e Configurações > SEO e Estatísticas > Códigos de Rastreamento . Por padrão, você pode usar este método.
No entanto, se você estiver usando um tema diferente do padrão, precisará inserir o código no arquivo header.php pasta de temas do seu site CMS .
Edite o arquivo de script para incluir o link do script na seção de cabeçalho, como abaixo.
O seletor de idiomas será exibido por padrão em uma posição flutuante no canto superior direito do seu site. Você pode personalizá-lo conforme explicado no próximo capítulo.
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), os mecanismos de busca podem 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, dropdown ou popup
- A posição do seletor de idioma
- O conteúdo do alternador 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 Concrete CMS
Para exibir o seletor de idiomas em um local específico no Concrete CMS , você deve definir a posição como "No local".
Depois de definir a posição no Linguise , você pode adicionar o código curto 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.
Ative a opção de cache local do sistema
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.
Para complementar isso, 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
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;
Tradução automática em servidores Windows IIS
Adicione a linha correspondente ao seu construtor de sites no seu arquivo Web.config.
Ela deve ser configurada antes de qualquer outro redirecionamento, especialmente o redirecionamento para o seu arquivo PHP principal:
<rule name="Linguise" stopProcessing="true">
<match url="^(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)(?:$|/)(.*)$" ignoreCase="false" />
<conditions logicalGrouping="MatchAll" trackAllCaptures="false" />
<action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" />
</rule>
Do SQLite ao MySQL
Ainda no arquivo Configuration.php existe uma configuração para forçar o uso do MySQL em vez do SQLite, caso o SQLite não esteja instalado no servidor.
Nesse 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 = '';