Tutor LMS tradução WPML não funciona: como corrigir

Tipo Multisite & Multilingue

Nome do erro Tradução do Tutor LMS não funciona com WPML ou Polylang EN: Tutor LMS translation not working with WPML or Polylang

Severidade Atenção

Descrição A tradução do Tutor LMS com WPML ou Polylang não funciona quando você confunde os dois níveis de texto do plugin: os textos da interface (botões, rótulos, e-mails) vêm dos arquivos .po/.mo do Tutor, enquanto os cursos e lições que você criou só são traduzidos por WPML ou Polylang com o conteúdo registrado para tradução.

O que é tradução do Tutor LMS com WPML ou Polylang?

O Tutor LMS tem dois tipos de texto que muita gente trata como se fossem um só. O primeiro são as strings da interface: botões como Enroll Now, rótulos do painel do aluno, status de matrícula e modelos de e-mail. Esses textos vêm dos arquivos de idioma do próprio plugin (tutor.pot e os derivados .po/.mo) e não passam por WPML nem por Polylang. O segundo tipo é o conteúdo que você cria: cursos, lições, tópicos, questionários e perguntas. Esse conteúdo é o que o WPML ou o Polylang traduzem, post a post, como em qualquer custom post type.

A tradução do Tutor LMS com WPML ou Polylang não funciona quando esses dois níveis são misturados. Se você ativa o WPML esperando que ele traduza os botões da interface, eles continuam em inglês porque dependem do arquivo .mo, não do WPML. Se você traduz as strings com o PO Edit mas o custom post type courses não está marcado como traduzível no WPML ou no Polylang, os cursos não ganham versão em outro idioma. A documentação oficial do Tutor LMS deixa claro que a tradução do plugin é feita por três caminhos distintos, e cada nível de texto usa um caminho diferente.

Como identificar

Os botões e rótulos do Tutor LMS, como ‘Enroll Now’, ‘Add to Cart’, ‘Course Content’ e ‘Start Learning’, continuam em inglês mesmo com o site definido em português e o WPML ou Polylang ativos.
Os cursos criados no Tutor LMS não mostram a opção de adicionar tradução no editor do WPML, ou não aparecem na lista de conteúdo traduzível do Polylang.
O seletor de idiomas troca a interface do WordPress, mas as lições e os tópicos do curso continuam exibindo o conteúdo no idioma original.
Os modelos de e-mail do Tutor LMS (confirmação de matrícula, conclusão de curso) chegam ao aluno sempre no idioma padrão, ignorando o idioma da página onde ele se matriculou.
Ao traduzir um curso pelo WPML, as lições associadas não são vinculadas à versão traduzida e o aluno cai no curso original em inglês.

Antes de começar: Antes de enviar arquivos de idioma por FTP ou alterar a configuração de tipos de conteúdo do WPML ou do Polylang em produção, faça um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, porque mudanças de idioma em custom post types podem reorganizar URLs e associações de conteúdo existentes.

Como prevenir

Defina desde o início qual plugin cuida de cada nível: arquivo .po/.mo para a interface do Tutor LMS e WPML ou Polylang para os cursos e lições, sem misturar os dois papéis.
Mantenha os arquivos de tradução em /wp-content/languages/plugins/, nunca dentro da pasta do plugin, para que as atualizações do Tutor LMS não apaguem a sua tradução.
Sempre que criar um novo tipo de conteúdo no Tutor LMS, verifique se ele está marcado como traduzível no WPML ou no Polylang antes de publicar conteúdo nele.
Use o PO Edit para gerar o par .po/.mo e nunca edite o tutor.pot diretamente, já que o WordPress só carrega o arquivo .mo compilado.
Acompanhe a tradução oficial em translate.wordpress.org/projects/wp-plugins/tutor/ para reaproveitar strings já traduzidas pela comunidade e reduzir o trabalho manual.

Causa

O custom post type 'courses' do Tutor LMS não está marcado como traduzível em WPML -> Configurações -> Tipos de Conteúdo de Posts (ou no painel Idiomas do Polylang), então o WPML/Polylang não cria versões traduzidas dos cursos.
Você espera que o WPML ou o Polylang traduzam os textos da interface (botões e rótulos), mas, segundo a doc oficial, essas strings vêm do arquivo tutor.pot e só são traduzidas por arquivo .po/.mo ou pela plataforma translate.wordpress.org, não pelos plugins multilíngues.
O arquivo de tradução do Tutor LMS está com nome ou local errado: o par tutor-pt_BR.po e tutor-pt_BR.mo precisa ficar em /wp-content/languages/plugins/, e não dentro de /wp-content/plugins/tutor/languages/, que é sobrescrito a cada atualização do plugin.
Você editou o tutor.pot diretamente em vez de gerar um .po/.mo a partir dele, então o WordPress não carrega a tradução, pois ele só lê arquivos .mo compilados.
O addon WPML Multilingual CMS do Tutor LMS não está ativado em Tutor LMS -> Addons, fazendo o WPML não reconhecer a estrutura de cursos, tópicos e lições para tradução conjunta.
As lições e tópicos foram traduzidos isoladamente, mas não foram reassociados ao curso traduzido, então o WPML/Polylang exibe a versão original do conteúdo filho.

