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

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.

Erros relacionados

- [Como corrigir a integração LearnDash que não exibe cursos no Astra Pro](https://full.services/wp-fixer/corrigir-learndash-astra-pro/)
- [Como corrigir o layout quebrado de páginas de curso entre Tutor LMS e Astra Pro](https://full.services/wp-fixer/corrigir-layout-curso-tutor-lms-astra/)
- [Como corrigir o layout quebrado de páginas de curso do Tutor LMS com Astra Pro](https://full.services/wp-fixer/corrigir-layout-curso-astra-tutor-lms/)

## 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
```


## Código

```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.

**Fonte:** [Astra — Enhance LifterLMS Experience with Free Astra Theme](https://wpastra.com/docs/lifterlms-free/)