Fórum Comunitário: guia completo
Instalar, configurar e explorar um fórum comunitário completo para PrestaShop 8 e 9: categorias e subfóruns, tópicos e respostas, moderação, pré-moderação, denúncias, pesquisa e URLs amigáveis.
Apresentação e pré-requisitos
O Fórum Comunitário acrescenta um verdadeiro fórum à sua loja PrestaShop, diretamente ligado à conta de cliente existente. Os seus clientes abrem tópicos, respondem uns aos outros, modificam ou eliminam as suas próprias mensagens e denunciam os abusos, enquanto mantém o controlo a partir do back-office: categorias e subfóruns, moderação à unidade ou por lote, pré-moderação opcional e fila de denúncias. Tudo sem ferramenta de terceiros nem base de dados externa.
- Compatível com PrestaShop 8.0 a 9.x, tema Classic e temas derivados.
- PHP 8.1 a 8.3.
- Multiloja e multilingue (FR/EN/ES/DE/IT).
- Nenhuma tarefa CRON necessária, nenhuma dependência Composer.
- Arquitetura conforme ao PrestaShop (ObjectModel, ModuleAdminController), compatível com PS 8 e PS 9 sem adaptação.
Os membros usam a sua conta de cliente PrestaShop habitual. Não é necessária nenhuma segunda conta: é acrescentada uma ligação para o fórum na área de cliente e no rodapé.
O pacote de traduções cobre FR/EN/ES/DE/IT e os modelos de e-mail de denúncia existem em francês e inglês. Numa loja em português, traduza as cadeias do front-office (« Novo tópico », « Responder », « Denunciar », ficha de autor) em Internacional > Traduções e renomeie a categoria de demonstração « Discussion générale ».
Instalação
Instale o módulo como qualquer módulo PrestaShop:
- Descarregue o arquivo
dfforum.zipa partir da sua conta de cliente. - No back-office, vá a Módulos > Gestor de módulos.
- Clique em Instalar um módulo e carregue o arquivo.
- Depois de instalado, clique em Configurar.
Na instalação, o módulo cria as suas tabelas (categorias, tópicos, mensagens, denúncias), regista os seus hooks, acrescenta o separador pai DataFirefly Forum e inicia uma primeira categoria de demonstração « Discussion générale » para lhe permitir testar imediatamente.
Se os URLs amigáveis não se ativarem de imediato, limpe a cache (Parâmetros avançados > Desempenho) e regenere os URLs a partir de Tráfego e SEO.
Definições gerais do módulo
A página de configuração reúne todas as definições do fórum:
- Pré-moderação: se ativada, cada novo tópico ou mensagem passa por uma fila de espera antes de ser público.
- Leitura pelos convidados: autoriza ou não a consulta do fórum sem estar autenticado (a escrita continua reservada aos clientes autenticados).
- Tópicos por página: número de tópicos apresentados numa categoria (20 por defeito).
- Mensagens por página: número de mensagens apresentadas num tópico (15 por defeito).
- Comprimento mínimo: número mínimo de caracteres exigido para uma mensagem (10 por defeito).
- Intervalo anti-flood: duração mínima, em segundos, entre duas mensagens de um mesmo membro (30 por defeito; 0 para desativar).
- Denúncias: ativa ou não a possibilidade de os membros denunciarem uma mensagem.
- Janela de edição: duração, em minutos, durante a qual um membro ainda pode modificar a sua mensagem (30 por defeito; 0 para proibir a edição).
- E-mail de notificação: endereço que recebe as denúncias (por defeito, o e-mail da loja).
Criar categorias e subfóruns
A partir do separador DataFirefly Forum > Categorias, estruture o seu fórum. Uma categoria pode ser um tema de primeiro nível ou um subfórum associado a outra categoria.
- Nome e descrição: textos traduzíveis por idioma, apresentados na página inicial do fórum.
- Categoria pai: deixe vazio para uma categoria raiz, ou selecione uma categoria para criar um subfórum.
- Ícone: pictograma facultativo apresentado ao lado do nome.
- Posição: ordem de apresentação, ajustável por arrastar e largar na lista.
- Ativa: oculta ou mostra a categoria do lado da loja.
Cada subfórum mostra automaticamente o seu número de tópicos, o seu número de mensagens e a sua última mensagem.
Eliminar uma categoria elimina também os tópicos e mensagens que contém. Os seus eventuais subfóruns são desassociados (recolocados na raiz), não eliminados.
Do lado do visitante: criar um tópico e responder
Um cliente autenticado abre um tópico a partir do botão Novo tópico: escolhe a categoria, introduz um título e uma mensagem. O módulo gera automaticamente um slug e um URL amigável para o tópico. Num tópico, o formulário de resposta aparece no fundo da página para os membros autenticados.
Cada mensagem mostra uma ficha de autor: avatar com inicial, nome, número de mensagens e data de inscrição. Enquanto a janela de edição não for ultrapassada, o autor pode modificar ou eliminar a sua própria mensagem diretamente, sem recarregar a página (AJAX).
Se o autor eliminar a única mensagem de um tópico que criou, o tópico inteiro é eliminado. É o comportamento esperado para evitar tópicos vazios.
Moderação dos tópicos e das mensagens
Dois separadores dedicados permitem-lhe moderar:
- DataFirefly Forum > Tópicos: ative ou desative, fixe, bloqueie ou elimine os tópicos, à unidade ou por lote. Um tópico bloqueado continua legível mas já não aceita respostas; um tópico fixado sobe ao topo da sua categoria.
- DataFirefly Forum > Mensagens: modere cada mensagem individualmente ou por lote, valide as mensagens pendentes ou filtre as mensagens de um tópico preciso.
O painel (primeiro separador) mostra de relance o número de categorias, tópicos, mensagens, mensagens pendentes e denúncias, com acessos diretos à moderação.
Pré-moderação
Quando a pré-moderação está ativada nas definições, cada novo tópico e cada nova resposta são criados em estado « pendente » e não aparecem enquanto não os validar. O membro é informado de que a sua mensagem será publicada depois de validação.
Para validar, vá a Mensagens: os conteúdos pendentes estão aí assinalados e podem ser aprovados à unidade ou por lote. O contador « pendentes » do painel indica-lhe permanentemente o que falta tratar.
A pré-moderação aplica-se aos novos conteúdos. As mensagens já publicadas não voltam à fila de espera se ativar a opção mais tarde.
Denúncias e notificações
Se as denúncias estiverem ativadas, cada membro pode denunciar uma mensagem que considere abusiva (uma única denúncia por membro e por mensagem). A denúncia chega ao separador DataFirefly Forum > Denúncias, com um acesso direto à mensagem em causa, e pode ser marcada como tratada.
A cada denúncia, é enviado um e-mail para o endereço de notificação configurado. São fornecidos modelos de e-mail prontos a usar em francês e em inglês.
Para não perder uma denúncia, preencha um endereço de notificação dedicado à moderação em vez do e-mail genérico da loja.
Pesquisa e URLs amigáveis
O fórum expõe uma pesquisa de texto integral baseada num índice FULLTEXT sobre os títulos e o conteúdo das mensagens: os seus visitantes encontram instantaneamente uma discussão. Do lado dos endereços, o módulo gera URLs amigáveis e legíveis para o fórum, as categorias e os tópicos, bem como para a criação de um novo tópico.
Este conteúdo gerado pelos seus clientes, acessível através de URLs claros, alimenta naturalmente o seu posicionamento em pesquisas de cauda longa. Deixe a leitura aberta aos convidados para maximizar a indexação.
Integração na conta de cliente
O módulo integra-se na área de cliente do PrestaShop através dos hooks displayCustomerAccount e displayMyAccountBlock: aparece uma ligação para o fórum no painel da conta de cliente. É acrescentada uma segunda ligação no rodapé através do hook displayFooter, para tornar o fórum visível a partir de qualquer página.
FAQ e resolução de problemas
A ligação do fórum não aparece na área de cliente
Verifique que os hooks displayCustomerAccount e displayMyAccountBlock estão ligados (separador Módulos > Posições). Alguns temas personalizados não chamam estes hooks: é então necessário acrescentá-los ao template da conta de cliente.
Os URLs do fórum devolvem um erro 404
Limpe a cache e regenere os URLs a partir de Tráfego e SEO. Certifique-se de que a reescrita de URL (URLs amigáveis) está ativada na sua loja.
Um membro já não pode modificar a sua mensagem
A modificação só é possível durante a janela de edição definida nas definições. Passado esse prazo, o botão de modificação desaparece. Defina a janela em 0 para proibir qualquer edição, ou aumente-a para dar mais tempo.
As mensagens não aparecem imediatamente
É o comportamento normal quando a pré-moderação está ativa: as mensagens ficam pendentes até validação a partir do separador Mensagens. Desative a pré-moderação para uma publicação imediata.
Como lutar contra o spam?
O módulo combina várias salvaguardas: campo honeypot invisível, anti-flood parametrizável, comprimento mínimo e denúncia comunitária. Para um controlo máximo, ative a pré-moderação.
O que acontece na desinstalação?
A desinstalação elimina as tabelas do módulo e os seus separadores do back-office. É pedida uma confirmação porque esta operação apaga definitivamente as categorias, tópicos e mensagens.