🎉 USE O CUPOM FIM.DE.SEMANA.FULL | 20% OFF acima de R$ 100,00

Como corrigir a integração do LifterLMS que não funciona no Astra Pro

Time Full Services Time Full Services
Tipo Page Builders
Nome do erro Integração do LifterLMS não funciona no Astra Pro EN: LifterLMS integration not working with Astra Pro theme
Severidade Atenção
Descrição A integração do LifterLMS no Astra Pro deixa de funcionar quando as opções de LifterLMS não aparecem no Customizer, as páginas de curso e catálogo renderizam com o layout padrão errado, ou o módulo do Astra Pro fica inativo e os controles avançados de LMS como o modo sem distração somem.

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.
Antes de começar: Antes de renomear pastas de template via FTP ou alternar plugins e modelos de página em produção, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para reverter caso alguma página do LifterLMS quebre.

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

  1. 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
  2. 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)
  3. 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
  4. 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
  5. 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
<?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;
}

Perguntas frequentes

Onde ficam as configurações de LifterLMS no Astra
No Customizer do tema. A sidebar fica em Aparência > Personalizar > Layout > Sidebar > LifterLMS, o container em Aparência > Personalizar > Global > Container > LifterLMS Layout e as colunas de Course e Membership em Aparência > Personalizar > LifterLMS.
Por que as opções de LifterLMS não aparecem no meu Customizer do Astra
Na maioria dos casos o LifterLMS está inativo, em versão muito antiga, ou o Astra Pro não está ativado. O tema só registra as seções de LMS quando o LifterLMS está ativo e compatível; ative ambos e atualize para a versão estável mais recente.
Preciso do Astra Pro para usar o LifterLMS no Astra
Não para o básico. O Astra gratuito já oferece sidebar, container e colunas para o LifterLMS. O Astra Pro adiciona recursos avançados como aprendizado sem distração, checkout sem distração e controles extras de exibição do LMS.
Por que minha página de catálogo de cursos perde o estilo do tema
Catálogo e taxonomia são as páginas mais sensíveis ao tema. Se o catálogo aponta para uma página com template de largura total ou feita no Elementor, ela sobrepõe o LifterLMS Layout do Astra. Use o Modelo Padrão na página de catálogo e confira o container do LifterLMS.
O que faz o aprendizado sem distração do Astra Pro
O Distraction Free Learning do Astra Pro remove cabeçalho, rodapé e sidebars das páginas de lição para o aluno focar no conteúdo. Ele só aparece nas opções de LifterLMS do Customizer com o Astra Pro ativo e licenciado.
Como saber se o problema é do tema ou do plugin
Troque temporariamente para um tema padrão e recarregue uma página de curso. Se o problema persiste sem o Astra, ele é do LifterLMS ou de outro plugin; se some, o ajuste está nas opções de Container, Sidebar e Layout do LifterLMS no Astra.
Por que copiei templates do LifterLMS para o tema e o layout quebrou
Arquivos dentro de uma pasta lifterlms no tema filho substituem os templates e ignoram o tratamento de layout do Astra. Renomeie a pasta para que o LifterLMS volte a usar os templates do tema e mantenha apenas overrides realmente necessários.

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