DF Product Q&A: perguntas e respostas de produto para PrestaShop 8 e 9

Apresentação

O DF Product Q&A acrescenta um bloco de Perguntas e Respostas sob as suas fichas de produto. Os visitantes colocam as suas perguntas a partir de um formulário público, o comerciante modera-as no back-office e responde-lhes oficialmente, e a comunidade pode também contribuir com as suas respostas. O conjunto é exposto em dados estruturados JSON-LD QAPage para permitir ao Google mostrar um acordeão de perguntas sob o seu resultado de pesquisa.

Instalação

A partir do back-office

1. Vá a Módulos > Gestor de módulos.
2. Clique em Instalar um módulo e carregue o arquivo dfproductqa-1.0.0.zip.
3. Clique em Configurar depois de a instalação terminar.

Por FTP

1. Descompacte o arquivo e carregue a pasta dfproductqa para o diretório /modules/ da sua loja.
2. Em Módulos > Gestor de módulos, procure « DF Product Q&A » e clique em Instalar.

Na instalação, o módulo cria duas tabelas dedicadas, regista os seus hooks e acrescenta um separador P&R de Produtos sob o menu Catálogo.

Configuração

Todas as opções são definidas a partir da página de configuração do módulo. Uma faixa de aviso indica aí permanentemente o número de perguntas e de respostas à espera de moderação, com uma ligação direta para o separador dedicado.

Moderação das perguntas

• Aprovar automaticamente as novas perguntas: desativado por defeito. Enquanto estiver desativado, nenhuma pergunta aparece na loja antes da sua aprovação.
• Só os clientes autenticados podem colocar uma pergunta: desativado por defeito. Os visitantes convidados podem colocar uma pergunta indicando um nome e um endereço de e-mail.

Respostas da comunidade

• Autorizar as respostas da comunidade: ativado por defeito. Os visitantes podem responder às perguntas já aprovadas.
• Moderar as respostas da comunidade: ativado por defeito. Esta definição é independente da das perguntas. As respostas do comerciante nunca passam pela moderação: são publicadas imediatamente.
• Ativar os votos « Útil » nas respostas: ativado por defeito. O contador de votos alimenta o campo upvoteCount dos dados estruturados.

Apresentação e SEO

• Número de perguntas apresentadas por produto: 5 por defeito. Acima disso, um botão « Ver mais perguntas » revela o resto do fio.
• Injetar os dados estruturados QAPage: ativado por defeito.
• Mostrar a caixa de consentimento RGPD aos convidados: ativado por defeito.

Notificações por e-mail

• Avisar o comerciante a cada nova pergunta: ativado por defeito.
• Endereço de e-mail de notificação: deixe vazio para usar o endereço da loja.
• Avisar o cliente quando a sua pergunta recebe uma resposta: ativado por defeito. O e-mail é enviado quando uma resposta do comerciante é publicada numa pergunta aprovada. Se responder a uma pergunta ainda pendente, o e-mail parte no momento da sua aprovação.

Utilização no front-office

O bloco é apresentado sob a ficha de produto, através do hook displayFooterProduct. Tem três zonas.

Colocar uma pergunta

Um botão « Fazer uma pergunta sobre este produto » abre o formulário. Para um cliente autenticado, o nome é pré-preenchido na forma « Nome A. » e o endereço de e-mail é retomado da conta. Para um visitante convidado, são pedidos o nome e o endereço de e-mail; o endereço nunca é mostrado publicamente. O envio é feito em AJAX, sem recarregar a página.

Consultar as respostas

Cada pergunta mostra as suas respostas aprovadas, ordenadas automaticamente: primeiro a resposta do comerciante, destacada sobre fundo verde com a etiqueta « Resposta oficial », depois as respostas da comunidade classificadas por número de votos decrescente. Um botão « Útil » permite votar; o voto duplo a partir do mesmo navegador é bloqueado.

Responder a uma pergunta

Se as respostas da comunidade estiverem ativadas, aparece uma ligação « Responder a esta pergunta » sob cada fio. A resposta é submetida a moderação ou publicada imediatamente consoante a sua definição.

