# Como corrigir a integração LearnDash que não exibe cursos no Astra Pro no WordPress

Quando o Astra LearnDash não exibe cursos, a causa quase sempre é o módulo LearnDash do Astra Pro desativado, a grade de cursos sem o add-on Course Grid, ou um layout do Astra que esconde o conteúdo na página de cursos.

## O que é LearnDash Astra Pro que não exibe cursos?

O Astra LearnDash não exibe cursos é a falha em que as páginas de curso, lição ou a grade de cursos do LearnDash aparecem em branco, sem estilo ou com layout quebrado depois que o tema Astra Pro entra na frente. O Astra Pro traz um módulo dedicado de LearnDash que injeta os controles de design (largura do container, barra lateral, sidebar e tipografia) nas telas do LMS; quando esse módulo não está ativo ou o conteúdo é montado por um recurso que o Astra ainda não governa, o resultado é a página de cursos vazia ou desformatada.

O LearnDash registra os cursos no tipo de post sfwd-courses e os entrega ao visitante por blocos do editor, pelo add-on gratuito Course Grid e por shortcodes como ld_course_list. O Astra só aplica seu layout a essas telas depois que o módulo LearnDash do Astra Pro Addon é ligado em Astra. Sem essa ativação, ou com o container do Astra forçado para uma largura que oculta o conteúdo, os cursos existem no banco mas não chegam à tela do aluno.

## Como identificar

- A página que lista os cursos abre em branco ou só com o cabeçalho e o rodapé do Astra, sem nenhum card de curso no meio.
- A grade de cursos montada pelo shortcode 'ld_course_list' ou pelo bloco Course Grid não renderiza, ou mostra apenas o título sem os cards.
- No Customizer do Astra não aparece a seção 'LearnDash' para ajustar layout, sidebar e largura das páginas de curso.
- As páginas de curso e lição abrem com o conteúdo do LearnDash sem estilo, coladas no topo, ignorando o container e a barra lateral do Astra.
- O endereço do arquivo de cursos retorna 'Page not found' (404) mesmo com cursos publicados e visíveis no painel.

**Antes de começar:** Antes de renomear pastas de template via FTP ou alternar módulos do Astra Pro 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 a página de cursos quebre.

## Como prevenir

- Mantenha o módulo LearnDash do Astra Pro Addon ativo e revise o container e a sidebar das telas de curso sempre que trocar de layout global no Astra.
- Use o add-on oficial LearnDash Course Grid ou o bloco nativo para montar a grade, evitando shortcodes de terceiros que o Astra não estiliza.
- Sempre que copiar templates do LearnDash para o tema, versione-os e atualize-os a cada nova versão do plugin para não congelar a listagem de cursos.
- Após instalar ou atualizar o LearnDash, regrave os permalinks e valide a URL do arquivo de cursos antes de publicar mudanças em produção.

Erros relacionados

- [Como corrigir a integração do LifterLMS que não funciona no Astra Pro](https://full.services/wp-fixer/corrigir-lifterlms-astra-pro/)
- [Como corrigir o erro de cores no Global Color Palette do Astra Pro](https://full.services/wp-fixer/corrigir-global-color-palette-astra-pro/)
- [Como corrigir o Scroll to Top que não funciona no Astra Pro](https://full.services/wp-fixer/corrigir-scroll-to-top-astra-pro/)

## Causa

- O módulo LearnDash do Astra Pro Addon está desativado em Astra, então o tema não injeta os controles de layout nem estiliza as telas de curso, lição e a grade de cursos.
- A grade de cursos depende do add-on gratuito LearnDash Course Grid (ou do bloco Course Grid) que não está instalado e ativo, então o shortcode ld_course_list renderiza sem os cards visuais.
- O layout de container do Astra para o post type sfwd-courses está definido como largura total sem conteúdo, ou com a sidebar empurrando o conteúdo para fora da área visível na página de cursos.
- Os templates do LearnDash foram sobrescritos por arquivos antigos na pasta learndash do tema ativo, que não acompanham a versão atual do plugin e deixam de imprimir a listagem de cursos.
- Os permalinks não foram regravados após instalar ou atualizar o LearnDash, deixando o arquivo do post type courses sem rota e retornando 404 na página que lista os cursos.

## Como resolver

1. Ative o módulo LearnDash no Astra Pro Addon: O Astra só estiliza as telas do LearnDash depois que o módulo dedicado é ligado no Astra Pro Addon. Sem ele, as páginas de curso saem sem layout e a seção de ajustes não aparece no Customizer.

```
Painel WP -> Astra -> aba Módulos (Astra Pro Addon)
Localize o módulo 'LearnDash' e clique em Ativar (toggle ligado)
Confirme que o Astra Pro Addon esta ativo em Plugins
```

2. Ajuste o layout das páginas de curso no Customizer: Com o módulo ativo, o Astra exibe a seção LearnDash no Customizer. Defina um container com conteúdo e uma sidebar válida para que os cursos e a grade apareçam dentro da área de conteúdo, e não fora da tela.

```
Painel WP -> Aparencia -> Personalizar -> LearnDash
Em Container, escolha 'Largura do conteúdo' (evite largura total sem conteúdo)
Em Sidebar, selecione 'Sem barra lateral' ou um lado valido e publique
```

3. Garanta a grade de cursos com o add-on Course Grid: A grade visual de cursos depende do add-on gratuito LearnDash Course Grid ou do bloco Course Grid. Sem ele, o shortcode de listagem renderiza sem os cards. Instale e ative o add-on e confira o shortcode na página.

```
Painel WP -> LearnDash LMS -> Add-ons -> instale e ative 'Course Grid'
Edite a página de cursos e confirme o shortcode: [ld_course_list]
Ou insira o bloco 'LearnDash Course Grid' no editor de blocos
```

4. Remova templates antigos do LearnDash no tema: Templates do LearnDash copiados para o tema e desatualizados deixam de imprimir a listagem. Verifique a pasta learndash dentro do tema ativo e remova ou atualize os arquivos para o plugin voltar a usar os templates oficiais.

```
Via FTP, abra wp-content/themes/seu-tema/learndash/
Renomeie a pasta para learndash-bkp para o LearnDash usar os templates do plugin
Recarregue a página de cursos e confira se a listagem volta
```

5. Regrave os permalinks para resolver o 404: Se a página que lista os cursos retorna 404, o post type sfwd-courses ficou sem rota após instalar ou atualizar o LearnDash. Regravar os permalinks recria as regras de reescrita e devolve a rota do arquivo de cursos.

```
Painel WP -> Configurações -> Links Permanentes
Sem mudar nada, clique em 'Salvar alterações' para regravar as rewrite rules
Acesse novamente a URL do arquivo de cursos e confirme que abre
```


## Código

```php
<?php
// Forca container com conteudo e sem sidebar nas telas do LearnDash
// quando o tema ativo e o Astra. Adicione no functions.php do tema filho.
add_filter( 'astra_page_layout', 'full_learndash_astra_layout' );
function full_learndash_astra_layout( $layout ) {
    if ( function_exists( 'learndash_get_post_type_slug' ) ) {
        $ld_types = array(
            learndash_get_post_type_slug( 'course' ),  // sfwd-courses
            learndash_get_post_type_slug( 'lesson' ),  // sfwd-lessons
        );
        if ( is_singular( $ld_types ) || is_post_type_archive( $ld_types ) ) {
            return 'no-sidebar';
        }
    }
    return $layout;
}
```

## Perguntas frequentes

### Por que o Astra Pro não estiliza minhas páginas do LearnDash

Porque o módulo LearnDash do Astra Pro Addon provavelmente está desativado. O Astra só aplica container, sidebar e tipografia às telas de curso e lição depois que esse módulo é ligado em Astra. Ative o módulo e republique o Customizer para o layout voltar.

### Por que a grade de cursos do LearnDash não aparece no Astra

A grade visual depende do add-on gratuito LearnDash Course Grid ou do bloco Course Grid. Sem ele, o shortcode ld_course_list renderiza a listagem sem os cards. Instale e ative o Course Grid em LearnDash LMS e confirme o shortcode ou o bloco na página.

### Onde ficam as opções de layout do LearnDash no Astra

Em Aparência, Personalizar, na seção LearnDash do Customizer. Essa seção só surge quando o módulo LearnDash do Astra Pro Addon está ativo. Lá você ajusta container, sidebar e largura das páginas de curso e lição.

### A página de cursos do LearnDash abre como 404 no Astra, o que fazer

Quase sempre é falta de regravação dos permalinks após instalar ou atualizar o LearnDash, deixando o post type sfwd-courses sem rota. Vá em Configurações, Links Permanentes e clique em Salvar alterações para recriar as regras e devolver a rota do arquivo de cursos.

### Preciso do Astra Pro para usar o LearnDash

Não. O LearnDash funciona com o Astra gratuito, mas os controles de design das telas de curso, como container e sidebar específicos, vêm do módulo LearnDash do Astra Pro Addon. Sem o Pro, você usa o layout global do Astra para essas páginas.

### Por que os cursos somem depois que eu copiei templates para o tema

Templates do LearnDash copiados para a pasta learndash do tema e não atualizados deixam de acompanhar a versão atual do plugin e param de imprimir a listagem. Remova ou atualize esses arquivos para o LearnDash voltar a usar os templates oficiais do plugin.

### Como listar os cursos numa página com shortcode no Astra

Use o shortcode ld_course_list em uma página e, para a grade visual, mantenha o add-on Course Grid ativo. O Astra aplica o container e a sidebar definidos no Customizer da seção LearnDash, garantindo que os cards fiquem dentro da área de conteúdo.

**Fonte:** [Astra Documentation — Brainstorm Force](https://wpastra.com/docs/)