WORDPRESS PLUGIN + SHOPIFY OS 2.0 EMBEDHTTP 200 /LLMS.TXT · /AGENTS.MD · JSON-LD
Drop-in WordPress & Shopify OS 2.0 connector bridges.
Managed WordPress hosts often block SFTP root uploads, and Shopify theme updates can overwrite manual theme.liquid edits. Use our single-file WordPress plugin or Online Store 2.0 Theme App Embed to keep /llms.txt, /agents.md, and schema.org JSON-LD live across upgrades.
FIG 05 · UPGRADE-SAFE CMS PROTOCOL BRIDGESZERO SFTP REQUIRED
DROP-IN CMS CONNECTOR BRIDGES · ZERO SFTP REQUIRED
Select your CMS connector architectureWORDPRESS 6.0+ · PHP 7.4+ Serves virtual
/llms.txt and /agents.md routes over HTTP 200 directly from WordPress options—no SFTP root access or .htaccess edits required.verisource-geo-connector.php (Single-File WordPress Plugin)
Upload as a .zip in WP Admin -> Plugins -> Add New -> Upload Plugin, or place inside wp-content/plugins/.
wp-content/plugins/verisource-geo-connector/verisource-geo-connector.php
SYNTAX & TRUTH VERIFIED
<?php
/**
* Plugin Name: Verisource AI Facts & GEO Connector
* Plugin URI: https://verisource.dev/connectors
* Description: Serves root /llms.txt and /agents.md over HTTP 200 without SFTP uploads, injects validated schema.org JSON-LD + alternate Markdown discovery links in <head>, and connects AI referral attribution.
* Version: 1.0.0
* Requires at least: 6.0
* Requires PHP: 7.4
* Author: Verisource
* Author URI: https://verisource.dev
* License: GPL-2.0-or-later
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
define( 'VERISOURCE_GEO_CONNECTOR_VERSION', '1.0.0' );
/**
* Render virtual /llms.txt and /agents.md endpoints with clean HTTP 200 headers.
*/
function verisource_geo_serve_virtual_protocol_files() {
if ( is_admin() || empty( $_SERVER['REQUEST_URI'] ) ) {
return;
}
$request_path = wp_parse_url( sanitize_text_field( wp_unslash( $_SERVER['REQUEST_URI'] ) ), PHP_URL_PATH );
if ( '/llms.txt' !== $request_path && '/agents.md' !== $request_path ) {
return;
}
$site_name = get_bloginfo( 'name' ) ? get_bloginfo( 'name' ) : 'Acme Software';
$site_url = home_url( '/' );
if ( '/llms.txt' === $request_path ) {
$llms_body = get_option( 'verisource_llms_txt_body', '' );
if ( empty( trim( $llms_body ) ) ) {
$llms_body = "# " . $site_name . "\n\n> Official machine-readable entity, pricing, and policy specification for " . $site_name . " (" . $site_url . ").\n\nCanonical Website: " . $site_url . "\nAgent Specification: " . home_url( '/agents.md' ) . "\n";
}
status_header( 200 );
header( 'Content-Type: text/plain; charset=utf-8' );
header( 'Cache-Control: public, max-age=3600' );
echo $llms_body; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- plain-text Markdown payload
exit;
}
if ( '/agents.md' === $request_path ) {
$agents_body = get_option( 'verisource_agents_md_body', '' );
if ( empty( trim( $agents_body ) ) ) {
$agents_body = "# " . $site_name . " — Autonomous Agent & Buyer Truth Specification\n\nCanonical Origin: " . $site_url . "\nMachine Summary: " . home_url( '/llms.txt' ) . "\n\n## Verified Commercial Policies\n- Publish verified pricing tiers, service areas, and return policies inside Settings -> Verisource GEO.\n";
}
status_header( 200 );
header( 'Content-Type: text/markdown; charset=utf-8' );
header( 'Cache-Control: public, max-age=3600' );
echo $agents_body; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Markdown payload
exit;
}
}
add_action( 'init', 'verisource_geo_serve_virtual_protocol_files', 1 );
/**
* Inject <link rel="alternate"> protocol discovery tags, schema.org JSON-LD, and optional AI referral pixel.
*/
function verisource_geo_inject_head_artifacts() {
if ( is_admin() ) {
return;
}
echo '<link rel="alternate" type="text/markdown" href="' . esc_url( home_url( '/agents.md' ) ) . '" title="Agent Truth Specification" />' . "\n";
echo '<link rel="alternate" type="text/plain" href="' . esc_url( home_url( '/llms.txt' ) ) . '" title="LLM Summary" />' . "\n";
$json_ld = get_option( 'verisource_json_ld_schema', '' );
if ( ! empty( trim( $json_ld ) ) ) {
$decoded = json_decode( $json_ld, true );
if ( is_array( $decoded ) && isset( $decoded['@context'] ) ) {
echo '<script type="application/ld+json">' . wp_json_encode( $decoded, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ) . '</script>' . "\n";
}
}
$pixel_token = sanitize_text_field( get_option( 'verisource_pixel_token', '' ) );
if ( preg_match( '/^[0-9a-f-]{36}$/i', $pixel_token ) ) {
echo '<script>(function(){var r=document.referrer||"";if(/chatgpt\.com|perplexity\.ai|gemini\.google\.com|claude\.ai/i.test(r)){navigator.sendBeacon&&navigator.sendBeacon("https://verisource.dev/api/pixel",JSON.stringify({token:"' . esc_js( $pixel_token ) . '",event_type:"ai_referral_visit",referrer:r,path:location.pathname}));}})();</script>' . "\n";
}
}
add_action( 'wp_head', 'verisource_geo_inject_head_artifacts', 1 );
/**
* Register Settings -> Verisource GEO admin page.
*/
function verisource_geo_register_settings() {
register_setting( 'verisource_geo_group', 'verisource_llms_txt_body', array( 'sanitize_callback' => 'sanitize_textarea_field' ) );
register_setting( 'verisource_geo_group', 'verisource_agents_md_body', array( 'sanitize_callback' => 'sanitize_textarea_field' ) );
register_setting( 'verisource_geo_group', 'verisource_json_ld_schema' );
register_setting( 'verisource_geo_group', 'verisource_pixel_token', array( 'sanitize_callback' => 'sanitize_text_field' ) );
}
add_action( 'admin_init', 'verisource_geo_register_settings' );
function verisource_geo_admin_menu() {
add_options_page(
'Verisource GEO Connector',
'Verisource GEO',
'manage_options',
'verisource-geo-connector',
'verisource_geo_render_admin_page'
);
}
add_action( 'admin_menu', 'verisource_geo_admin_menu' );
function verisource_geo_render_admin_page() {
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
?>
<div class="wrap">
<h1>Verisource AI Facts & GEO Connector</h1>
<p>Paste your syntax-validated <code>/llms.txt</code>, <code>/agents.md</code>, and <code>schema.org</code> <code>JSON-LD</code> artifacts generated at <a href="https://verisource.dev/dashboard" target="_blank" rel="noopener noreferrer">verisource.dev/dashboard</a>.</p>
<form method="post" action="options.php">
<?php settings_fields( 'verisource_geo_group' ); ?>
<table class="form-table" role="presentation">
<tr>
<th scope="row"><label for="verisource_llms_txt_body">Canonical /llms.txt Body</label></th>
<td><textarea name="verisource_llms_txt_body" id="verisource_llms_txt_body" rows="7" class="large-text code"><?php echo esc_textarea( get_option( 'verisource_llms_txt_body', '' ) ); ?></textarea></td>
</tr>
<tr>
<th scope="row"><label for="verisource_agents_md_body">Canonical /agents.md Body</label></th>
<td><textarea name="verisource_agents_md_body" id="verisource_agents_md_body" rows="7" class="large-text code"><?php echo esc_textarea( get_option( 'verisource_agents_md_body', '' ) ); ?></textarea></td>
</tr>
<tr>
<th scope="row"><label for="verisource_json_ld_schema">Homepage JSON-LD Graph</label></th>
<td><textarea name="verisource_json_ld_schema" id="verisource_json_ld_schema" rows="7" class="large-text code"><?php echo esc_textarea( get_option( 'verisource_json_ld_schema', '' ) ); ?></textarea></td>
</tr>
<tr>
<th scope="row"><label for="verisource_pixel_token">AI Attribution Pixel UUID (Optional)</label></th>
<td><input type="text" name="verisource_pixel_token" id="verisource_pixel_token" value="<?php echo esc_attr( get_option( 'verisource_pixel_token', '' ) ); ?>" class="regular-text code" placeholder="00000000-0000-4000-8000-000000000000" /></td>
</tr>
</table>
<?php submit_button( 'Save AI Search Artifacts' ); ?>
</form>
</div>
<?php
}
WordPress Deployment Checklist
3-step setup and HTTP 200 verification
README.md
SYNTAX & TRUTH VERIFIED
# WordPress Connector Setup — Acme Software (https://acmesoftware.io)
1. Download `verisource-geo-connector.php` (or zip it into `verisource-geo-connector.zip` and upload under `WP Admin -> Plugins -> Add New Plugin -> Upload Plugin`).
2. Activate **Verisource AI Facts & GEO Connector** and open `Settings -> Verisource GEO`.
3. Paste your `/llms.txt`, `/agents.md`, and `schema.org` `JSON-LD` artifacts from Verisource Step 02. The plugin serves HTTP `200` `text/plain` and `text/markdown` responses directly from WordPress without SFTP root access and passes `GPTBot`, `OAI-SearchBot`, `PerplexityBot`, and `ClaudeBot` live checks.Connector Bridge Architecture MatrixUsing Webflow, Wix, Squarespace, Framer, or Next.js? View 7-CMS Templates →
| Connector Bridge | Target Runtime | Protocol Endpoints Exposed | Upgrade Persistence |
|---|---|---|---|
| verisource-geo-connector.php | WordPress 6.0+ · PHP 7.4+ | /llms.txt (200) · /agents.md (200) · wp_head JSON-LD | Stored in wp_options across theme switches |
| blocks/verisource-ai-truth.liquid | Shopify Online Store 2.0 | OnlineStore + MerchantReturnPolicy JSON-LD · /pages/ai-facts | Theme App Embed survives Dawn & theme updates |
FREE 60-SECOND AI VISIBILITY & CMS AUDIT