Sítios multilingues

Introdução

Se tiver um sítio multilingue, pode exibir os rótulos e descrições de campos e grupos de campos no idioma do utilizador. Para tal:

1. Defina o Título e a Descrição do seu grupo de campos como constantes de idioma.
2. Defina o Rótulo e a Descrição do seu campo como constantes de idioma.
3. Configure essas constantes de idioma como sobreposições para cada um dos seus idiomas.

No exemplo seguinte, é criado um grupo de campos e um campo de Contacto para as preferências pessoais de um contacto. O grupo de campos é denominado Favoritos e o campo de exemplo é denominado Carro. Claramente, podem ser adicionados mais campos para outras coisas favoritas, como comida ou filmes.

Para seguir este exemplo, assume-se que já configurou um sítio multilingue conforme descrito no tutorial de configuração Sítios multilingues.

Constantes de idioma

As constantes de idioma são marcadores de posição que são substituídos por valores de idioma quando uma página é apresentada. As constantes e os seus valores são armazenados em ficheiros de idioma, como JPATH_SITE/languages/en-GB/com_contact.ini e JPATH_SITE/administrator/languages/en-GB/com_contact.ini, para a área de visitantes e área administrativa respetivamente. Por convenção, a maioria das constantes de idioma começa com o nome da extensão todo em maiúsculas, por exemplo COM_CONTACT_...

As sobreposições de idioma são substituições definidas pelo utilizador para constantes e valores de idioma existentes ou constantes e valores inteiramente novos, como neste exemplo. Todas são armazenadas em ficheiros únicos, um para as páginas do Sítio e outro para as páginas do Administrador:

SITE_ROOT/language/overrides/en-GB.override.ini
SITE_ROOT/administrator/language/overrides/en-GB.override.ini

É importante tornar as novas constantes de idioma definidas pelo utilizador únicas, para evitar sobrepor constantes existentes. Por exemplo:

COM_CONTACT_CUSTOM_FIELDGROUP_FAVOURITES="Favoritos" COM_CONTACT_CUSTOM_FIELDGROUP_FAVOURITES_DESCRIPTION="Carro, filme, etc. favorito" COM_CONTACT_CUSTOM_FIELD_FAVOURITE_CAR="Carro favorito" COM_CONTACT_CUSTOM_FIELD_FAVOURITE_CAR_DESCRIPTION="Por vezes usado como pergunta de segurança"

Se houver algo de errado com a sintaxe de um ficheiro de idioma, este não será carregado e todas as constantes nele poderão aparecer nas páginas de saída. E note que um ficheiro é ordenado por ordem alfabética.

Definir as sobreposições

É importante criar sobreposições em inglês (GB). O Joomla carrega primeiro os ficheiros de tradução en-GB e, em seguida, substitui os valores com um ficheiro de idioma selecionado. Isto garante que os utilizadores nunca deverão ver uma constante de texto. Se um valor traduzido estiver em falta, o inglês aparecerá na saída. Isto parece estranho, mas é melhor do que ver uma constante bastante longa que normalmente perturba os esquemas.

No menu do Administrador:

• Selecione Sistema / Painel de gestão / Sobreposições de idioma
• Selecione Inglês (Reino Unido) — Sítio na lista Selecionar idioma e cliente
• Selecione o botão Novo na barra de ferramentas.
• No campo Constante de idioma, introduza COM_CONTACT_CUSTOM_FIELDGROUP_FAVOURITES
• No campo Texto, introduza o valor Favoritos
• Assinale a caixa de verificação Para ambas as localizações. Isto fará com que sejam criadas sobreposições tanto para as páginas do Sítio como do Administrador.
• Selecione Guardar e novo na lista pendente Guardar e fechar.
• Repita para cada uma das outras constantes necessárias.
• Selecione Fechar após a última entrada ter sido guardada.
• Repita para cada um dos idiomas instalados.

A captura de ecrã seguinte mostra um exemplo de criação de sobreposição para uma constante de idioma em alemão.

Definir o grupo de campos

No menu Administrador:

• Selecione o item de menu Componentes / Contactos / Grupos de campos.
• Selecione o botão Novo na barra de ferramentas.
• No campo Título insira a constante COM_CONTACT_CUSTOM_FIELDGROUP_FAVOURITES
• No campo Descrição insira a constante COM_CONTACT_CUSTOM_FIELDGROUP_FAVOURITES_DESCRIPTION
• Selecione Guardar e fechar na barra de ferramentas.

Definir o campo

Para selecionar um carro favorito, poderia fornecer uma lista pendente de carros que define, ou uma lista pendente de carros obtida de uma tabela da base de dados, ou uma lista de botões de rádio com rótulos que define. Neste caso, um simples campo de entrada de texto permitirá a introdução de qualquer marca e modelo de carro de toda a história mundial da indústria automóvel.

No menu Administrador:

• Selecione o item de menu Componentes / Contactos / Campos.
• Selecione o botão Novo na barra de ferramentas.
• No campo Título insira a constante COM_CONTACT_CUSTOM_FIELD_FAVOURITE_CAR
• No campo Tipo selecione Texto (text) caso ainda não esteja selecionado.
• No campo Descrição insira a constante COM_CONTACT_CUSTOM_FIELD_FAVOURITE_CAR_DESCRIPTION
• No campo Grupo de campos (à direita), selecione o Grupo de campos que criou.
• Selecione Guardar e fechar na barra de ferramentas.

Editar um contacto

Com o inglês selecionado antes da autenticação no Administrador, o formulário de introdução de dados do Contacto deverá conter um separador com o nome em inglês do seu grupo de campos e campos desse grupo também com valores em inglês.

Com o alemão selecionado antes da autenticação no Administrador, deverá ver as traduções alemãs das suas constantes de idioma:

Aviso: tradução feita pelo translate.google.co.uk!

Exibir um contacto

Em inglês:

E em alemão: