Editando Idiomas Existentes ou Adicionando um Novo

Pré-requisitos Importantes para Personalização de Idioma:

Modificar o código padrão do eDirectory, incluindo seus arquivos de idioma, requer uma licença própria e um forte entendimento das tecnologias de desenvolvimento web. Isso inclui proficiência em PHP, CSS, MySQL e no sistema operacional Linux. Esteja ciente de que o suporte do eDirectory não pode fornecer assistência ou solução de problemas para personalizações de código. No entanto, nosso Time Customização de Código está disponível para consultas se você precisar de assistência especializada. Crucialmente, sempre crie um backup completo de sua instalação do eDirectory antes de fazer qualquer alteração no código.

O eDirectory inclui suporte de idioma integrado para: inglês, português brasileiro, francês, espanhol, italiano, turco e alemão.

1. Editando Traduções para um Idioma Existente:

Para modificar o texto usado para um idioma existente em seu site eDirectory, recomendamos a seguinte abordagem:

Cada idioma suportado utiliza um conjunto de arquivos de tradução. Esses arquivos estão localizados principalmente dentro do diretório edirectory/web/lang.

Por exemplo, as traduções para a língua turca podem ser encontradas nestes arquivos:

/lang/tr_tr.php (Arquivo principal de tradução para o front-end)
/lang/tr_tr_sitemgr.php (Traduções específicas para a área administrativa do site)
/lang/tr_tr.js (Traduções usadas dentro de funções JavaScript no site)

Além desses arquivos principais, outras strings traduzíveis estão localizadas no diretório edirectory/app/Resources/translations .

Novamente, usando a língua turca como exemplo, estes arquivos contêm traduções adicionais:

account.tr.xliff
administrator.tr.xliff
advertise.tr.xlf
consent.tr.xliff
filters.tr.xliff
gregwar_captcha.tr.xliff
messages.tr.xliff
recurring.tr.xlf
system.tr.xliff
units.tr.xlf
validators.tr.xliff
widgets.tr.xliff

Após fazer as edições necessárias nas traduções dentro dos arquivos .xliff e .xlf , você deve limpar o cache do eDirectory para que as mudanças tenham efeito. Navegue até o diretório raiz da sua instalação do eDirectory (/edirectory/ ) através da linha de comando do seu servidor e execute o seguinte comando:

Bash

php -d memory_limit=-1 app/console cache:clear --env=prod

Seguindo estas etapas, você pode modificar com sucesso as traduções para qualquer um dos idiomas padrão incluídos com o eDirectory (inglês, português brasileiro, francês, espanhol, italiano, turco e alemão).

2. Adicionando Suporte para um Novo Idioma:

O método mais simples para adicionar suporte a um idioma não incluído por padrão é reutilizar os arquivos de idioma de um idioma que você não está utilizando atualmente. Isso envolve substituir as traduções existentes nesses arquivos pelas traduções do seu novo idioma. É essencial traduzir todos os arquivos mencionados na seção anterior.

Por exemplo, se você escolher substituir o suporte ao idioma turco pelo seu novo idioma, você deve traduzir o conteúdo destes arquivos:

Arquivos PHP e JavaScript:

/lang/tr_tr.php
/lang/tr_tr_sitemgr.php
/lang/tr_tr.js

Arquivos XLIFF e XLF:

account.tr.xliff
administrator.tr.xliff
advertise.tr.xlf
consent.tr.xliff
filters.tr.xliff
gregwar_captcha.tr.xliff
messages.tr.xliff
recurring.tr.xlf
system.tr.xliff
units.tr.xlf
validators.tr.xliff
widgets.tr.xliff

Para ilustrar, se você não estiver utilizando o idioma turco, pode modificar o conteúdo dos arquivos de idioma turco para conter as traduções do idioma desejado. Após ter traduzido todos os arquivos necessários, navegue até Idioma & Localidades > Configurações de Idioma dentro da área administrativa do seu site eDirectory e selecione Turco (ou qual quer que seja o idioma que você escolheu substituir). Seu novo idioma adicionado estará então ativo em seu site.

Limitação Importante: Convenção de Nomenclatura de Arquivos:

Observe que, embora você possa editar o conteúdo dos arquivos de idioma, você não pode alterar seus nomes. Usando o exemplo em turco, você pode substituir as traduções em turco dentro dos arquivos tr_tr.php , tr_tr_sitemgr.php , tr_tr.js e os arquivos .tr.xliff /.tr.xlf com as traduções do seu próprio idioma. No entanto, você deve manter os nomes originais dos arquivos (por exemplo, tr_tr.php , account.tr.xliff ).

Considerações Importantes para Suporte a Idiomas:

Orientação de Idiomas da Esquerda para a Direita: o design central do eDirectory é otimizado para idiomas da esquerda para a direita, como o inglês. Implementar suporte para idiomas da direita para a esquerda pode resultar em inconsistências de layout e exigir modificações significativas no CSS, o que está além do escopo do suporte padrão do eDirectory.
Codificação de Caracteres UTF-8: o eDirectory é desenvolvido usando o conjunto de caracteres UTF-8. Usar outras codificações de caracteres pode levar a comportamentos inesperados do sistema e problemas de exibição. Certifique-se de que suas traduções e a codificação dos arquivos estejam em UTF-8.

(Aplicável para versões do eDirectory 13.4 e abaixo)