SOQVER Preparar uma fonte
Português

SO4AG Facts para WordPress

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.

O que o plugin adiciona ao seu site

Um arquivo para programas

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 página para pessoas

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

Dados estruturados

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.

Como funciona

1. Você registra os fatos

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.

2. Você confirma os fatos

Nada é publicado automaticamente. Para publicar, você precisa confirmar expressamente que os dados são verdadeiros.

3. Os fatos ficam públicos de três formas

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.

4. O plugin monitora as datas

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.

O que cada dado inclui

Manual passo a passo

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

1. Instale o plugin

  1. Baixe o arquivo ZIP nesta página. No painel de administração do WordPress, abra Plugins → Add New → Upload Plugin, escolha o arquivo baixado e selecione Install Now.
  2. Selecione Activate. O novo item SO4AG Facts aparece no menu de administração.

2. Informe quem você é

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.

3. Adicione seus dados

Na aba Facts, escolha um tipo de dado e selecione Add. Cada dado pede quatro informações:

  1. O valor, ou We do not state this, ou It does not apply to us.
  2. Condições (Applies to): apenas aquelas das quais o dado realmente depende.
  3. O último dia de validade (Applies until).
  4. A página do seu site que apresenta essa informação (Page that states it). Se deixar o campo em branco, o fato será publicado como uma declaração sua.
FatoOnde encontrarCondição obrigatóriaMais longo
Operadorrodapé, termos–400 dias
Localizaçãopágina de contato: endereço e horários–180 dias
Contatopágina de contatochannel180 dias
Preçotabela de preçositem60 dias
Formas de pagamentotermos, finalização da compra–180 dias
Reserva obrigatória, Tempo de respostapágina de reservas, página de contato–90 dias
Cancelamento gratuito, Taxa de cancelamentopolítica de cancelamento–90 dias
Garantiapolítica de garantia–180 dias
Aceita novos clientespágina de contato–30 dias
Valor do fretepágina de informações sobre fretecountry, delivery_method60 dias
Frete grátis a partir de, Taxa de pagamento na entregapágina de informações sobre fretecountry / –60 dias
Prazo de devolução, Prazo de garantiapolí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.

4. Como usar condições

5. Uma loja com WooCommerce

O 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).

6. Confirme e publique

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.

7. Exiba os dados em uma página

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.

8. Confira o resultado

  1. Na aba Output and check, selecione Check the public addresses too. A verificação confere a estrutura do arquivo, as datas e se a página apresenta os mesmos fatos que o arquivo.
  2. Abra o endereço do arquivo em um navegador: https://your-site.com/so4ag.json
  3. Para uma segunda verificação, cole esse endereço no validador público.

9. Mantenha os dados atualizados

Um 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:

10. llms.txt

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.

11. Solução de problemas

O que apareceO 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 arquivoO cache guarda uma versão anterior da página. Limpe o cache e verifique novamente.
A página não tem JSON-LDA página não tem o bloco nem o shortcode, ou o tema não chama wp_footer().
O plugin rejeita uma dataCada 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 httpO arquivo está disponível, mas os programas esperam acessá-lo via https.

O que o plugin não faz

Para desenvolvedores e agências

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

Perguntas frequentes

Preciso de uma conta ou de um serviço pago?

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.

Funciona com meu plugin de SEO?

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 que acontece quando um fato chega à data de vencimento?

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.

O que é removido quando excluo o plugin?

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.

Baixar o plugin (ZIP, versão 0.1.0)