🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir o conflito de templates de curso entre Tutor LMS e Elementor

Time Full Services Time Full Services
Tipo Page Builders
Nome do erro Conflito de template entre Tutor LMS e Elementor EN: Tutor LMS and Elementor course template conflict
Severidade Grave
Descrição A página de curso fica sem o layout do Elementor (ou mostra o template padrão do Tutor LMS) porque o addon Tutor LMS do Elementor não esta ativo ou a prioridade de template aponta para o template embutido do plugin em vez do seu template Elementor.

O que é o conflito de template entre Tutor LMS e Elementor?

O conflito de template entre Tutor LMS e Elementor acontece quando a página de curso (single course) deixa de renderizar o layout desenhado no Elementor e cai no template embutido do plugin Tutor LMS, ou renderiza os dois sobrepostos. Os dois sistemas disputam qual arquivo controla o single course: o Tutor LMS carrega seu próprio single-course.php a partir de plugins/tutor/templates, enquanto o Elementor (via Theme Builder do Elementor Pro ou via addon Tutor LMS for Elementor) tenta assumir o mesmo gancho de renderizacao. Quando o addon não esta ativo, o checkbox Tutor LMS Single Course Template não foi marcado no template, ou a ordem de prioridade favorece o template do plugin, o curso aparece sem o design ou com elementos duplicados.

Como identificar

  • A página do curso abre com a mensagem visual do template padrão do Tutor LMS em vez do layout que você montou no Elementor.
  • O Theme Builder do Elementor Pro mostra o template como aplicado, mas no front-end o single course ignora ele.
  • Cabeçalho do curso, abas (Informação, Currículo, Avaliacoes) e botão de matricula aparecem duplicados, um do Tutor e outro do Elementor.
  • No editor do Elementor os widgets Tutor LMS não aparecem na busca da barra lateral esquerda.
  • O conteúdo do curso renderiza, mas sem estilo: cai para a fonte e cores do tema, como se o CSS do template não carregasse.
Antes de começar: Antes de remover ou renomear o override em wp-content/themes/seu-tema-child/tutor/, faca backup da pasta do tema; o arquivo pode conter customizacoes intencionais do single course.

Como prevenir

  • Use sempre tema filho (child theme) ao sobrescrever templates do Tutor LMS, para que atualizações do plugin não apaguem nem reimponham o markup.
  • Mantenha apenas um responsável pelo single course: ou o addon Tutor LMS for Elementor, ou um template do Theme Builder do Elementor Pro, nunca os dois com a mesma condicao.
  • Depois de cada atualização do Tutor LMS ou do Elementor, abra um curso de teste em aba anonima e confira se o layout continua aplicado.
  • Documente em um arquivo do tema qual template controla o single course, para a equipe não criar um segundo concorrente sem perceber.

Causa

  • O addon Tutor LMS for Elementor (em Tutor LMS -> Addons) esta desativado, entao os widgets de curso e o gancho de renderizacao Elementor não existem.
  • O template do Elementor foi criado sem marcar o checkbox Tutor LMS Single Course Template, entao o Elementor nunca o associa a página single course.
  • Existe um template do Theme Builder do Elementor Pro com a condicao Single Course concorrendo com o template criado pelo addon do Tutor LMS para o mesmo single course.
  • A opção de prioridade de template do Tutor LMS esta resolvendo para o single-course.php embutido do plugin antes do template Elementor (ordem: template do plugin, depois override de tema, depois template global do Elementor).
  • Existe um override manual em wp-content/themes/seu-tema-child/tutor/single/course.php que reimpoe o markup do Tutor por cima do layout do Elementor.
  • O cache de página (plugin de cache ou Cloudflare) guardou uma versão antiga do single course gerada antes de o template Elementor ser aplicado.

