SOQVER Prepare a source
English

SO4AG Facts for WordPress

A free plugin that publishes the facts of your business on your own site so that AI assistants and other programs can use them correctly: what applies, for whom, and until when. Prices, hours, payment, shipping, cancellation, warranty.

Download the plugin (ZIP, version 0.1.0) Read the manual

Free, no account, no paid features. Works with WooCommerce. WordPress 6.4 or newer, PHP 7.4 or newer. License GPL-2.0-or-later.

What the plugin puts on your site

A file for programs

https://your-site.com/so4ag.json

Every fact in the open SO4AG format. Anyone can read it, with no key and no sign-up.

A page for people

A "Facts and terms" table on any page: the fact, its value, who it applies to and until when.

Added with a block or the shortcode [so4ag_facts].

Structured data

The same facts as JSON-LD (schema.org) in the code of that page, for search engines and tools that already read JSON-LD.

How it works

1. You write the facts down

In the WordPress admin. With WooCommerce you start with one button: the plugin suggests shipping prices and payment methods from your store settings.

2. You confirm them

Nothing goes public by itself. Publishing needs your explicit confirmation that the facts are true.

3. They are public in three forms

The file, the page and the JSON-LD always carry the same, last confirmed version. Unfinished edits stay private.

4. The plugin watches the dates

Every fact has a last day on which it applies. Two weeks before, the admin reminds you to review it and confirm it again.

What every fact carries

Manual, step by step

The names of tabs and buttons below are written as you see them in the plugin.

Contents: 1. Install · 2. Your business · 3. Add facts · 4. Conditions · 5. WooCommerce · 6. Publish · 7. The page · 8. Check · 9. Keep it current · 10. llms.txt · 11. Troubleshooting

1. Install the plugin

  1. Download the ZIP from this page. In the WordPress admin open Plugins → Add New → Upload Plugin, choose the downloaded file and select Install Now.
  2. Select Activate. A new item SO4AG Facts appears in the admin menu.

2. Tell it who you are

On the Business tab check the name of your business, pick the kind of business and add registration identifiers if you want (a scheme and a value, for example ein and your EIN, or vat and a VAT number). The contact for corrections is optional and public.

3. Add your facts

On the Facts tab pick a kind of fact and select Add. Every fact asks for four things:

  1. The value, or We do not state this, or It does not apply to us.
  2. Conditions (Applies to): only those the fact really depends on.
  3. The last day it applies (Applies until).
  4. The page, where your website says it (Page that states it). If you leave it empty, the fact is published as your own statement.
FactWhere to find itRequired conditionLongest
Operatorfooter, terms–400 days
Locationcontact page: address and hours–180 days
Contactcontact pagechannel180 days
Priceprice listitem60 days
Payment methodsterms, checkout–180 days
Booking required, Response timebooking page, contact page–90 days
Free cancellation, Cancellation feecancellation policy–90 days
Guaranteewarranty policy–180 days
Accepts new customerscontact page–30 days
Shipping priceshipping pagecountry, delivery_method60 days
Free shipping from, Cash on delivery feeshipping pagecountry / –60 days
Return period, Warranty periodreturn policy, terms–180 days

The plugin offers 25 facts for any business and 10 for an online store. "Longest" is the longest time a fact can be confirmed for at once; the plugin does not accept a later date.

4. How to use conditions

5. A store with WooCommerce

The Suggest from the shop button reads your store settings and prepares suggestions:

You Accept, Complete or Dismiss each suggestion. Suggestions are not public. What the plugin cannot read from the settings (a price given by a formula, free shipping by coupon only, carriers from other plugins) it tells you in a note.

6. Confirm and publish

The Confirm and publish tab shows what will be public and what changed since last time. Check the box that confirms the facts are true today and select Confirm and publish. From then on, anything you edit stays private until you confirm again.

To take the facts down, use Withdraw on the same tab. Your working facts are kept.

7. Show the facts on a page

On the Output and check tab select Create a draft page "Facts and terms", look the page over, publish it and link it from your footer. To place the facts on a page of your own, add the Facts and terms block or the shortcode:

[so4ag_facts]
[so4ag_facts heading="no"]
[so4ag_facts level="h3"]

The plugin adds no link or badge to your site and does not change the output of other plugins. The JSON-LD appears only on pages where you place the facts.

8. Check the result

  1. On the Output and check tab select Check the public addresses too. It checks the structure of the file, the dates, and that the page carries the same facts as the file.
  2. Open the address of the file in a browser: https://your-site.com/so4ag.json
  3. For a second opinion paste that address into the public validator.

9. Keep it current

A fact past its last day stays in the file, but programs treat it as history and the table marks it. The admin warns you 14 days ahead. A sensible rhythm:

10. llms.txt

The plugin can answer at /llms.txt with a short file that points to your facts. It is off by default; you turn it on at the Output and check tab. If your site already has an llms.txt, the plugin leaves it alone and shows the lines you can add to it yourself.

11. Troubleshooting

What you seeWhat to do
/so4ag.json returns "not found"The web server did not pass that address to WordPress. Turn on pretty permalinks (Settings → Permalinks) or ask your host to send requests for missing files to WordPress. Until then the address /?so4ag_facts=json works.
The check says the page carries other facts than the fileA cache holds an older copy of the page. Clear it and check again.
The page has no JSON-LDThe page has neither the block nor the shortcode, or the theme does not call wp_footer().
The plugin refuses a dateEach kind of fact has a longest time it can be confirmed for. Pick an earlier date and confirm it again later.
The site runs on httpThe file is served, but programs expect it over https.

What the plugin does not do

For developers and agencies

Do you build or maintain client sites? Setting up the facts is work you bill yourself, and because facts have a limited validity, somebody has to review them regularly. If a client also takes monitoring from the SOQVER service, the partner program pays you a share of that subscription. The account and the facts belong to the client.

Partner program The format and tools for developers

The source code of the plugin is in the package, licensed GPL-2.0-or-later. SO4AG is an open format and a working draft: the specification, the validator and the readers are free. Specification · GitHub

Frequently asked questions

Do I need an account or a paid service?

No. Entering the facts, publishing, the file, the page, the JSON-LD and the check all work in the plugin alone.

Does it work with my SEO plugin?

Yes. The plugin does not touch the output of other plugins. It adds its own JSON-LD block only to pages where you place the facts.

What happens when a fact reaches its date?

It stays in the file, but programs treat it as history and the table marks it as no longer valid. Review it, set a new date and confirm again.

What is removed when I delete the plugin?

Its settings, the working facts and the published version. Pages you created stay, without the table.

Download the plugin (ZIP, version 0.1.0)