# Gerador de FAQ Schema.org: documentação

> Apresentação O DfFaqSchema acrescenta blocos de perguntas e respostas editáveis às páginas de produto, às páginas de categoria e aos layouts Shopping Experiences do Shopware 6. Cada bloco é renderizado…

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

## Apresentação

O DfFaqSchema acrescenta blocos de perguntas e respostas editáveis às páginas de produto, às páginas de categoria e aos layouts Shopping Experiences do Shopware 6. Cada bloco é renderizado como acordeão Bootstrap e acompanhado de uma marcação Schema.org FAQPage em JSON-LD, injetada automaticamente na página. A extensão é compatível com Shopware 6.5, 6.6 e 6.7 e não exige qualquer alteração ao seu tema.

## Instalação

### Pela administração

1. Abra Extensões e depois As minhas extensões e carregue o ficheiro ZIP da extensão.
2. Clique em Instalar e ative a extensão.

### Pela consola

```
bin/console plugin:refresh
bin/console plugin:install --activate DfFaqSchema
bin/console cache:clear
```

### Compilação da administração

O módulo de administração e o elemento CMS exigem uma compilação única dos recursos:

```
./bin/build-administration.sh
```

Sem este passo, o menu FAQ Schema.org e o elemento CMS não aparecem na administração. O storefront, por seu lado, funciona logo após a ativação.

## Configuração

Abra Extensões, As minhas extensões, e depois a configuração do DfFaqSchema. Estão disponíveis duas opções, reguláveis globalmente ou por canal de venda:

- **Apresentar as FAQ nas páginas de produto**: ativa o acordeão e o JSON-LD nas páginas de produto (ativo por predefinição).
- **Apresentar as FAQ nas páginas de categoria**: ativa o acordeão e o JSON-LD nas páginas de navegação (ativo por predefinição).

## Criar entradas de FAQ

Abra Conteúdos e depois FAQ Schema.org. A listagem mostra todas as entradas com a sua pergunta, a sua atribuição, a sua posição e o seu estado.

### Campos de uma entrada

- **Pergunta**: o texto da pergunta (campo traduzido).
- **Resposta**: a resposta em texto formatado através do editor integrado (campo traduzido).
- **Posição**: a ordem de apresentação no acordeão, crescente.
- **Ativo**: só as entradas ativas são apresentadas e marcadas.
- **Atribuição**: produto, categoria ou página CMS. O seletor de tipo mostra o campo de pesquisa correspondente.

### Traduzir uma entrada

Use o seletor de idioma no topo da página de detalhe para mudar de idioma, e introduza a pergunta e a resposta traduzidas. Cada storefront apresenta os conteúdos do seu idioma e o JSON-LD acompanha automaticamente.

Uma entrada sem tradução num idioma recorre ao idioma predefinido do sistema, segundo o mecanismo normal do Shopware.

## Apresentação em produto e categoria

As entradas atribuídas a um produto aparecem sob o conteúdo principal da página de produto. As entradas atribuídas a uma categoria aparecem sob a listagem da página de navegação. Nos dois casos, o JSON-LD FAQPage correspondente é injetado no cabeçalho do documento. A primeira pergunta do acordeão fica aberta por predefinição.

## Elemento CMS para as Shopping Experiences

1. Crie as suas entradas no módulo sem as atribuir a um produto ou a uma categoria (atribuição página CMS).
2. Abra Conteúdos e depois Experiências de compra e edite um layout.
3. Acrescente um bloco de texto e substitua o seu elemento pelo elemento **FAQ (Schema.org)**.
4. Na configuração do elemento, selecione as entradas a apresentar.

O acordeão e o seu JSON-LD são renderizados no local exato do elemento. Pode usar vários elementos FAQ num mesmo layout.

## Marcação JSON-LD e validação

A extensão gera um objeto FAQPage com uma entidade Question por entrada apresentada, com a resposta em HTML no campo text da entidade Answer, o que o Google aceita. A marcação cobre apenas o conteúdo realmente visível na página, em conformidade com as diretrizes de rich results.

Para validar uma página, use o teste de resultados enriquecidos do Google: cole o URL da sua página de produto e verifique que o elemento FAQ é detetado sem erros.

A apresentação efetiva dos rich results fica ao critério do Google, que os reserva sobretudo a sites governamentais e médicos desde 2023. A marcação continua a ser útil para a compreensão das suas páginas pelos motores e pelos assistentes de IA.

## Resolução de problemas

- **O menu FAQ Schema.org não aparece**: execute a compilação da administração e limpe a cache do navegador.
- **O acordeão não aparece numa página de produto**: verifique que a entrada está ativa, que está mesmo atribuída a esse produto e que a opção de apresentação em produto está ativa para o canal de venda em causa.
- **O JSON-LD está ausente**: a marcação só é gerada se pelo menos uma entrada ativa for apresentada na página. Verifique o código-fonte da página pesquisando application/ld+json.
- **O elemento CMS não apresenta nada**: verifique que foram selecionadas entradas na configuração do elemento e que estão ativas.

## Desinstalação

A desinstalação elimina as tabelas da extensão e a sua configuração. Marque a opção de conservação dos dados durante a desinstalação para preservar as suas perguntas e respostas com vista a uma reinstalação.