Como resolver

  1. Ative o addon do Tutor LMS para o Elementor: Sem o addon, o Tutor LMS não expoe os widgets nem o gancho que o Elementor usa para assumir o single course. Ative pelo painel e confirme que o Elementor esta atualizado.
    WP Admin -> Tutor LMS -> Addons -> Tutor LMS for Elementor -> ativar
    WP Admin -> Plugins -> confirmar Elementor e Tutor LMS ativos e atualizados
  2. Crie o template marcando o tipo correto: O Elementor so assume o single course se o template estiver marcado como template de curso único do Tutor. Crie como tipo Page (recomendado pela doc) e habilite a opção de single course.
    WP Admin -> Templates -> Add New
    Tipo do template: Page
    Marcar: Tutor LMS Single Course Template
    Desenhar o layout com os widgets Tutor LMS e salvar
  3. Resolva a disputa com o Theme Builder do Elementor Pro: Se você usa Elementor Pro, um template do Theme Builder com a condicao de curso único pode competir com o template do addon. Mantenha apenas um responsável pelo single course para não sobrepor markup.
    WP Admin -> Templates -> Theme Builder
    Localizar o template com condicao Single Course
    Excluir a condicao duplicada OU desativar o template do addon, deixando so um ativo
  4. Ajuste a prioridade para o template Elementor: A ordem de resolucao do Tutor LMS e: template do plugin, depois override de tema, depois template global do Elementor. Garanta que nenhum override de tema esteja capturando o single course antes do Elementor.
    Verificar se existe wp-content/themes/seu-tema-child/tutor/single/course.php
    Remover ou renomear o override para o Tutor devolver o controle ao template Elementor
    Reabrir o curso em Edit with Elementor e reaplicar o template salvo
  5. Limpe os caches e revalide o single course: Uma versão em cache do single course antiga continua servindo o layout quebrado mesmo depois do ajuste. Limpe os caches e abra um curso em aba anonima para confirmar.
    WP Admin -> Elementor -> Tools -> Regenerate CSS & Data
    Limpar o cache do plugin de cache do site
    Purgar o cache do Cloudflare se estiver em uso
    Abrir um curso em janela anonima e validar o layout
PHP
// functions.php do tema filho — checagem de diagnostico.
// Confirma se o addon Tutor LMS for Elementor esta carregado e qual
// template esta servindo o single course (rode com WP_DEBUG e veja o log).
add_action( 'template_redirect', function () {
	if ( ! function_exists( 'tutor_utils' ) || ! is_singular( tutor()->course_post_type ) ) {
		return;
	}
	$addon_on = class_exists( '\TUTOR_ELEMENTOR\Init' );
	$el_built = function_exists( 'elementor_theme_do_location' )
		&& elementor_theme_do_location( 'single' );
	error_log( sprintf(
		'[WPF-282] curso #%d | addon_elementor=%s | elementor_location=%s',
		get_the_ID(),
		$addon_on ? 'on' : 'off',
		$el_built ? 'assumiu' : 'nao-assumiu'
	) );
}, 5 );

Perguntas frequentes

Por que a página de curso ignora o template que montei no Elementor?
Quase sempre porque o addon Tutor LMS for Elementor esta desativado ou o template foi criado sem marcar a opção Tutor LMS Single Course Template. Sem essa marcacao, o Elementor não associa o template ao single course e o Tutor LMS serve o template embutido do plugin.
Preciso do Elementor Pro para usar template de curso no Tutor LMS?
Não. O addon Tutor LMS for Elementor funciona com o Elementor gratuito para desenhar o single course pelos widgets do Tutor. O Elementor Pro adiciona o Theme Builder, que e uma forma alternativa, e e justamente a coexistencia das duas que costuma gerar o conflito de template.
O addon esta ativo, mas os widgets do Tutor LMS não aparecem no editor. O que fazer?
Confirme que o Elementor e o Tutor LMS estão atualizados, reative o addon Tutor LMS for Elementor e limpe o cache do Elementor em Elementor -> Tools -> Regenerate CSS & Data. Versões incompativeis entre os dois plugins removem os widgets da barra lateral.
O cabeçalho e as abas do curso aparecem duplicados. Por que?
São dois templates renderizando o mesmo single course ao mesmo tempo: um template do Theme Builder do Elementor Pro com condicao de curso único e o template do addon. Mantenha apenas um deles ativo para o single course e a duplicacao some.
Mexer nos templates do Tutor LMS quebra meu tema?
Pode quebrar se você editar templates diretamente na pasta do plugin ou usar um tema com features especificas do Tutor. Sobrescreva sempre por um tema filho, em wp-content/themes/seu-tema-child/tutor, e tenha cuidado especial com a página de course-archive.
Apliquei tudo e o front-end continua com o layout antigo. E cache?
Provavelmente sim. Uma versão do single course foi guardada antes do template Elementor entrar. Limpe o cache do plugin de cache, purgue o Cloudflare se usar e abra o curso em aba anonima para ver a versão nova.
Onde fica a ordem de prioridade entre o template do Tutor e o do Elementor?
A doc do Tutor LMS descreve a hierarquia: primeiro o template embutido do plugin, depois um override de tema, depois o template global do Elementor. Se um override de tema captura o single course antes, o template Elementor nunca assume.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes