Como funciona
A exportação em CSV lista todos os textos da loja do idioma selecionado, do player de curso à página de agradecimento do checkout, à página de status do pedido e a Meus cursos, com a redação padrão e o seu texto atual. Você preenche a coluna your text e importa o arquivo no mesmo idioma. Células em branco não mudam nada, e uma importação nunca apaga textos.
As colunas do CSV
Toda exportação tem as mesmas quatro colunas, nesta ordem:
| Coluna | O que ela contém | Na importação |
|---|---|---|
locale |
O idioma: all para Todos os idiomas, ou um código como fr, de ou pt-BR. Todas as linhas têm o mesmo valor. |
Deve corresponder ao idioma selecionado no editor. |
key |
O ID do texto, o mesmo código cinza exibido abaixo de cada campo no editor, como homePage.title. |
Deve ser um texto listado pelo editor. Não o altere. |
default text |
A redação integrada desse idioma, ou o inglês para Todos os idiomas. | Ignorada. Está lá apenas para referência. |
your text |
A sua redação atual, ou em branco se você não alterou esse texto. | Em branco mantém o texto atual. Qualquer outra coisa o substitui. |
Como traduzir os textos da loja com um CSV
1. Selecione o idioma
Abra o editor de textos da loja e escolha o idioma no menu Idioma, por exemplo francês. A exportação e a importação usam o idioma selecionado.
2. Exporte o CSV
Clique em Exportar → Exportar como CSV (planilha). O Alva Courses baixa um arquivo com o nome do código do idioma, como storefront-text-fr.csv, ou storefront-text-all.csv para Todos os idiomas. O arquivo contém apenas os seus textos salvos, não as edições não salvas.
3. Preencha a coluna your text
Abra o arquivo em um aplicativo de planilhas e digite cada nova redação na coluna your text. Mantenha as células de locale e key como estão, mantenha marcadores como {{count}} e deixe uma célula em branco para manter o texto atual.
4. Salve como CSV
Salve o arquivo como CSV, com vírgulas entre as colunas. Escolha CSV UTF-8 quando o seu aplicativo oferecer, para que caracteres acentuados e não latinos sobrevivam. Não adicione colunas e não remova nem renomeie as colunas locale, key ou your text.
5. Importe e confira a visualização
No editor, com o mesmo idioma selecionado, clique em Importar e depois em Escolher arquivo. O Alva Courses verifica o arquivo e mostra o idioma para o qual vai importar, quantos textos foram alterados e quantos ficaram sem alteração, e cada mudança da redação antiga para a nova.
6. Confirme a importação
Clique no botão Importar que informa o número de textos, como Importar 42 textos. O texto é salvo na hora, sem a etapa da barra de salvamento, e aparece no próximo carregamento de página da loja.
Regras de importação
- Um idioma por arquivo. Se o idioma do arquivo for diferente do selecionado, o Alva Courses cita os dois e não importa nada. Selecione o idioma do arquivo e tente de novo.
- Tudo ou nada. Se alguma linha tiver um problema, nada é importado, e cada problema é listado com o número da linha. O cabeçalho é a linha 1, como na sua planilha.
- As regras de texto do editor se aplicam. Cada texto pode ter até 500 caracteres, não pode conter
<nem>e só pode usar os marcadores que o texto padrão usa. - Arquivos de até 1 MB, no formato
.csvou.json. - A importação nunca exclui. Para remover um texto, use os botões de redefinição no editor e depois salve.
Em Todos os idiomas, a visualização lista separadamente qualquer texto que você definiu em Personalizar login e que o arquivo alteraria, porque esse texto aparece em todos os idiomas.
Dicas para planilhas
Textos que começam com =, +, - ou @ são exportados com um apóstrofo na frente, para que as planilhas não os leiam como fórmula. A importação remove esse apóstrofo de novo. As linhas com a célula your text em branco são ignoradas, então você pode traduzir alguns textos por vez e importar quantas vezes quiser.
Exporte como JSON para um backup
Exportar → Exportar como JSON baixa apenas o texto que você personalizou para o idioma selecionado. É um backup rápido antes de uma grande redefinição, e Importar o aceita da mesma forma que um CSV.
Perguntas frequentes
Um arquivo pode conter vários idiomas?
Não. Cada arquivo contém um idioma, e todas as linhas devem ter o mesmo locale. Exporte e importe cada idioma separadamente, selecionando-o antes no menu Idioma.
Como removo um texto com uma importação?
Não é possível. Uma célula em branco mantém o texto atual, e a importação nunca exclui. Para voltar ao padrão, use Redefinir para o padrão, Redefinir este grupo ou o botão de redefinir tudo no editor e depois salve.
Por que nada foi importado?
As importações são tudo ou nada. Se alguma linha tiver um problema, como uma chave desconhecida, um idioma diferente, um texto com mais de 500 caracteres ou um marcador que o texto não pode usar, o Alva Courses lista cada problema com o número da linha e não importa nada. Corrija o arquivo e importe de novo.
O CSV inclui os textos de checkout e de conta do cliente?
Sim. A exportação lista os textos da página de agradecimento do checkout, da página de status do pedido e de Meus cursos depois dos textos do player de curso. As chaves deles começam com ext., como ext.membersArea.page_title para o título da página Meus cursos.
Veja também
Esta página foi útil?
Última atualização 2026-10-08