Um plugin gratuito que publica os dados da sua empresa no seu próprio site para que assistentes de IA e outros programas possam usá-los corretamente, sabendo o que se aplica, a quem e até quando. Preços, horários, formas de pagamento, envio, cancelamento e garantia.
Baixar o plugin (ZIP, versão 0.1.0) Leia o manual
Gratuito, sem conta e sem recursos pagos. Funciona com WooCommerce. WordPress 6.4 ou posterior, PHP 7.4 ou posterior. Licença GPL-2.0-or-later.
https://your-site.com/so4ag.json
Todos os dados no formato aberto SO4AG. Qualquer pessoa pode ler o arquivo, sem chave de acesso nem cadastro.
Uma tabela de "Dados e condições" em qualquer página, com cada dado, seu valor, a quem se aplica e até quando.
Adicione a tabela com um bloco ou com o shortcode [so4ag_facts].
Os mesmos dados em JSON-LD (schema.org) no código dessa página, para mecanismos de busca e ferramentas que já leem JSON-LD.
No painel de administração do WordPress. Com o WooCommerce, basta clicar em um botão para começar. O plugin sugere valores de frete e formas de pagamento com base nas configurações da sua loja.
Nada é publicado automaticamente. Para publicar, você precisa confirmar expressamente que os dados são verdadeiros.
O arquivo, a página e o JSON-LD sempre apresentam a mesma versão, a última que você confirmou. As alterações em andamento ficam privadas.
Cada dado tem uma data final de validade. Duas semanas antes dessa data, o painel de administração lembra você de revisar o dado e confirmá-lo novamente.
Os nomes das abas e dos botões abaixo aparecem como no plugin.
Conteúdo: 1. Instalação · 2. Sua empresa · 3. Adicionar fatos · 4. Condições · 5. WooCommerce · 6. Publicar · 7. A página · 8. Verificar · 9. Manter os fatos atualizados · 10. llms.txt · 11. Solução de problemas
Na aba Business, confira o nome da sua empresa, escolha o tipo de empresa e, se quiser, adicione identificadores de registro (um esquema e um valor, como ein e seu EIN, ou vat e um número de IVA). O contato para correções é opcional e público.
Na aba Facts, escolha um tipo de dado e selecione Add. Cada dado pede quatro informações:
| Fato | Onde encontrar | Condição obrigatória | Mais longo |
|---|---|---|---|
| Operador | rodapé, termos | – | 400 dias |
| Localização | página de contato: endereço e horários | – | 180 dias |
| Contato | página de contato | channel | 180 dias |
| Preço | tabela de preços | item | 60 dias |
| Formas de pagamento | termos, finalização da compra | – | 180 dias |
| Reserva obrigatória, Tempo de resposta | página de reservas, página de contato | – | 90 dias |
| Cancelamento gratuito, Taxa de cancelamento | política de cancelamento | – | 90 dias |
| Garantia | política de garantia | – | 180 dias |
| Aceita novos clientes | página de contato | – | 30 dias |
| Valor do frete | página de informações sobre frete | country, delivery_method | 60 dias |
| Frete grátis a partir de, Taxa de pagamento na entrega | página de informações sobre frete | country / – | 60 dias |
| Prazo de devolução, Prazo de garantia | política de devolução, termos | – | 180 dias |
O plugin oferece 25 dados para qualquer empresa e 10 para uma loja virtual. “Prazo máximo” é o maior período de validade que se pode confirmar para um dado de uma só vez. O plugin não aceita uma data posterior a esse limite.
customer: business vale apenas para empresas. Um programa que consulta preços para uma pessoa física não usará esse preço.any indica explicitamente que o fato vale para todos os valores.item) sempre da mesma forma. Para um programa, "limpeza dentária" e "limpeza" são duas coisas diferentes.Mo-Fr 09:00-18:00; Sa 09:00-12:00O botão Suggest from the shop lê as configurações da sua loja e prepara sugestões:
Para cada sugestão, use Accept, Complete ou Dismiss. As sugestões não são públicas. Uma nota indica o que o plugin não consegue ler nas configurações (um preço calculado por fórmula, frete grátis disponível apenas com cupom ou transportadoras de outros plugins).
A aba Confirm and publish mostra o que ficará público e o que mudou desde a última vez. Marque a caixa para confirmar que os fatos estão corretos hoje e selecione Confirm and publish. A partir daí, qualquer alteração ficará privada até que você confirme novamente.
Para retirar os fatos do ar, use Withdraw na mesma aba. Os fatos em edição ficam salvos.
Na aba Output and check, selecione Create a draft page "Facts and terms", revise a página, publique-a e adicione um link para ela no rodapé. Para exibir os fatos em uma página sua, adicione o bloco Facts and terms ou o shortcode:
[so4ag_facts]
[so4ag_facts heading="no"]
[so4ag_facts level="h3"]
O plugin não adiciona links nem selos ao seu site e não altera o conteúdo gerado por outros plugins. O JSON-LD aparece apenas nas páginas em que você inserir os fatos.
https://your-site.com/so4ag.jsonUm dado vencido permanece no arquivo, mas os programas o tratam como histórico e a tabela o sinaliza. O painel de administração avisa você com 14 dias de antecedência. Frequência de revisão sugerida:
O plugin pode responder no endereço /llms.txt com um arquivo curto que aponta para os seus fatos. O recurso vem desativado por padrão e pode ser ativado na aba Output and check. Se o seu site já tiver um llms.txt, o plugin o mantém como está e mostra as linhas que você pode adicionar manualmente.
| O que aparece | O que fazer |
|---|---|
/so4ag.json retorna "não encontrado" | O servidor web não encaminhou esse endereço ao WordPress. Ative os links permanentes amigáveis (Settings → Permalinks) ou solicite ao seu provedor de hospedagem que encaminhe ao WordPress as solicitações de arquivos não encontrados. Até lá, o endereço /?so4ag_facts=json funciona. |
| A verificação indica que os fatos da página diferem dos fatos do arquivo | O cache guarda uma versão anterior da página. Limpe o cache e verifique novamente. |
| A página não tem JSON-LD | A página não tem o bloco nem o shortcode, ou o tema não chama wp_footer(). |
| O plugin rejeita uma data | Cada tipo de fato tem um prazo máximo de validade por confirmação. Escolha uma data mais próxima e confirme o fato novamente mais tarde. |
| O site usa http | O arquivo está disponível, mas os programas esperam acessá-lo via https. |
Você cria ou mantém sites de clientes? Você cobra diretamente pelo trabalho de configurar os fatos. Como eles têm validade limitada, alguém precisa revisá-los regularmente. Se um cliente também contratar o monitoramento da SOQVER, o programa de parceiros pagará a você uma parte do valor da assinatura. A conta e os fatos pertencem ao cliente.
Programa de parceiros O formato e as ferramentas para desenvolvedores
O código-fonte do plugin vem no pacote e está sob a licença GPL-2.0-or-later. O SO4AG é um formato aberto em fase de elaboração. A especificação, o validador e as ferramentas de leitura são gratuitos. Especificação · GitHub
Não. O próprio plugin permite inserir e publicar os fatos, disponibiliza o arquivo, a página e o JSON-LD e faz a verificação.
Sim. O plugin não altera o conteúdo gerado por outros plugins. Ele adiciona seu próprio bloco JSON-LD apenas às páginas em que você insere os fatos.
O fato permanece no arquivo, mas os programas o tratam como um registro histórico e a tabela indica que ele perdeu a validade. Revise o fato, defina uma nova data e confirme-o novamente.
As configurações do plugin, os fatos em edição e a versão publicada. As páginas que você criou permanecem, sem a tabela.