Neste teremos mais detalhes sobre como realizar tradu\u00e7\u00f5es no Magento em diferentes cen\u00e1rios, e como preparar um m\u00f3dulo para tradu\u00e7\u00e3o.<\/p>\n\n\n\n
Aqui veremos:<\/p>\n\n\n\n
- Configurando o idioma de uma loja Magento<\/a><\/li>
- Arquivos de tradu\u00e7\u00e3o (dicion\u00e1rio)<\/a><\/li>
- Detectando um texto para traduzir<\/a><\/li>
- Preparando tradu\u00e7\u00f5es no meu m\u00f3dulo<\/a><\/li>
- Traduzindo m\u00f3dulo de terceiros \/ Tradu\u00e7\u00e3o no tema<\/a><\/li>
- Traduzindo e-mails transacionais<\/a><\/li>
- Tradu\u00e7\u00e3o inline (direto no browser)<\/a><\/li>
- Tradu\u00e7\u00e3o de produtos e categorias<\/a>
- Atributos de produtos<\/a><\/li><\/ul><\/li>
- Considera\u00e7\u00f5es e dicas<\/a>
- Leitura adicional<\/a><\/li><\/ul><\/li><\/ul><\/div>\n\n\n\n
Configurando o idioma de uma loja Magento<\/h2>\n\n\n\n
Antes de realizar qualquer tipo de tradu\u00e7\u00e3o, \u00e9 importante definirmos o idioma da nossa loja. Isso pode ser feito no n\u00edvel de vis\u00e3o de loja ou de forma global. <\/p>\n\n\n\n
Isto \u00e9 feito em Lojas -> Configura\u00e7\u00e3o -> Geral -> Localidade.<\/p>\n\n\n\n
Se sua \u00e1rea administrativa estiver em Ingl\u00eas, encontrar\u00e1 em Stores -> Configuration -> General -> Locale.<\/p>\n\n\n\n
![\"Op\u00e7\u00f5es](\"https:\/\/www.magenteiro.com\/blog\/wp-content\/uploads\/2021\/12\/image-6-700x189.png\")
<\/figure>\n\n\n\nLembre-se de limpar os caches de configura\u00e7\u00e3o e full page ap\u00f3s realizar esta altera\u00e7\u00e3o. <\/p>\n\n\n\n
PS: Esta e outras configura\u00e7\u00f5es s\u00e3o abordadas no curso de administra\u00e7\u00e3o de lojas Magento<\/a> aqui do Magenteiro.<\/p>\n\n\n\n
Arquivos de tradu\u00e7\u00e3o (dicion\u00e1rio)<\/h2>\n\n\n\n
A forma mais comum de se realizar tradu\u00e7\u00f5es no Magento \u00e9 com arquivos CSV. Estes arquivos podem estar presentes em pacotes de tradu\u00e7\u00e3o, m\u00f3dulos e\/ou temas. O magento sempre buscar\u00e1 pelo arquivo de tradu\u00e7\u00e3o no diret\u00f3rio
i18n<\/code> nestes componentes. Ex:<componente>\/i18n\/pt_BR.csv<\/code>.<\/p>\n\n\n\nVeja um exemplo de um trecho do arquivo de tradu\u00e7\u00e3o do pacote pt_BR:<\/p>\n\n\n\n
\"%1 product(s) have been added to shopping cart: %2.\",\"%1 produtos foram adicionados ao carrinho de compras: %2.\"\n\"Please reenter your search options.\",\"Por favor, digite novamente suas op\u00e7\u00f5es de busca.\"\n\"We could not perform the search.\",\"N\u00e3o foi poss\u00edvel realizar a pesquisa.\"\n\"Owner Name\",\"Nome do propriet\u00e1rio\"\n\"Owner Email\",\"E-mail do Propriet\u00e1rio\"\n\"%1's Wish List\",\"Lista de Desejos de %1\"\n\"%1's Wish List (%2)\",\"Lista de Desejos de %1 (%2)\"\n\"Sign in to edit wish lists.\",\"Inicie sess\u00e3o para editar listas de desejos.\"\n<\/pre>\n\n\n\n
Do lado esquerdo encontramos o texto como foi digitado no c\u00f3digo fonte(geralmente em Ingl\u00eas), e do lado direito o texto traduzido.<\/p>\n\n\n\n
Voc\u00ea pode gerar arquivos de tradu\u00e7\u00e3o \u00e0 partir do seu c\u00f3digo-fonte, ou criar pacotes de tradu\u00e7\u00e3o com alguns comandos, conforme mostrado na documenta\u00e7\u00e3o oficial<\/a>. No entanto, aqui mostraremos como fazer estas tradu\u00e7\u00f5es com um pacote de tradu\u00e7\u00e3o ou m\u00f3dulos existentes.<\/p>\n\n\n\n
Detectando um texto para traduzir<\/h2>\n\n\n\n
Existem mais de uma forma de se traduzir um termo ou frase no Magento. Mas antes de escolher uma (e falaremos delas), \u00e9 importante buscarmos onde est\u00e1 o termo que queremos traduzir.<\/p>\n\n\n\n
Para fazer isso, a forma mais simples \u00e9 realizando uma busca de parte do termo em toda base do Magento.<\/p>\n\n\n\n
Isso pode ser feito atrav\u00e9s da sua IDE ou do pr\u00f3prio terminal com o comando
grep<\/code>, como mostrado abaixo.<\/p>\n\n\n\ngrep -iR \"added to shopping cart\" \/pasta\/do\/magento<\/pre>\n\n\n\n
Isso lhe trar\u00e1 o nome do arquivo e linha onde o termo completo pode ser encontrado. Com este termo em m\u00e3os, podemos adicion\u00e1-lo ao nosso arquivo de tradu\u00e7\u00e3o (dicion\u00e1rio).<\/p>\n\n\n\n
Preparando tradu\u00e7\u00f5es no meu m\u00f3dulo<\/h2>\n\n\n\n
Arquivos de tradu\u00e7\u00e3o de m\u00f3dulos ficam localizados na
<pasta_do_modulo>\/i18n<\/code>. Se voc\u00ea est\u00e1 criando um m\u00f3dulo e pretende traduzi-lo, considere criar esta pasta com ao menos um arquivo de tradu\u00e7\u00e3o.<\/p>\n\n\n\nExemplo:
bin\/magento i18n:collect-phrases -o app\/code\/Magenteiro\/HandleDebugger\/i18n\/pt_BR.csv app\/code\/Magenteiro\/HandleDebugger<\/code><\/p>\n\n\n\nO comando acima percorrer\u00e1 os arquivos do m\u00f3dulo em busca de textos que passaram pelos m\u00e9todos de tradu\u00e7\u00e3o, e em seguida criar\u00e1 um arquivo com eles. <\/p>\n\n\n\n
No exemplo acima fizemos a chamada de
<?php echo __('Test Text') ?><\/code> em um arquivo de template. E isso gerou o arquivo de tradu\u00e7\u00e3o com uma linha para ser traduzido:<\/p>\n\n\n\n\"Test Text\",\"Test Text\"<\/code><\/pre>\n\n\n\nTraduzindo m\u00f3dulo de terceiros \/ Tradu\u00e7\u00e3o no tema<\/h2>\n\n\n\n
N\u00e3o \u00e9 recomendado que altere nenhum m\u00f3dulo de terceiros diretamente. Especialmente m\u00f3dulos do pr\u00f3prio Magento ou m\u00f3dulos localizados na pasta
\/vendor<\/code>.<\/p>\n\n\n\nNestes casos, podemos adicionar os termos dentro do arquivo do nosso pacote de tradu\u00e7\u00e3o ou no nosso tema.<\/p>\n\n\n\n
Isso mesmo. Nosso tema ou as customiza\u00e7\u00f5es que fizermos em um tema existente podem trazer tradu\u00e7\u00f5es de termos presentes em outros m\u00f3dulos.<\/p>\n\n\n\n
O caminho padr\u00e3o de tradu\u00e7\u00e3o de um tema \u00e9
<pasta_do_tema>\/i18n<\/code>.<\/p>\n\n\n\nTraduzindo e-mails transacionais<\/h2>\n\n\n\n
N\u00f3s j\u00e1 vimos aqui no Magenteiro como alterar e customizar pe\u00e7as de e-mail transacionais<\/a>. No entanto, os termos presentes nestes e-mails nem sempre est\u00e3o dispon\u00edveis nos dicion\u00e1rios.<\/p>\n\n\n\n
Voc\u00ea tamb\u00e9m n\u00e3o conseguir\u00e1 encontrar estes termos usando o comando grep mostrado acima caso o template de e-mail j\u00e1 tenha sido modificado. Nestes casos a modifica\u00e7\u00e3o \u00e9 salva no banco de dados e a busca n\u00e3o ter\u00e1 sucesso.<\/p>\n\n\n\n
No entanto, podemos modificar os termos do nosso e-mail transacional de forma a utilizar o conte\u00fado de dicion\u00e1rios. Fazemos isso com a diretiva
{{trans}}<\/code>. Veja dois exemplos:<\/p>\n\n\n\n{{trans \"Some simple text to be translated\"}}\n{{trans \"Thanks for your order number %orderNumber\" orderNumber=\"incrementId\"}}<\/pre>\n\n\n\nSe voc\u00ea est\u00e1 criando um novo arquivo de email transacional, pode usar esta diretiva desde o come\u00e7o. Caso esteja modificando um termo sem tradu\u00e7\u00e3o, poder\u00e1 adicion\u00e1-la conforme necess\u00e1rio, seguindo instru\u00e7\u00f5es do artigo acima.<\/p>\n\n\n\n
Tradu\u00e7\u00e3o inline (direto no browser)<\/h2>\n\n\n\n
A tradu\u00e7\u00e3o inline permite que alteremos textos diretamente no browser, sem a necessidade de editar arquivo algum. Al\u00e9m disso, ela pode ser ativada para traduzir termos tanto no frontend quanto no admin da loja.<\/p>\n\n\n\n
Particularmente n\u00e3o gosto desta abordagem, pois as tradu\u00e7\u00f5es s\u00e3o salvas diretamente no banco de dados. Isto torna a manuten\u00e7\u00e3o dos termos mais dif\u00edcil, uma vez que este tipo de tradu\u00e7\u00e3o s\u00f3 est\u00e1 dispon\u00edvel no modo desenvolvedor<\/a>. Al\u00e9m disso, perdemos o controle de vers\u00e3o e hist\u00f3rico – algo que geralmente temos ao trabalhar com arquivos.<\/p>\n\n\n\n
Para ativar a tradu\u00e7\u00e3o inline, tamb\u00e9m \u00e9 necess\u00e1rio desativar os caches de bloco, full page, e tradu\u00e7\u00e3o. Isso pode ser feito com o comando
bin\/magento cache:disable block_html full_page translate<\/code> ou no admin da loja.<\/p>\n\n\n\nEm seguida, habilite a tradu\u00e7\u00e3o inline em Avan\u00e7ado > Desenvolvedor > Tradu\u00e7\u00e3o em linha. L\u00e1, escolha onde deseja habilitar tal recurso (frontend ou admin).<\/p>\n\n\n\n
![\"Op\u00e7\u00f5es](\"https:\/\/www.magenteiro.com\/blog\/wp-content\/uploads\/2021\/12\/image-7-700x228.png\")
<\/figure>\n\n\n\nSe preferir, use a linha de comando:<\/p>\n\n\n\n
bin\/magento config:set dev\/translate_inline\/active_admin 1<\/code> – para admin<\/li>bin\/magento config:set dev\/translate_inline\/active 1<\/code> – para frontend<\/li><\/ul>\n\n\n\nAo habilitar tal recurso, todos os textos pass\u00edveis de tradu\u00e7\u00e3o aparecer\u00e3o com uma demarca\u00e7\u00e3o ao seu redor. Ao clicar no \u00edcone de dicion\u00e1rio, um di\u00e1logo lhe permitir\u00e1 realizar a tradu\u00e7\u00e3o como desejar.<\/p>\n\n\n\n
- Considera\u00e7\u00f5es e dicas<\/a>
- Arquivos de tradu\u00e7\u00e3o (dicion\u00e1rio)<\/a><\/li>