Como resolver

Separe o que é interface do que é conteúdo: Antes de mexer em qualquer plugin, entenda que botões e rótulos do Tutor LMS são strings de interface (vêm do arquivo de idioma do plugin) e cursos, lições e questionários são conteúdo (traduzidos por WPML ou Polylang). Cada um tem um caminho diferente e tratar tudo no WPML é a causa mais comum de tradução incompleta.
```
Interface (botões, e-mails): arquivo .po/.mo do Tutor LMS
Conteúdo (cursos, lições, quizzes): WPML ou Polylang
```
Traduza as strings da interface com arquivo .po/.mo: Para colocar os botões e rótulos em português, gere um par de arquivos de idioma a partir do template tutor.pot usando o PO Edit, conforme a documentação oficial. Salve os arquivos com o nome correto e na pasta segura, que não é apagada nas atualizações do plugin.
```
Abra /wp-content/plugins/tutor/languages/tutor.pot no PO Edit (poedit.net)
Traduza as strings e gere tutor-pt_BR.po e tutor-pt_BR.mo
Envie os dois arquivos para /wp-content/languages/plugins/
```
Marque o curso como tipo de conteúdo traduzível: Para que WPML ou Polylang traduzam os cursos, o custom post type precisa estar habilitado para tradução. Sem isso, o editor de tradução simplesmente não oferece a opção de versão em outro idioma para os cursos.
```
WPML: WPML -> Configurações -> Tradução de Tipos de Conteúdo -> marque 'Cursos' como Traduzível
Polylang: Idiomas -> Configurações -> Custom post types -> habilite 'courses'
```
Ative o addon WPML Multilingual CMS do Tutor LMS: Se você usa o WPML, ative o addon oficial do Tutor LMS para que o WPML reconheça a relação entre curso, tópicos e lições e traduza a estrutura de forma conjunta, evitando que a lição traduzida fique órfã do curso original.
```
Painel WP -> Tutor LMS -> Addons
Ative o addon 'WPML Multilingual CMS'
```
Traduza cursos, tópicos e lições e revise as associações: Crie a versão traduzida do curso e de cada lição pelo editor de tradução do WPML ou pela coluna de idiomas do Polylang. Depois, abra o curso traduzido e confirme que ele aponta para as lições traduzidas, e não para o conteúdo original.
```
WPML: WPML -> Tradução -> traduza o curso e as lições associadas
Polylang: edite cada curso/lição e use a coluna do idioma de destino com o sinal +
Abra o curso traduzido e confirme que tópicos e lições são as versões no idioma correto
```

PHP

<?php
// Registra o custom post type de cursos do Tutor LMS como traduzivel no Polylang.
// Use no functions.php do tema filho quando o post type nao aparece no painel do Polylang.
add_filter( 'pll_get_post_types', 'full_tutor_lms_polylang_cpt', 10, 2 );
function full_tutor_lms_polylang_cpt( $post_types, $is_settings ) {
    if ( $is_settings ) {
        // Garante que o post type 'courses' apareca nas configuracoes do Polylang.
        $post_types['courses'] = 'courses';
    } else {
        // Torna os cursos efetivamente traduziveis.
        $post_types['courses'] = 'courses';
    }
    return $post_types;
}

Perguntas frequentes

Por que os botões do Tutor LMS continuam em inglês mesmo com WPML ativo

Porque os botões e rótulos são strings da interface do plugin e vêm do arquivo de idioma tutor.po/.mo, não do WPML. Segundo a documentação oficial, essas strings se traduzem por arquivo .po/.mo gerado no PO Edit ou pela plataforma translate.wordpress.org, e o WPML cuida apenas dos cursos e lições que você cria.

O Tutor LMS é compatível com WPML e Polylang

Sim. O Tutor LMS é translation-ready e oferece um addon oficial WPML Multilingual CMS para sites multilíngues. O Polylang também funciona desde que o custom post type de cursos esteja habilitado para tradução. A interface do plugin, no entanto, é traduzida por arquivo de idioma, e não por esses plugins.

Onde devo colocar o arquivo de tradução do Tutor LMS

Coloque o par tutor-pt_BR.po e tutor-pt_BR.mo em /wp-content/languages/plugins/. A documentação recomenda essa pasta porque ela não é apagada nas atualizações do plugin, ao contrário de /wp-content/plugins/tutor/languages/, que é sobrescrita.

