Portais que utilizam cache de página no WordPress frequentemente enfrentam problemas com o sistema nativo de comentários. Isso acontece porque o formulário padrão utiliza tokens de segurança que expiram com o tempo, mas acabam sendo armazenados no cache e entregues para diferentes usuários já inválidos. Na prática, o leitor tenta comentar e o envio falha, muitas vezes sem qualquer aviso visível, prejudicando diretamente o engajamento e a participação da audiência.
O recurso Comentários resolve esse problema substituindo o carregamento tradicional por um sistema via AJAX. Em vez de deixar o formulário completo armazenado no HTML da página cacheada, o sistema carrega comentários e formulário dinamicamente quando o usuário acessa o post, sempre utilizando tokens atualizados em tempo real. O resultado é um sistema de comentários muito mais estável, compatível com cache agressivo e sem impacto na performance do portal.
A funcionalidade funciona de forma automática após a ativação, sem necessidade de configurações complexas. O addon respeita todas as regras nativas do WordPress, incluindo permissões de comentários, moderação e paginação. Neste tutorial, você aprenderá como ativar o recurso, revisar as configurações nativas de comentários do WordPress e entender como funciona a moderação e a experiência do leitor no frontend do portal.
Como configurar
1 Ative o recurso no Seox Store
No menu lateral do wp-admin, abra o Seox Store e busque por comments ou comentários. No card Seox Publishers Addon Comments, ligue o toggle para Ativar recurso. É só isso: o addon não tem tela de configuração própria. A partir da ativação, ele assume a área de comentários de todos os posts onde os comentários estão abertos, substituindo o formulário nativo pela versão via AJAX que sobrevive ao cache.
2 Confirme as configurações de comentários no WordPress
O addon não muda quem pode comentar nem as regras de moderação: ele respeita o que está em Configurações depois Discussão. Confira nessa tela se Permitir que as pessoas enviem comentários em novos posts está marcado, e ajuste a moderação como preferir (por exemplo, O comentário deve ser aprovado manualmente para revisar antes de publicar). Aqui também ficam os campos obrigatórios (nome e e-mail) e a paginação (comentários por página). Para controlar post a post, cada publicação tem a opção Permitir comentários no painel Discussão do editor: se um post estiver com comentários fechados, o addon simplesmente não mostra nada ali.
3 Veja o formulário que o leitor recebe
Abra qualquer post publicado com comentários abertos e role até o fim. A área de comentários carrega via AJAX: o título Comentários, a lista (ou o aviso Seja o primeiro a comentar quando ainda não há nenhum) e o formulário com os campos Comentário, Nome e E-mail, junto do aviso Comentários passam por moderação antes de serem publicados. O visitante anônimo preenche Nome e E-mail; um usuário logado vê Conectado como com o próprio nome, sem precisar repetir os dados.
4 Modere os comentários recebidos
Os comentários enviados chegam no menu Comentários do wp-admin, a mesma fila de moderação nativa do WordPress. Se a moderação manual estiver ligada em Discussão, eles entram como pendentes e ficam aguardando sua aprovação; enquanto isso, o leitor vê a mensagem Seu comentário está aguardando moderação. Daqui você aprova, responde, marca como spam ou move para a lixeira, exatamente como faz com qualquer comentário do WordPress. Ao aprovar, o comentário passa a aparecer na área do post.
Como funciona por baixo dos panos
A mágica está em separar o que pode ser cacheado do que não pode. O token de segurança nunca entra no HTML da página, então o cache nunca serve um token velho.
| Etapa | O que acontece | Por que sobrevive ao cache |
|---|---|---|
| HTML da página | Só um espaço reservado vazio, sem token e sem formulário | Pode ser cacheado para sempre, não há nada que expire dentro dele |
| Carregamento (ao abrir o post) | O JavaScript busca a lista de comentários e o formulário via AJAX | A resposta vem do servidor na hora, com token fresco, e não é cacheada |
| Envio do comentário | O JavaScript envia o comentário via AJAX com o token fresco | O token nunca passou pelo cache, então nunca está expirado |
Na prática, o leitor não percebe nada disso: vê a área de comentários carregar e funcionar normalmente. A diferença aparece para o publisher, que deixa de ter comentários quebrados em páginas cacheadas.
Limites e proteções
- Moderação respeitada. Tudo segue as regras de Configurações > Discussão. Se a aprovação manual está ligada, o comentário entra como pendente e só aparece depois que você aprova.
- Campos enxutos. O formulário pede Comentário (até 1500 caracteres), Nome e E-mail. Não há campo de site nem checkbox de cookies, porque o addon não guarda esses dados extras do visitante.
- Limite de frequência. Cada visitante pode enviar um comentário a cada 15 segundos. O controle usa o IP real (inclusive atrás do Cloudflare) para conter envios em rajada e spam automatizado.
- Respostas e paginação nativas. Respostas aninhadas e o botão Carregar mais comentários seguem as opções de comentários por página do WordPress.
- Compatível com disable-comments. Se um tipo de conteúdo está desativado no plugin disable-comments, o addon não injeta a área de comentários ali.
- Requer JavaScript. Como a área carrega via AJAX, um visitante com JavaScript desligado vê o aviso Ative o JavaScript para ver os comentários. Na prática isso é raríssimo, mas o aviso deixa a situação clara.
Perguntas frequentes
