Um site Velk pode responder em vários idiomas. Você escolhe o idioma principal, o padrão, e adiciona os outros no painel. Cada idioma extra ganha um prefixo no endereço (/en, /es), cada editor do painel ganha uma aba por idioma, e os textos fixos do tema — botões, rótulos, “Leia mais” — ganham uma tela de tradução própria.
Use quando o mesmo site atende gente que fala mais de uma língua: uma pousada com hóspedes estrangeiros, uma escola com programa em inglês, uma empresa que vende para a América Latina. Faz parte do motor: não há nada para instalar.
Peça à IA
Deixa o site da Pousada Mar Azul bilíngue. O português é o idioma principal, com o nome “Português”; o inglês vem em seguida, em /en. Prepara todos os textos fixos do tema (botões, rótulos, rodapé, mensagens dos formulários) para tradução e põe um seletor de idioma no cabeçalho. Não precisa traduzir os quartos nem os posts do blog: a dona da pousada faz isso no painel. Roda o schema:validate no fim e me diz o que eu preciso preencher.
A IA liga os idiomas no site.json, prepara os textos do tema e monta o seletor. O inglês em si você cadastra na tela Idiomas do painel, e as traduções também são digitadas no painel.
Como funciona a configuração
-
O idioma principal fica no tema
A IA liga os idiomas no
site.jsoncom o código do idioma principal e o nome que o visitante vê para ele (default_label: “Português”, “PT”). Oschema:validaterecusa o bloco sem esse nome. O painel não troca o idioma principal: é para ele que todo campo sem tradução volta. -
Os outros idiomas entram pelo painel
Em Configurações, abra Idiomas e clique em “+ Novo idioma”: o código (
en,es), o nome que aparece no seletor, o prefixo do endereço (/en), a ordem de exibição e se o idioma está ativo no site público. -
Os textos do tema são preparados
A IA envolve cada texto fixo dos templates em
t(), a função de tradução do tema, escrito no idioma principal. Oi18n:scancadastra esses textos na tela de tradução. -
Seletor e tags para os buscadores
O Velk não vem com seletor de idioma: a IA monta um no tema a partir dos idiomas ativos. Ela também põe em cada página as tags
hreflang, que dizem aos buscadores qual endereço é a tradução de qual.
Traduzindo o conteúdo
Com os idiomas ligados, todo editor — páginas, posts e outros conteúdos, categorias e tags, páginas de opções — mostra uma aba por idioma no topo. A primeira é o idioma principal; as outras repetem os mesmos campos, com o texto principal aparecendo como dica. Um Salvar grava todos os idiomas, e uma bolinha verde marca as abas que já têm conteúdo.
- Cada aba tem título, endereço e campos próprios. O endereço traduzido (slug) é digitado à mão: o Velk não gera a partir do título traduzido.
- Campo em branco quer dizer “sem tradução” e mostra o texto do idioma principal. Desde a v3.9.0 isso vale também para o campo de texto formatado deixado vazio, que antes imprimia um parágrafo vazio na página traduzida.
- Obrigatório é obrigatório uma vez só. Um campo obrigatório pede valor só na aba principal (desde a v3.7.4).
- O endereço da seção se traduz pelo botão Traduções da lista de um conteúdo ou de uma categoria:
/blogpode virar/en/news. - Conteúdo novo não perde as abas. Desde a v3.9.0, o que você digita nas outras abas de um post novo é gravado já no primeiro salvamento.
Um endereço por idioma
| Situação | Endereço |
|---|---|
| Idioma principal | /sobre, /blog/meu-post — sem prefixo |
| Inglês, ainda sem endereço em inglês | /en/sobre — a página abre no endereço principal, sob o prefixo (desde a v3.9.0; antes, dava 404) |
| Endereço em inglês preenchido | /en/about — e /en/sobre deixa de responder, então cada página tem um endereço por idioma |
| Dois conteúdos querem o mesmo endereço | Fica com quem teve o endereço traduzido, e um publicado sempre ganha de um rascunho. O painel avisa ao salvar e diz quem ficou sem endereço naquele idioma (desde a v3.9.0). |
No site
O seletor leva o visitante para a mesma página no outro idioma. O sitemap.xml lista todos os idiomas de cada endereço. Desde a v3.9.0 as tags canonical e hreflang não repetem mais o prefixo (/en/en/…), e o seletor funciona em posts e categorias aninhados em três níveis ou mais. As páginas de opções — textos do rodapé, contatos — também têm abas de idioma, e desde a v3.9.1 seguem o idioma do visitante, seja qual for o jeito como o tema as lê.
Os textos fixos do tema
Texto escrito nos templates é do tema, não do conteúdo. Ele é traduzido na tela Traduções de UI, aberta a partir de Idiomas: uma linha por texto, editada ali mesmo, com filtro para o que está pendente. O idioma principal sempre mostra o texto como o tema escreveu, então você só traduz para os idiomas extras. Desde a v3.7.8 isso vale também para o visitante em inglês: antes, um tema escrito em português mostrava português para quem estava em /en, ignorando a tradução cadastrada.
As mensagens dos formulários e da área de membros são palavras que o tema dá aos códigos que o Velk devolve, e podem passar por essa mesma tela.
Peça à IA
Em /en, o botão “Reservar” do cabeçalho e o “Siga a gente” do rodapé continuam em português. Deixa os dois traduzíveis e me mostra onde eu digito o inglês.
A IA envolve os dois textos em t(), roda o i18n:scan e aponta as linhas deles na tela Traduções de UI. Texto que o tema imprime sem t() nunca é traduzido.
Perguntas
O site escolhe o idioma do visitante sozinho?
Não. O Velk não lê o idioma do navegador nem redireciona. O visitante escolhe no seletor, e as tags hreflang ajudam os buscadores a mostrar a versão certa para cada pessoa.
Dá para tirar um idioma do ar?
Dá: desmarque “Idioma ativo” na tela dele e ele sai do site público; o que foi traduzido continua guardado. Excluir o idioma também mantém as traduções no banco, mas nada mais chega até elas.
Os e-mails seguem o idioma?
Ainda não. Os e-mails que o Velk manda para membros (troca de senha, código de login) saem num idioma só, o padrão do painel, definido em ADMIN_LOCALE.
O idioma do painel é a mesma coisa?
Não. O painel em si fala inglês, português ou espanhol, escolhido por usuário, com ADMIN_LOCALE no .env como padrão. Isso muda os botões do painel, nunca os idiomas do site.