Moderação no back-office

O separador Catálogo > P&R de Produtos lista todas as perguntas com o seu produto, o seu autor, o seu número de respostas, o seu estado e a sua data. Os filtros e a ordenação funcionam em cada coluna.

Ações em massa

Selecione várias perguntas para as aprovar, rejeitar ou eliminar numa só operação. A eliminação de uma pergunta implica a de todas as suas respostas.

Vista detalhada

O botão « Ver » abre o detalhe de uma pergunta. Encontra aí:

• o produto em causa, com uma ligação para a sua ficha no back-office e na loja;
• o autor e o seu endereço de e-mail, clicável;
• dois botões para aprovar ou rejeitar a pergunta;
• a tabela de todas as suas respostas, do comerciante e da comunidade, com o seu estado, o seu número de votos e ações unitárias de aprovação, rejeição e eliminação;
• um campo de resposta do comerciante.

Responder como comerciante

Escreva a sua resposta no campo previsto e clique em Publicar a resposta. É publicada imediatamente, assinada com o nome da sua loja e marcada « Resposta oficial ». Se a pergunta ainda estiver pendente, uma caixa marcada por defeito aprova-a ao mesmo tempo, o que torna o fio visível num só gesto. O cliente é então avisado por e-mail.

Dados estruturados QAPage

Em qualquer ficha de produto com pelo menos uma pergunta aprovada, o módulo injeta no cabeçalho um bloco JSON-LD do tipo QAPage. A estrutura produzida é a seguinte:

• cada pergunta torna-se uma entidade Question com o seu name, o seu text, o seu answerCount, a sua dateCreated e o seu author;
• a resposta do comerciante torna-se a acceptedAnswer, com um autor do tipo Organization;
• as respostas da comunidade tornam-se suggestedAnswer, com um autor do tipo Person;
• cada resposta transporta o seu upvoteCount, alimentado pelos votos « Útil », e um url que aponta para a sua âncora na ficha de produto.

Antispam e RGPD

Proteções integradas

• Honeypot: um campo invisível para o utilizador está presente no formulário. Os robôs que preenchem todos os campos são afastados silenciosamente.
• Anti-flood: um mesmo autor não pode enviar várias perguntas seguidas.
• Moderação: o filtro final, ativado por defeito.
• Autenticação obrigatória: a opção mais estrita, a ativar se o spam persistir.

Dados pessoais

O módulo recolhe o nome e o endereço de e-mail dos visitantes convidados. O endereço nunca é mostrado publicamente: serve unicamente para enviar a notificação de resposta. A caixa de consentimento RGPD, mostrada aos convidados, está ativada por defeito. As perguntas e respostas de um produto eliminado são apagadas automaticamente.

Compatibilidade técnica

• PrestaShop: 8.0 a 9.x
• PHP: 7.4 a 8.3
• Multiloja: sim, as perguntas são separadas por loja
• Hooks utilizados: displayHeader, displayFooterProduct, actionProductDelete
• Idiomas: FR, EN, ES, DE, IT (português a traduzir manualmente, ver o aviso no topo)

Resolução de problemas

O bloco não aparece na ficha de produto

Verifique que o módulo está ligado ao hook displayFooterProduct a partir de Design > Posições. Alguns temas personalizados não chamam este hook: nesse caso, adicione a sua chamada no template de produto do seu tema.

As perguntas enviadas não aparecem

É o comportamento esperado: a moderação está ativada por defeito. Vá a Catálogo > P&R de Produtos e aprove a pergunta. Para publicar sem moderação, ative a aprovação automática na configuração.

O JSON-LD não está presente na página

O bloco só é injetado se a ficha tiver pelo menos uma pergunta aprovada e se a opção correspondente estiver ativada. Limpe depois a cache do PrestaShop.

O cliente não recebe o e-mail de resposta

Verifique que a opção de notificação do cliente está ativada e que a pergunta tem um endereço de e-mail (os clientes autenticados usam o da sua conta). O e-mail só é enviado uma vez por pergunta, na publicação de uma resposta do comerciante, e unicamente se a pergunta estiver aprovada.