Alterar strings no código

Na versão II da plataforma Badiu.Net, a estrutura de strings foi totalmente integrada ao banco de dados, permitindo alterações via interface gráfica, como abordado nos itens anteriores. Contudo, podem ocorrer situações em que seja necessário alterar strings diretamente no pacote de idioma ou no código, especialmente quando estas não seguem o padrão de impressão de strings. Nesta seção, exploraremos a organização dos arquivos do pacote de idiomas e as possibilidades de edição diretamente nesses arquivos. Clique aqui para acessar a documentação sobre  de gestão do pacote de idiomas

1 -  Estrutura do pacote de idiomas

Cada módulo do sistema possui um pacote de idiomas específico, localizado na pasta /Resources/translations. Nesta pasta, encontram-se os arquivos com as strings de idioma. Por exemplo, o pacote de strings do módulo de gestão de usuários pode ser encontrado no seguinte caminho:
BADIUNET_DIR_INSTALL/Badiu/System/UserBundle/Resources/translations/messages.pt.yml

O conteúdo das strings nesses arquivos segue o formato YAML de chave e valor, como demonstrado na figura a seguir:

chave_da_string: "Texto correspondente em português"

Caso seja necessário ajustar diretamente o pacote de idiomas, basta localizar o arquivo correspondente e editá-lo. A edição deve ser realizada apenas no valor (parte após os dois pontos) e não na chave. O formato padrão YAML (chave: valor) deve ser respeitado.

2 -  Alterar textos que não seguem o padrão do sistema

Este item aborda como localizar e substituir textos que não seguem o padrão do pacote de idiomas, geralmente encontrados diretamente nos arquivos de programação PHP ou em templates de temas.

Para localizar o texto exibido na interface e que precisa ser alterado, uma boa alternativa é usar comandos de busca no sistema operacional. O comando abaixo exemplifica como localizar textos no sistema Linux:

grep -rli "texto_a_ser_localizado" /caminho/para/pasta

Neste comando:

• Substitua "texto_a_ser_localizado" pelo texto que você deseja encontrar.
• Ajuste /caminho/para/pasta para o local onde a plataforma Badiu.Net está instalada, geralmente indicado por BADIUNET_DIR_INSTALL.

O comando retornará uma lista de arquivos que contêm o texto buscado. Caso o texto esteja em um arquivo do padrão messages.pt.yml (ou equivalente), a alteração deverá ser realizada nesse arquivo. No entanto, se o texto estiver em outros arquivos que não seguem o padrão de idiomas, isso indica que ele não foi devidamente registrado no pacote de idiomas e precisará ser ajustado manualmente.

Na nova versão, todos os módulos que fazem parte do core do sistema foram padronizados para registrar strings no banco de dados. No entanto, as alternativas apresentadas acima continuam válidas para versões anteriores ou para casos específicos em que o padrão não seja seguido.