Description
Inclusive Forge audits European online stores against WCAG 2.1 AA and EN 301 549, records what was found and what was fixed, and publishes an accessibility statement from that record. The audit, the evidence log and the statement live in your Inclusive Forge account. This plugin is the small piece that has to run on your site. It requires an Inclusive Forge account, works on any WordPress site and is built for WooCommerce stores.
What the plugin does:
- Proves you own the site. It adds a
<meta name="inclusiveforge-verify" content="…">tag to your<head>. Our scanner reads that tag before it audits anything, so a site is never scanned on the word of whoever filled in a form. - Publishes your accessibility statement. The
[inclusiveforge_statement]shortcode and the matching block render the statement you published in Inclusive Forge. English, German and French are available. The document is fetched over HTTPS and cached locally for 12 hours; the request times out after five seconds. - Shows your last scan in wp-admin. A “Last scan” card on the settings screen and a dashboard widget show the score, open and closed findings and the date, filled in automatically when a scan finishes.
- Lets you ask for a re-test. The “Re-test now” button asks Inclusive Forge to scan the site again. Your account’s monthly allowance is enforced by Inclusive Forge, and the button tells you how many re-tests you have left.
- Checks that verification really works. The settings screen fetches your own home page and confirms the verification tag is there, and it lists known cache and optimisation plugins that sometimes strip it.
What this plugin deliberately does not do
- No overlay. It never modifies, re-labels or “corrects” your pages in the browser. Real fixes belong in your theme and templates, and Inclusive Forge reports them there.
- No JavaScript and no CSS on your storefront. The statement is plain server-rendered HTML that inherits your theme. The only JavaScript in this plugin runs in the block editor.
- No scanning from inside your site. Nothing crawls your pages from your own server, and no background job competes with your store.
- No tracking and no analytics.
Honest scope
An automated scan detects a portion of WCAG 2.1 AA issues, not all of them, and no plugin can make a website accessible on its own. Inclusive Forge offers a documented process (scan, fix, re-test, evidence log, statement), not a compliance guarantee. This plugin and the Inclusive Forge service do not provide legal advice; talk to a qualified adviser about your obligations.
For developers
The plugin fires an inclusiveforge/scan_completed action every time a signed scan-completed notice is verified and stored, with the score, the finding counts, the finish date and the report URL.
Documentation: https://inclusiveforge.com/docs/
External services
This plugin connects to one third-party service. It is not optional: without it there is no statement to render and no store to connect.
- Inclusive Forge (https://inclusiveforge.com, run by Avakode) — hosts your accessibility statement, verifies site ownership, and runs the scans this plugin reports on. The plugin talks to its API at https://app.inclusiveforge.com:
GET /public/statement/{site token}?locale=…for the statement andPOST /public/rescan/{site token}for a re-test.- What is sent: your Inclusive Forge site token (in the request path) and your site address (in the
User-Agentheader of the request). When a webhook secret is saved, the statement request also carries anX-Inclusiveforge-Signatureheader: a signature over the textstatement:plus your site token, with a timestamp and a one-time value, made with your webhook secret; the secret itself never leaves your site. When you press “Re-test now”, a signed, empty request authenticated with your webhook secret asking the scan to be run again. Nothing else — no post content, no order data, no customer data, no visitor IP addresses, no administrator details. - When it is sent: only once a site token is saved; with none, the plugin sends nothing. Then: when a page containing the shortcode or block is rendered, or the plugin’s settings screen is opened, and the cached statement is missing or older than 12 hours; when a failed request is retried (at most once every 15 minutes); when you press “Refresh statement cache”; and when you press “Re-test now”. Pages without the shortcode or block send nothing.
- What comes back: the HTML of your published accessibility statement, or an error saying the site is unknown or not verified yet; a re-test request answers with an accepted scan or a named reason it was refused, including your remaining monthly allowance.
- What this address sends back to your site, unprompted: when a scan it ran finishes, it calls your site’s own REST API (
/wp-json/inclusiveforge/v1/scan-completed) with the score, the open/closed finding counts, the date, and a link back to the full report. This plugin verifies a cryptographic signature on that request, using the same webhook secret, before storing anything from it — an unsigned or incorrectly signed request is rejected and changes nothing on your site. - The link visitors may see: when your site token is fine but the plugin could not fetch the statement (a timeout, for example), visitors see a plain link, “View our accessibility statement”, to
https://inclusiveforge.com/<language>/a11y/<site token>, the same statement on Inclusive Forge’s own site. The plugin sends nothing there; a visitor’s browser contacts inclusiveforge.com only if the visitor follows the link. - The endpoint address can be overridden for staging by defining
INCLUSIVEFORGE_API_BASEinwp-config.php. - Terms: https://inclusiveforge.com/terms — Privacy: https://inclusiveforge.com/privacy
- What is sent: your Inclusive Forge site token (in the request path) and your site address (in the
Your site token is also published in the verification meta tag in your site’s <head>, which is what makes ownership checkable from outside. It identifies the site to Inclusive Forge; it does not grant access to your Inclusive Forge account. The webhook secret is a separate value, used only to authenticate the scan-completed notice and the re-test request in both directions; it is never displayed anywhere on your storefront.
The plugin’s own “verification health” check on the settings screen fetches your site’s own home page — a request to your own site, not to a third party — to confirm the verification tag actually reaches visitors. The answer is kept for five minutes, so reopening the screen does not fetch again.
Installation
- Upload
inclusiveforgeto/wp-content/plugins/, or install it from Plugins → Add New. - Activate the plugin.
- Go to Settings → Inclusive Forge. Paste the site token and the webhook secret from your Inclusive Forge dashboard (Accessibility statement, then Connect the companion plugin).
- Start the verification check from your Inclusive Forge dashboard. The status on the settings screen turns green when it passes.
- Add
[inclusiveforge_statement]to your accessibility statement page, or insert the Accessibility Statement block.
FAQ
Is this a plugin or a service?
Both. The scanning and monitoring run as a service, in your Inclusive Forge portal. This plugin connects your store to it: you paste the site token and the webhook secret from your portal into its settings. It prints the ownership tag the scanner checks for, publishes your accessibility statement and shows your last scan in wp-admin. It adds nothing else to your storefront: no scripts, no styles.
Do I need an Inclusive Forge account?
Yes. The plugin is a companion to the Inclusive Forge service: it verifies your site and displays a statement produced there. On its own it has nothing to show.
Does this plugin make my site accessible?
No, and be wary of any plugin that says it does. Accessibility is fixed in your theme, templates and content. Inclusive Forge finds issues, tracks them until they are fixed, and documents the process; the fixes are real changes to your site.
Is this an accessibility overlay?
No. Nothing from this plugin runs in your visitors’ browsers. It adds one meta tag and, on the page where you place it, the HTML of your statement.
Will it slow down my store?
No. The statement is cached for 12 hours in a WordPress transient, and a failed request is cached for 15 minutes, so only the page view that refreshes the cache waits on our API, and that request times out after five seconds. Pages without the shortcode or block make no request at all.
What happens if your API is unreachable?
It depends on why. If your site token and language are fine but our servers did not answer, visitors see a plain link to your statement on our own domain instead. If the problem is a configuration one (no token, site not verified, an unrecognised token or language), visitors see nothing at all, no error and no empty box, and a logged-in administrator sees a short note explaining what is wrong.
Can I connect a local or staging site?
No. Inclusive Forge audits public storefronts, and a local or staging address is not reachable from the internet. Connect the plugin on the live store.
Where does the statement HTML come from?
From the statement you published in Inclusive Forge, for the language you selected. It is filtered through wp_kses_post() when it arrives and again before it is printed, so it cannot introduce scripts into your site.
What is deleted when I remove the plugin?
The site token, the webhook secret and the cached statements are always removed, so you would have to connect the site again. The statement language and the last-scan summary stay unless you tick “Delete Inclusive Forge data on uninstall” in Settings → Inclusive Forge before deleting the plugin. On a multisite network every site of the current network is cleaned. Your Inclusive Forge account, scans and evidence log are untouched; delete those from your dashboard.
Screenshots





Changelog
1.4.0
- Uninstalling now keeps your settings and last scan summary unless you tick “Delete Inclusive Forge data on uninstall”.
- A delayed older scan notice no longer replaces the latest scan summary or repeats its completion action.
- Statement requests are signed correctly, and re-test failures explain the reason on the settings screen.
- Removing the plugin clears connection secrets and cached entries from every site in the current network, leaving other networks untouched.
- Local network addresses that could bypass the statement fetch safety check are now rejected.
1.3.2
- Removed: the optional key field on the settings screen and the account-status lines that came with it (added in 1.3.0). Stores that were connected with it stay connected: the site token and webhook secret were saved on their own. Connect a new store by pasting the site token and webhook secret from the Inclusive Forge dashboard.
- Change: the statement HTML is filtered when it arrives, before it is cached, as well as when it is printed.
- Change: the “cache cleared” and “re-test” notices on the settings screen no longer depend on a flag in the address.
- Change: removing the plugin deletes exactly the options and cached entries it created, by name, and no longer flushes the site’s object cache.
- Change: the readme says the plugin works on any WordPress site and is built for WooCommerce stores, describes the statement cache and the home-page check as the code does, and lists the link visitors may see in “External services”.
- Internal: removed a helper class nothing called.
1.3.1
- Fix: the Accessibility Statement block now appears in the block editor’s inserter. Its editor script used to register the block under an old product name, so the block could not be added from the editor. The
[inclusiveforge_statement]shortcode was not affected. - Change: the “External services” section says exactly when the plugin contacts Inclusive Forge and no longer names a service the plugin itself never contacts.
- Change: the translation template now includes the block editor’s strings.
- Change: the readme no longer says a visitor never waits for the statement. The page view that refreshes the 12-hour cache does.
- Internal notes removed from the code comments. No change in behaviour.
1.3.0
- New: an optional key field on the settings screen that connected the store for you and filled in the site token and webhook secret (removed in 1.3.2).
- Fix: a verified site with no published statement yet no longer reads as “Could not reach Inclusive Forge” on the settings screen; it says the statement is still to be published.
1.2.1
- Change: the “Last scan” card and the dashboard widget no longer show one “Closed findings” number. Closed findings are three different facts about a store — marked fixed, accepted risk, false positives — and a single total read as “all of this is fixed”. The
inclusiveforge/scan_completedcounts array carries the same three keys;closedstays as their sum. - Fix: the webhook secret now has somewhere to come from. Open “Accessibility statement” in your Inclusive Forge dashboard and click “Connect the companion plugin” to generate it, then copy it (and the site token next to it) into the field below — 1.2.0 shipped the field with no way to get a value for it.
- Fix:
inclusiveforge/scan_completedno longer fires a second time for the same scan when the portal has to retry a delivery that timed out or was lost. - Fix: the verification health check no longer re-fetches your home page on every visit to the settings screen (the answer is now cached for a few minutes) and no longer follows a redirect while checking it, so a redirecting home page cannot report a stale “visible” result.
1.2.0
- New: signed “scan completed” notice from Inclusive Forge — drops the statement cache and stores a “last scan” summary (score, open/closed findings, date) the moment a scan finishes.
- New: “Last scan” card on the settings screen and a matching wp-admin dashboard widget, both reading that same summary.
- New: “Re-test now” button on the settings screen. Inclusive Forge alone decides whether the monthly allowance of your account permits it; this plugin only shows the answer, including how many re-tests are left this month.
- New: verification health check on the settings screen — fetches your own home page to confirm the verification tag is actually there, and flags known cache/optimisation plugins that can strip it.
- New:
inclusiveforge/scan_completedaction for other plugins to hook. - New: a “Webhook secret” field, alongside the site token, authenticating the scan-completed notice and the re-test request in both directions.
1.1.0
- New: if the plugin’s own fetch to Inclusive Forge fails but your site token is fine, visitors now see a plain link to the hosted statement on inclusiveforge.com instead of nothing at all.
- Fix: an unrecognised configured language or a blocked API address now show the administrator-only setup note instead of a link that would 404 for visitors.
1.0.0
- Initial release: verification meta tag,
[inclusiveforge_statement]shortcode, Accessibility Statement block, and the settings screen.