Por que meu curso não aparece para traduzir no WPML ou Polylang

Porque o custom post type de cursos provavelmente não está marcado como traduzível. No WPML, habilite o tipo Cursos em Tradução de Tipos de Conteúdo; no Polylang, ative o post type courses em Idiomas, Configurações, Custom post types. Sem isso, o editor de tradução não oferece a opção.

Preciso do addon WPML do Tutor LMS para traduzir os cursos

Para uma tradução conjunta de curso, tópicos e lições com o WPML, sim, é recomendado ativar o addon WPML Multilingual CMS em Tutor LMS, Addons. Ele faz o WPML reconhecer a estrutura do curso e evita que a lição traduzida fique desvinculada do curso original.

Posso editar o arquivo tutor.pot diretamente para traduzir

Não. O arquivo .pot é apenas um template de origem. Você deve abri-lo no PO Edit, traduzir e gerar um par .po/.mo no idioma desejado. O WordPress só carrega o arquivo .mo compilado, então editar o .pot sozinho não tem efeito na interface.

As lições traduzidas ficam soltas do curso, como resolver

Isso acontece quando a lição é traduzida sem reassociar ao curso traduzido. Abra o curso na versão de destino e confirme que tópicos e lições apontam para as versões no idioma correto. O addon WPML do Tutor LMS ajuda a manter essa estrutura amarrada durante a tradução.

Existe tradução pronta do Tutor LMS em português

Sim. A documentação oficial indica a plataforma translate.wordpress.org/projects/wp-plugins/tutor/, onde traduções da comunidade ficam disponíveis e baixam automaticamente ao atingir 90 por cento de progresso. Você pode reaproveitar essas strings em vez de traduzir tudo do zero.

Grave

Como corrigir login que não funciona na rede Multisite do WordPress

O login que não funciona na rede Multisite do WordPress costuma travar quando a tela de wp-admin recarrega sem autenticar ou quando só o site principal aceita o login. A causa quase sempre são as constantes de cookie ausentes ou erradas no wp-config.php, que impedem compartilhar a sessão entre os subsites da rede.

Atenção

Como corrigir WPML com tradução que não aparece no WordPress

Com o WPML, a tradução que não aparece deixa a página no idioma original mesmo após traduzir, ou faz o idioma secundário retornar 404. As causas mais comuns são a tradução salva como rascunho, o idioma não publicado, os links permanentes desatualizados ou o cache servindo a versão antiga.

Atenção

Como corrigir Polylang com redirecionamento em loop no WordPress

O redirect loop do Polylang deixa o navegador em ERR_TOO_MANY_REDIRECTS ao abrir a home ou trocar de idioma. A causa quase sempre é a opção de esconder o idioma padrão em conflito com a URL, um código de idioma errado ou um redirecionamento http para https duplicado interferindo nas rotas de idioma.

Grave

Como corrigir erro ao criar site na rede Multisite no WordPress

O erro ao criar site na rede Multisite acontece quando o WordPress não consegue provisionar o novo subsite: a tela retorna em branco, mostra erro de tabela ausente ou o domínio recém-criado dá 404. A causa quase sempre é o wp-config.php ou o .htaccess sem as regras da rede, ou um mapeamento de domínio não resolvido.

Atenção

Como corrigir sitemap multilíngue com erro no WordPress

O sitemap multilíngue com erro deixa as URLs dos idiomas secundários de fora, retorna 404 em /sitemap.xml ou gera dois sitemaps concorrentes. As causas mais comuns são o idioma não incluído pelo plugin multilíngue, o sitemap nativo do WordPress disputando com o do plugin de SEO, ou os permalinks desatualizados.

Atenção

Como corrigir a tradução de Custom Fields do ACF PRO no WPML

A tradução de fields do ACF no WPML não funciona quando a preferência de tradução do campo está em Don't translate ou Copy, quando o grupo de campos não está marcado como traduzível no Multilingual Content Setup, ou quando o ACFML não está ativo. Ajustar a preferência para Translate libera o valor do campo para o idioma traduzido.

Setores

Extensões

Integrações

Como corrigir a tradução do Tutor LMS com WPML ou Polylang no WordPress

O que é tradução do Tutor LMS com WPML ou Polylang?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir login que não funciona na rede Multisite do WordPress

Como corrigir WPML com tradução que não aparece no WordPress

Como corrigir Polylang com redirecionamento em loop no WordPress

Como corrigir erro ao criar site na rede Multisite no WordPress

Como corrigir sitemap multilíngue com erro no WordPress

Como corrigir a tradução de Custom Fields do ACF PRO no WPML

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos