Cada módulo pode ter arquivos de idioma separados para evitar confusão com os arquivos de idioma do sistema.

Para adicionar arquivos de idioma ao seu módulo para que os usuários possam traduzi-lo, você deve criar uma pasta em módulos/[nome_do_módulo]/idioma/[pasta_nome_do_idioma]

Neste momento, a [pasta_nome_do_idioma] deve existir nos arquivos de idioma principais, localizados em aplicativo/idioma.

Por exemplo, se você deseja criar traduções para o inglês, crie a(s) seguinte(s) pasta(s): /módulos/[nome_do_módulo]/idioma/inglês

Arquivos de idioma

Em cada idioma, você pode criar um número ilimitado de arquivos, por exemplo, se desejar separar arquivos de idioma com recursos específicos, ou pode incluí-los em um arquivo de idioma geral.

O nome do arquivo deve terminar com _lang.php. Consulte a documentação do framework Codeigniter para obter mais informações sobre o nome do arquivo de idioma e seu uso.

Neste exemplo, criaremos o arquivo sample_module_lang.php em /modules/[nome_do_módulo]/idioma/inglês/

Para cada idioma adicional que você deseja traduzir, você deve incluir todos os arquivos do seu arquivo de idioma geral, por exemplo, neste caso, inglês.

Por exemplo, se você tiver 3 arquivos de idioma na pasta /inglês e quiser incluir um novo idioma espanhol, você deve criar uma nova pasta para o idioma espanhol e copiar esses 3 arquivos de idioma para a pasta /espanhol.

Registrando arquivos de idioma

Em vez de carregar os arquivos de idioma diretamente, há uma função auxiliar para registrar os arquivos de idioma e permitir que seu idioma suporte o uso de um arquivo custom_lang.php para que os usuários finais possam substituir as traduções.

Mais informações sobre o arquivo custom_lang.php no diretório de idiomas podem ser encontradas aqui.

No arquivo init do seu módulo, adicione o seguinte código:

O primeiro parâmetro da função register_language_files é o nome do módulo. Não se esqueça de substituir module_name pelo nome real do seu módulo.

O segundo parâmetro deve ser um array com os nomes dos arquivos de idioma sem o _lang.php.

Buscando uma linha de texto

Em vez de usar o método padrão do framework Codeigniter para buscar a linha de texto traduzida, você pode usar a função personalizada GrowCRM:

Conflitos

Certifique-se de que as chaves de idioma adicionadas nos arquivos de idioma não entrem em conflito com as chaves de idioma do GrowCRM adicionadas em application/language ou com quaisquer outros módulos.

Por esse motivo, recomendamos adicionar chaves de idioma exclusivas ou prefixá-las com o nome do seu módulo.