Como corrigir a integração do LifterLMS que não funciona no Astra Pro
O que é integração do LifterLMS no Astra Pro?
A integração do LifterLMS no Astra Pro é o conjunto de controles que o tema adiciona ao Customizer especificamente para as páginas do LMS. No Astra gratuito você define colunas em Aparência > Personalizar > LifterLMS, a sidebar em Aparência > Personalizar > Layout > Sidebar > LifterLMS (válida para Checkout, Perfil, Quiz, Cursos, Memberships, Single Course e Single Lesson) e o container em Aparência > Personalizar > Global > Container > LifterLMS Layout. O Astra Pro soma recursos avançados: checkout sem distração, aprendizado sem distração e controles adicionais de exibição do LMS.
A integração não funciona quando esses controles não cumprem seu papel: as opções de LifterLMS somem do Customizer, as páginas de curso, lição e catálogo ignoram o layout configurado e voltam ao padrão do tema, ou os recursos Pro como o modo sem distração não aparecem. A documentação do LifterLMS alerta que as páginas de catálogo e taxonomia são as mais sensíveis ao tema e devem ser checadas primeiro nas configurações de container, sidebar e layout do Astra para LifterLMS.
Como identificar
- As páginas de curso, lição e catálogo do LifterLMS aparecem com o layout padrão do tema, ignorando o que foi definido em Aparência > Personalizar > Global > Container > LifterLMS Layout.
- A seção ‘LifterLMS’ não aparece em Aparência > Personalizar, ou a opção ‘Sidebar > LifterLMS’ não existe na lista de Layout.
- Os recursos do Astra Pro como ‘Distraction Free Learning’ e ‘Distraction Free Checkout’ não surgem nas opções de LifterLMS do Customizer.
- A sidebar definida para o LifterLMS não é respeitada: aparece sidebar onde foi marcado ‘No Sidebar’ ou some onde deveria existir.
- As páginas de catálogo e de taxonomia de cursos quebram ou perdem o estilo do tema enquanto as páginas single de curso parecem corretas.
Como prevenir
- Mantenha o LifterLMS e o Astra Pro sempre na mesma faixa de versão estável, validando em staging antes de atualizar, porque a integração depende dos hooks que o tema e o LMS expõem entre si.
- Evite copiar templates do LifterLMS para o tema filho sem necessidade; quando precisar, versione os arquivos e revise a cada atualização do plugin para não sobrepor o tratamento de layout do Astra.
- Configure o catálogo e as taxonomias de cursos usando o Modelo Padrão do tema, já que são as páginas mais sensíveis ao tema segundo a documentação do LifterLMS.
- Documente as opções de Container, Sidebar e colunas do LifterLMS aplicadas no Customizer para reaplicar rápido caso uma migração ou troca de tema redefina os valores.
Causa
- O módulo do Astra Pro (plugin Astra Pro / Astra Addon) está instalado mas desativado ou sem licença ativa, então os controles avançados de LifterLMS como aprendizado e checkout sem distração não são carregados no Customizer.
- Existe uma pasta de override de templates do LifterLMS no tema filho (wp-content/themes/seu-tema/lifterlms/) com arquivos antigos que substituem os templates do tema e ignoram o tratamento de layout do Astra.
- A página de catálogo de cursos do LifterLMS está apontada para uma página estática com template Elementor ou de largura total no editor, que sobrepõe o LifterLMS Layout do Astra e por isso o container configurado não é aplicado.
- O LifterLMS está em versão muito anterior à do Astra Pro (ou vice-versa) e a classe Astra_LifterLMS não reconhece os hooks do LMS, fazendo as opções de sidebar e container do LifterLMS não registrarem no Customizer.
- Um plugin de cache ou de otimização serviu uma versão antiga do CSS do Astra sem os estilos do LifterLMS, deixando as páginas do curso sem a estilização do tema mesmo com as opções corretas salvas.
Como resolver
- Ative o módulo do Astra Pro e confirme a licença: Os controles avançados de LifterLMS (modo sem distração e exibição extra do LMS) só aparecem com o Astra Pro ativo e licenciado. Confirme o plugin ativo e a licença válida antes de procurar as opções no Customizer.
Painel WP -> Plugins -> ative 'Astra Pro' (Astra Addon) Painel WP -> Astra -> Dashboard -> confirme a chave de licença ativada - Confira as opções de LifterLMS no Customizer do Astra: Com o LifterLMS e o Astra ativos, o tema registra as seções de LMS no Customizer. Defina o container, a sidebar e as colunas das páginas do LifterLMS para que o layout pare de cair no padrão do tema.
Aparência -> Personalizar -> Global -> Container -> LifterLMS Layout Aparência -> Personalizar -> Layout -> Sidebar -> LifterLMS Aparência -> Personalizar -> LifterLMS (defina as colunas de Course e Membership) - Remova overrides de template do LifterLMS no tema filho: Uma pasta lifterlms dentro do tema filho com templates antigos substitui o tratamento do Astra. Renomeie a pasta para que o LifterLMS volte a usar os templates do tema e a integração do Astra seja aplicada.
Via FTP, acesse wp-content/themes/seu-tema-filho/ Renomeie a pasta lifterlms para lifterlms-bkp Recarregue uma página de curso e verifique se o layout do Astra voltou - Corrija a página de catálogo de cursos: Se o catálogo aponta para uma página com template de largura total ou construída no Elementor, ela sobrepõe o LifterLMS Layout do Astra. Ajuste o template da página para o padrão do tema, já que catálogo e taxonomia são as páginas mais sensíveis ao tema.
Painel WP -> LifterLMS -> Settings -> Catalogs -> confira a página de catálogo Edite a página -> Atributos da Página -> Modelo -> Modelo Padrão - Atualize os plugins e limpe o cache: Versões defasadas impedem a classe Astra_LifterLMS de registrar as opções, e o cache pode servir CSS sem os estilos do LMS. Atualize tudo e limpe o cache para a integração refletir no front-end.
Painel WP -> Plugins -> atualize LifterLMS e Astra Pro para a versão estável mais recente Painel WP -> Painel -> Atualizações -> atualize o tema Astra Limpe o cache do plugin de cache e do navegador e recarregue a página do curso
<?php
/**
* Força o Modelo Padrão do tema na página de catálogo do LifterLMS,
* evitando que um template de largura total sobreponha o LifterLMS Layout do Astra.
* Coloque no functions.php do tema filho.
*/
add_filter( 'template_include', 'full_lifterlms_force_astra_template', 99 );
function full_lifterlms_force_astra_template( $template ) {
if ( ! function_exists( 'is_courses' ) ) {
return $template; // LifterLMS inativo: nao mexe.
}
// is_courses() = arquivo de catalogo de cursos do LifterLMS.
if ( is_courses() || is_post_type_archive( 'course' ) ) {
$default = locate_template( array( 'archive.php', 'index.php' ) );
if ( $default ) {
return $default;
}
}
return $template;
}














