Como corrigir o conflito de templates de curso entre Tutor LMS e 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.
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
- 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 - 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 - 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 - 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 - 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
// 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 );














