[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Localização

As traduções do Commerce permitem personalizar e localizar sua loja para várias regiões e mercados gerando:

Consulte Visão geral das traduções.

Gerar um dicionário de tradução

Você pode gerar um dicionário de tradução para personalizar cadeias de caracteres existentes, traduzir palavras e frases em um módulo personalizado, localizar um tema ou criar pacotes de idioma.

Para começar a traduzir, use um comando para gerar um arquivo CSV de dicionário com uma lista coletada de todas as frases e palavras existentes.

Para gerar o dicionário e iniciar a tradução:

Opções de comando:

bin/magento i18n:collect-phrases [-o|--output="<csv file path and name>"] [-m|--magento] <path to directory to translate>

A tabela a seguir explica os parâmetros e valores:

Diretrizes de tradução

Use as diretrizes a seguir ao traduzir palavras e frases:

O Commerce usa os espaços reservados para inserir valores de contexto; eles são não usados para traduções. Por exemplo:

Product '%1' has been added to shopping cart.

Preenche com um valor:

Product 'Multimeter-2000' has been added to shopping cart.

A frase resultante deve conter pelo menos um de cada espaço reservado. Por exemplo, suponha que haja espaços reservados de %1 a %3 na frase original. A tradução pode ter tantos espaços reservados em qualquer ordem, mas deve haver pelo menos uma ocorrência de %1, %2 e %3. A conversão não pode conter valores de espaços reservados que não estejam presentes no valor original (por exemplo, %4, %5 e assim por diante).

Um exemplo de tradução de uma frase:

"Buy %1 for %2 (%3 incl. tax) each","Compre %1 por %2 (%3 incl. imposto) cada"

Criar um pacote de idiomas

Ao contrário de um dicionário de tradução, é possível traduzir qualquer uma ou todas as palavras e frases no aplicativo do Commerce usando um pacote de idiomas. Você pode traduzir um componente específico, como um módulo ou um tema, usando um dicionário de tradução. Saiba mais sobre pacotes de idiomas.

Esta seção discute como criar um pacote de linguagem, que grava arquivos CSV em módulos e temas. Para criar um pacote de idioma, você deve executar as tarefas discutidas nas seguintes seções:

Execute o comando de pacote de idioma

Uso do comando:

bin/magento i18n:pack [-m|--mode={merge|replace}] [-d|--allow-duplicates] <source> <locale>

A tabela a seguir explica os parâmetros e valores do comando de pacote de idioma:

Criar diretórios e arquivos

Os pacotes de idiomas estão localizados em um diretório em app/i18n/<VendorName> no sistema de arquivos do Commerce com o seguinte conteúdo:

Para criar esses arquivos:

Pacote de idioma language.xml

Ao declarar um pacote de idioma no arquivo de configuração language.xml, você deve especificar a sequência da herança de idioma para esse pacote.

A herança de idioma permite criar uma tradução chamada filho com base em uma tradução existente chamada pai. As traduções secundárias substituem as principais. No entanto, se a tradução secundária não fizer upload ou exibir uma frase ou palavra, o Commerce usará o local principal. Exemplos de herança de pacote de idioma.

Para declarar um pacote, especifique as seguintes informações:

<?xml version="1.0"?>
<language xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/Language/package.xsd">
    <code>en_GB</code>
    <vendor>magento</vendor>
    <package>en_gb</package>
    <sort_order>100</sort_order>
    <use vendor="oxford-university" package="en_us"/>
</language>

Onde:

Se necessário, é possível especificar vários pacotes principais. Os pacotes principais são aplicados em uma base listada pela primeira vez e usada.

Exemplo de herança de linguagem

Suponha que um pacote de idioma herde de dois outros pacotes e que esses pacotes também tenham pacotes pai e "avô".

Se um pacote de linguagem herda de dois pacotes, seu language.xml pode ser semelhante ao seguinte:

<language xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/Language/package.xsd">
    <code>en_GB</code>
    <vendor>magento</vendor>
    <package>language_pack</package>
    <sort_order>100</sort_order>
    <use vendor="parent-package-one" package="language_package_one"/>
    <use vendor= "parent-package-two" package="language_package_two"/>
</language>

No exemplo anterior:

Se o aplicativo Commerce não puder encontrar a palavra ou frase no pacote en_GB, ele procurará em outros pacotes na seguinte sequência:

Especificar todas as heranças entre os pacotes de idioma pode resultar na criação de cadeias de herança circulares. Use o teste Magento\Test\Integrity\App\Language\CircularDependencyTest para localizar e corrigir essas cadeias.

Configurar vários pacotes para um idioma

Para tornar sua loja mais flexível, você pode carregar vários pacotes de idiomas para o mesmo idioma na loja. Assim, você pode usar diferentes pacotes personalizados para diferentes partes da loja, pois o sistema compila um único pacote de todos os pacotes que estão disponíveis para uma linguagem.

Para ativar um pacote adicional para um idioma existente, nomeie o novo pacote com qualquer nome, exceto para um nome de código de idioma existente (para evitar confusão). Especifique as configurações de um pacote no arquivo de metainformações language.xml do pacote de idioma, conforme discutido na próxima seção.

Exemplos de uso de comandos de tradução

As seções a seguir fornecem exemplos completos do uso dos comandos discutidos neste tópico para criar dicionários de tradução e pacotes de tradução:

Exemplo: criar um dicionário de tradução para um módulo ou tema

Para adicionar uma tradução em alemão a um módulo ou tema que deseja distribuir para outros comerciantes:

Exemplo: criar um pacote de idioma

Semelhante ao exemplo anterior, gere um arquivo CSV, mas em vez de especificar um módulo ou diretório de tema, especifique todo o diretório raiz do aplicativo Commerce. O CSV resultante contém qualquer frase que o comando possa encontrar no código.