Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/augustoviante1981/faq-schema-generator/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
O que o plugin faz
Adiciona uma seção de FAQ (perguntas e respostas) a qualquer post ou página, gerando automaticamente:
- O HTML visual em formato de acordeão.
- O JSON-LD (Schema.org FAQPage), usado pelo Google para exibir rich snippets de FAQ nos resultados de busca.
Novidades da versão 1.2.1
- Correção: a cor selecionada agora é aplicada como cor de FUNDO de toda a linha da pergunta ao passar o mouse (antes só mudava a cor do texto, o que fazia o fundo preto padrão do tema aparecer). O texto muda para branco automaticamente ao passar o mouse, para manter a legibilidade.
Novidades da versão 1.2.0
- Campo de "Título do FAQ": aparece acima da lista de perguntas (opcional). Também é enviado como "name" no JSON-LD.
- Seletor de cor: escolha a cor que aparece ao passar o mouse (ou focar) sobre uma pergunta. A mesma cor é usada no número da pergunta e nos links dentro das respostas.
- Numeração automática: cada pergunta exibe seu número (1, 2, 3...) na ordem definida — inclusive após reordenar via drag-and-drop.
Novidades da versão 1.1.0
- Reordenação das perguntas por drag-and-drop (arraste pelo ícone ao lado de cada pergunta, usando o jQuery UI já incluso no WordPress).
- Respostas agora aceitam HTML rico (negrito, itálico, links, listas, citações) através da barra Quicktags do WordPress. O conteúdo é sanitizado com wp_kses_post() ao salvar, permitindo apenas tags seguras.
- No JSON-LD (schema.org), o texto da resposta é enviado sem tags HTML, conforme recomendado pelo Google, mesmo que a exibição visual mantenha a formatação.
Instalação
- Compacte a pasta "faq-schema-generator" em um arquivo .zip (ou use o .zip já gerado).
- No painel do WordPress, vá em Plugins > Adicionar novo > Enviar plugin.
- Selecione o .zip e clique em "Instalar agora".
- Ative o plugin.
Como usar
-
Edite um post ou página.
-
Role até a caixa "FAQ Schema Generator" abaixo do editor.
-
Clique em "+ Adicionar Pergunta" e preencha pergunta/resposta. Repita para quantas perguntas quiser.
-
Salve/atualize o post.
-
No conteúdo do post, insira o shortcode:
[faq_schema]
-
Publique. O FAQ aparecerá visualmente na página, e o Schema.org FAQPage será inserido automaticamente no /corpo da página (você pode validar em https://search.google.com/test/rich-results).
Notas
- Cada post/página tem seu próprio conjunto de perguntas (armazenadas como post meta).
- O texto das perguntas/respostas é sanitizado antes de salvar.
- Não depende de nenhuma biblioteca externa.