# 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,…

- Página: <https://www.datafirefly.com/pt/documentation/dfproductqa/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfproductqa/index.md), [en](https://www.datafirefly.com/en/documentation/dfproductqa/index.md), [es](https://www.datafirefly.com/es/documentation/dfproductqa/index.md), [de](https://www.datafirefly.com/de/documentation/dfproductqa/index.md), [it](https://www.datafirefly.com/it/documentation/dfproductqa/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfproductqa/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfproductqa/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## 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.

O módulo não depende de nenhuma biblioteca externa: nem Composer, nem jQuery. O CSS e o JavaScript só são carregados nas páginas de produto.

O pacote de traduções do módulo cobre FR, EN, ES, DE e IT. Numa loja em português, traduza as cadeias do front-office (botão « Fazer uma pergunta », etiqueta « Resposta oficial », botão « Útil ») em **Internacional > Traduções > Módulos instalados**, caso contrário o visitante verá o inglês.

## 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.

Depois de aprovar as suas primeiras perguntas, valide uma ficha de produto no teste de resultados enriquecidos do Google e peça depois uma reindexação a partir da Search Console. A apresentação efetiva do acordeão fica ao critério do Google.

## 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.