Description
Fardo AI Visibility makes your WordPress site easy for AI crawlers (ChatGPT, Claude, Perplexity, Gemini, Grok, and others) to understand, and lets you monitor your brand’s visibility in AI engines from inside wp-admin.
What the plugin does locally
- AI Feed (opt-in, 5 files served from your site root):
/llms.txtand/llms-full.txt— short and full Markdown maps of your site for LLMs, following the llmstxt.org standard./ai-feed.jsonld— JSON-LD feed withOrganization,WebSiteand anItemListof recent content./ai-overview.html— bare-HTML summary of your brand and content./sitemap-ai.xml— AI-specific sitemap (home + pages + posts, ordered by modification)./robots.txt— extension that explicitly allows known AI crawlers and references the AI sitemap.
- Bot Traffic tracking: detects visits from 24 known AI/LLM crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc.) via User-Agent and logs them to a custom table, with a sparkline view of the last 30 days inside wp-admin.
- Schema.org JSON-LD: injects
OrganizationandWebSiteJSON-LD in the<head>of your front-end (toggleable).
All five AI Feed files are opt-in: nothing is served at any public URL until you turn it on from the plugin’s settings.
What the plugin does with the Fardo platform (optional, requires connecting an account)
If you choose to connect a Fardo account through the OAuth flow inside the plugin, you also get:
- Hub: your AI Score (0–100) with breakdown by AEO, GEO and LLMO, and a hero chart with the historical evolution of your score.
- Rankings: competitive ranking by industry, plus a comparison of your brand against the competitors you defined during onboarding.
- AI Feed (custom): regenerate the five AI Feed files with content tailored to your brand (uses AI research over your site and public sources) and edit any file inline from wp-admin.
- Company configuration: edit the brand info (name, industry, value proposition, competitors, keywords) that Fardo uses to compute your score.
Connecting an account is completely optional. Without an account, the plugin still serves the AI Feed and tracks bot traffic.
External services
This plugin can communicate with two external services operated by Fardo. No data leaves your site unless you trigger the connection or features that require them.
- Fardo platform (
https://platform-fardo.com) — Used when you click “Connect with Fardo” in Settings (OAuth consent), when the plugin requests a new AI analysis on your behalf, or when the plugin polls the status of that analysis. Data sent: the brand information you fill in (brand name, industry, market, target audience, value proposition, competitors, keywords) and the domain of your site. Privacy policy and terms: https://platform-fardo.com. - Fardo API gateway — Used to fetch your AI Score, the industry ranking, the hero chart, and to trigger the optional custom AI Feed generation. Authenticated requests use an OAuth access token that the plugin stores encrypted in your database and never exposes to the browser.
The plugin does not send any data to either service until you explicitly connect an account or toggle a feature that requires the connection.
Source Code
This plugin ships with compiled admin assets (under assets/dist/). The full,
uncompiled source code (React + TypeScript, built with Vite) is publicly available at:
https://github.com/heyfardo/plugin-wordpress
To build the admin assets from source:
- npm install
- npm run build
The compiled output is written to assets/dist/.
Screenshots
Installation
- Upload the plugin folder (
fardo-ai-visibility/) to the/wp-content/plugins/directory, or install through the WordPress Plugins screen directly. - Activate the plugin through the Plugins screen in WordPress.
- Open the Fardo AI menu in the wp-admin sidebar.
- (Optional) Click Connect with Fardo in Settings to link a Fardo account and unlock the Hub, Rankings and custom AI Feed features.
- Go to the AI Feed tab and toggle on the files you want your site to serve publicly.
FAQ
-
Does the plugin work without a Fardo account?
-
Yes. The AI Feed (five files), bot traffic tracking, and Schema.org JSON-LD all work locally without connecting any account. The Hub, Rankings, hero chart, custom AI Feed generation, and company configuration require a Fardo account because they depend on data computed by the Fardo platform.
-
Does the plugin send any data to external servers by default?
-
No. The plugin does not communicate with any external service until you either (1) click “Connect with Fardo” in Settings, or (2) trigger a feature that explicitly requires the platform (such as a new analysis or custom AI Feed generation). See the External services section above for the full list.
-
Where are OAuth tokens stored?
-
OAuth tokens are stored encrypted (OpenSSL AES-256-CBC) in your site’s
wp_optionstable. They are never exposed to the browser or to the React admin app — only the server-side PHP code uses them when calling the Fardo gateway. -
Why are the AI Feed files not visible at my site’s URLs after activating the plugin?
-
Because the AI Feed is opt-in. Go to Fardo AI AI Feed and toggle the files you want your site to serve. Each file maps to its own setting flag and is served only when enabled.
-
How does the plugin detect AI bots?
-
It matches the request’s User-Agent against a curated list of 24 known AI/LLM crawler patterns (GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot, Google-Extended, Bytespider, CCBot, and others) and logs matches to a custom table.
-
What happens to my data when I uninstall the plugin?
-
The plugin’s
uninstall.phpdeletes its custom database table ({prefix}_fardo_bot_hits), removes all itswp_optionsentries (including encrypted OAuth tokens), and clears its transients. Uninstalling does not affect any other plugin or theme data.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Fardo AI Visibility” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Fardo AI Visibility” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.2.0
- Rankings now authenticate with the user’s OAuth token instead of a shared API key. The plugin no longer requires (or accepts) any shared secret to display the industry ranking; connecting a Fardo account is enough.
- Removed the legacy
/fardo/company-configREST route and theranking_api_keysetting (superseded by the OAuth-authenticated/company/configand Bearer-authenticated ranking endpoint). - Cleaner uninstall: now also sweeps parameterized transients (ranking cache, score cache, AI Feed overrides) on plugin delete.
0.1.0
- Initial release.
- AI Feed: five opt-in files (
llms.txt,llms-full.txt,ai-feed.jsonld,ai-overview.html,robots.txtextension,sitemap-ai.xml). - Bot Traffic: 24-pattern AI crawler detection with sparkline view (30 days).
- Schema.org JSON-LD:
OrganizationandWebSiteinjection in<head>. - OAuth connection to the Fardo platform with encrypted token storage.
- Hub, Rankings, hero chart and company configuration for connected accounts.
- Inline editor and custom AI-generated content for the AI Feed (paid plans).