WP-Optimize cache Tutor LMS: corrigir páginas de curso

Tipo Performance & Velocidade

Nome do erro Cache do WP-Optimize servindo versão deslogada em páginas de curso do Tutor LMS EN: WP-Optimize page cache serving logged-out version on Tutor LMS course pages

Severidade Atenção

Descrição O cache do WP-Optimize em páginas de curso do Tutor LMS quebra quando o cache de página estático é servido a alunos logados: a versão deslogada congelada esconde o conteúdo liberado, o progresso e os botões de matrícula, porque o WP-Optimize entrega o mesmo arquivo HTML para todos sem o cache por usuário ativado.

O que é cache do WP-Optimize em páginas de curso do Tutor LMS?

O cache do WP-Optimize em páginas de curso do Tutor LMS gera um arquivo HTML estático de cada página e o serve a todos os visitantes seguintes, evitando reprocessar PHP a cada acesso. Isso acelera páginas públicas, mas entra em conflito com o Tutor LMS, que monta as páginas de curso de forma dinâmica para cada aluno: o que está liberado, o progresso da aula, o botão de continuar e a área de conteúdo restrito dependem de quem está logado. Quando o WP-Optimize guarda uma versão dessa página e a reentrega para todo mundo, o aluno vê o estado de outra sessão, normalmente o estado deslogado.

Na prática, a página de curso, de aula ou do painel do aluno aparece como se ninguém estivesse logado, mostrando o botão de matrícula no lugar do conteúdo já comprado. A documentação oficial do WP-Optimize trata exatamente esse cenário e oferece o User specific cache, recurso que gera arquivos de cache separados por usuário logado, citando como exemplo justamente alunos de curso online que precisam ver o conteúdo restrito acelerado. A correção combina excluir as páginas dinâmicas do cache padrão e, quando aplicável, ligar o cache por usuário.

Como identificar

A página de curso do Tutor LMS mostra o botão ‘Matricular-se’ ou ‘Inscrever-se’ mesmo para um aluno que já está logado e matriculado.
O conteúdo da aula aparece bloqueado com a mensagem de conteúdo restrito para quem já tem acesso, ou mostra a versão pública da lição.
A barra de progresso do curso fica travada em um valor antigo e só atualiza depois de limpar manualmente o cache em WP-Optimize.
O painel do aluno (frontend dashboard) carrega vazio ou exibe os dados de outro usuário, porque o HTML cacheado foi gerado em outra sessão.
Sair e entrar na conta não muda nada na página de curso até a expiração do cache, sinal de que um arquivo estático está sendo servido a todos.

Antes de começar: Antes de alterar as regras de cache e de exclusão de URLs em produção, faça um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para reverter rápido caso uma página de curso pare de carregar para os alunos.

Como prevenir

Sempre que instalar um plugin de cache em um site com Tutor LMS, exclua de imediato as URLs de curso, aula e painel do aluno do cache de página estático.
Mantenha o User specific cache ligado em sites com área de membros, para que conteúdo restrito de aluno logado seja cacheado por usuário e nunca compartilhado entre sessões.
Padronize os permalinks dos cursos e revise as regras de exclusão sempre que mudar a base de URL do Tutor LMS, evitando que páginas dinâmicas escapem da lista.
Teste cada mudança de cache logado como aluno e deslogado como visitante antes de subir para produção, validando progresso, matrícula e conteúdo liberado.

Causa

O cache de página do WP-Optimize está ativo sem o User specific cache, então o mesmo arquivo HTML estático da página de curso é servido a todos os alunos logados, congelando o estado de uma única sessão.
As URLs dinâmicas do Tutor LMS (a base /courses/, as lições, o /dashboard/ do aluno) não estão na lista de URLs excluídas do cache em WP-Optimize, então essas páginas que deveriam ser sempre dinâmicas viram arquivos estáticos.
O preload (pré-carregamento) do WP-Optimize gerou a versão deslogada das páginas de curso antes de qualquer aluno acessar, e é justamente esse HTML público que passa a ser entregue a quem está matriculado.
A página de curso traz nonce do WordPress e tokens de sessão dentro do HTML; cacheados de forma estática, esses valores expiram e quebram ações AJAX do Tutor LMS como marcar aula concluída ou enviar quiz.
O cookie de login não está fazendo o WP-Optimize ignorar o cache para o usuário logado naquela página específica, fazendo o servidor entregar o arquivo cacheado em vez de gerar o conteúdo do aluno.

Como resolver

Limpe o cache atual do WP-Optimize: Antes de qualquer ajuste, apague o cache existente para descartar as versões deslogadas já gravadas das páginas de curso. Sem isso, você continua testando contra arquivos antigos e acha que a correção não funcionou.
```
Painel WP -> WP-Optimize -> Cache
Clique em 'Purge cache' (Limpar cache) para apagar todos os arquivos gerados
```
Exclua as páginas dinâmicas do Tutor LMS do cache: Adicione as URLs do Tutor LMS à lista de exclusão do cache para que essas páginas voltem a ser geradas dinamicamente a cada acesso. Use a base de cursos, as lições e o painel do aluno; o curinga no fim cobre as URLs filhas.
```
Painel WP -> WP-Optimize -> Cache -> aba de configurações avançadas
```
No campo de URLs a excluir do cache, adicione uma por linha:
```
/courses/*
/course/*
/dashboard/*
```
Ative o User specific cache para alunos logados: Ligue o cache por usuário, recurso que a documentação do WP-Optimize indica para conteúdo restrito de curso online: ele gera arquivos de cache separados por usuário logado, então cada aluno recebe a versão correta com o conteúdo liberado, sem perder velocidade.
```
Painel WP -> WP-Optimize -> Cache -> configurações
Marque a opção 'Serve a cached version of the page to logged in users' / 'User specific cache'
Salve as alterações
```
Confirme que o aluno recebe a página dinâmica: Entre com uma conta de aluno real matriculado e abra a página do curso e uma lição. O conteúdo liberado, o progresso e o botão de continuar precisam aparecer corretamente. Repita em uma aba anônima deslogada para confirmar que a versão pública também está certa.
```
Acesse a página do curso logado como aluno matriculado
Verifique no rodapé da página o comentário 'Cached by WP-Optimize' e o horário de geração
Abra a mesma URL em aba anônima e compare o estado deslogado
```
Garanta a limpeza do cache ao publicar conteúdo: Confirme que o WP-Optimize limpa o cache quando um curso ou aula é atualizado, para o aluno não ver conteúdo antigo. Se a estrutura de URLs do seu curso for diferente da padrão, ajuste os caminhos da exclusão para casar com os seus permalinks.
```
Painel WP -> WP-Optimize -> Cache -> confirme a expiração (cache lifespan) ativa
Atualize um curso de teste e verifique se a página correspondente saiu do cache
Ajuste os caminhos de exclusão conforme os permalinks reais do Tutor LMS
```

PHP

<?php
// Garante que as paginas dinamicas do Tutor LMS nunca sejam servidas do
// cache de pagina do WP-Optimize, mesmo que a regra do painel falhe.
add_filter( 'wpo_url_exceptions', 'full_tutor_lms_no_cache' );
function full_tutor_lms_no_cache( $exceptions ) {
    $rotas = array(
        '/courses/.*',   // arquivo e single de curso
        '/course/.*',    // base alternativa do permalink
        '/lesson/.*',    // paginas de aula
        '/dashboard/.*', // painel frontend do aluno
    );
    foreach ( $rotas as $rota ) {
        if ( ! in_array( $rota, $exceptions, true ) ) {
            $exceptions[] = $rota;
        }
    }
    return $exceptions;
}

Perguntas frequentes

Por que a página de curso do Tutor LMS mostra a versão deslogada para alunos logados

Porque o WP-Optimize gravou um arquivo HTML estático dessa página e o serve a todos. Sem o cache por usuário, o aluno logado recebe a versão pública congelada. Exclua as URLs de curso do cache e ative o User specific cache para corrigir.

Preciso desligar todo o cache do WP-Optimize por causa do Tutor LMS

Não. O ideal é manter o cache nas páginas públicas e excluir apenas as URLs dinâmicas do curso, da aula e do painel do aluno. Assim o site continua rápido e só as páginas que dependem do login deixam de ser servidas estáticas.

O que é o User specific cache do WP-Optimize

É um recurso que gera arquivos de cache separados por usuário logado. A documentação oficial cita justamente alunos de curso online: cada participante recebe a versão cacheada do conteúdo restrito dele, mantendo a velocidade sem misturar sessões diferentes.

Quais URLs do Tutor LMS devo excluir do cache do WP-Optimize

Exclua a base dos cursos, as páginas de aula e o painel do aluno, geralmente /courses/*, /course/* e /dashboard/*. Confira os permalinks reais do seu site, pois a base pode variar, e use o curinga no fim para cobrir as páginas filhas.

O cache do WP-Optimize trava a barra de progresso do aluno

Sim. Se a página de curso é servida de um arquivo estático, o progresso fica congelado no valor da versão cacheada. Excluir a página do cache e ligar o cache por usuário faz o progresso voltar a refletir o estado real de cada aluno.

Quizzes e botões de marcar aula concluída pararam depois de ligar o cache

O HTML cacheado guarda nonces e tokens que expiram, quebrando as ações AJAX do Tutor LMS. Excluir as páginas de aula e de quiz do cache resolve, pois elas voltam a ser geradas com nonce válido a cada carregamento.

Como confirmar se a página de curso está sendo servida do cache

Abra a página, veja o código-fonte e procure pelo comentário do WP-Optimize no rodapé indicando que a página foi cacheada e o horário. Se ele aparecer em uma página de curso logada, a exclusão ainda não está pegando aquela URL.

Depois de excluir as URLs, as páginas de curso ficam lentas

Elas passam a ser geradas dinamicamente, o que custa um pouco mais que o estático, mas é o comportamento correto para conteúdo de aluno. Com o User specific cache ligado, o aluno ainda recebe uma versão cacheada própria após o primeiro acesso.

Grave

Como corrigir o cache do WP Rocket em páginas dinâmicas do WooCommerce

O cache do WP Rocket no WooCommerce mostra carrinho, total ou estoque desatualizados quando uma página dinâmica é servida como HTML estático. O WP Rocket exclui carrinho, checkout e minha conta automaticamente, mas páginas customizadas ou cookies próprios precisam de exclusão manual.

Atenção

Como corrigir o impacto de scripts de terceiros (Analytics e Pixel) no WordPress

Scripts de terceiros como Google Analytics e Facebook Pixel carregam de domínios externos no head e bloqueiam a thread principal, elevando o Total Blocking Time e o LCP. A correção adia esses scripts até a interacao e hospeda o analytics localmente.

Informativo

Como corrigir quando o WP-Optimize não remove comentários spam no WordPress

O WP-Optimize não remove comentários spam quando a opção de limpeza de comentários spam está desmarcada na tela Banco de Dados, quando os comentários estão como pendentes ou não aprovados em vez de marcados como spam, ou quando a otimização agendada nunca chega a rodar. A correção é marcar a opção correta e disparar a otimização.

Informativo

Como corrigir o erro ao desativar RSS Feeds no Perfmatters

O erro ao desativar RSS Feeds no Perfmatters acontece quando a opção Disable RSS Feeds, em Options, fica ativa e passa a redirecionar ou bloquear todas as URLs de feed do WordPress, derrubando integracoes que ainda dependem do RSS, como Mailchimp, FeedBurner, podcast e leitores de feed.

Atenção

Como corrigir o erro de Heartbeat API entre Perfmatters e WP Rocket no WordPress

O erro de Heartbeat com Perfmatters e WP Rocket acontece quando os dois plugins controlam a Heartbeat API do WordPress ao mesmo tempo: o ajuste mais restritivo prevalece, derrubando autosave, bloqueio de edição e a previa do page builder.

Atenção

Como corrigir o erro de fontes do Google no WP Rocket

O erro de fontes do Google no WP Rocket aparece quando o recurso Remove Unused CSS, na aba File Optimization, apaga a regra font-face por considera-la não usada e a página passa a exibir a fonte de fallback do navegador (serif ou Arial). A correção e preservar a regra no campo CSS safelist e limpar o Used CSS.

Setores

Extensões

Integrações

Como corrigir o cache do WP-Optimize em páginas de curso do Tutor LMS

O que é cache do WP-Optimize em páginas de curso do Tutor LMS?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o cache do WP Rocket em páginas dinâmicas do WooCommerce

Como corrigir o impacto de scripts de terceiros (Analytics e Pixel) no WordPress

Como corrigir quando o WP-Optimize não remove comentários spam no WordPress

Como corrigir o erro ao desativar RSS Feeds no Perfmatters

Como corrigir o erro de Heartbeat API entre Perfmatters e WP Rocket no WordPress

Como corrigir o erro de fontes do Google no WP Rocket

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos