VERISOURCEmcp.verisource.dev/mcp
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
WordPress 6.0+1-file .php · wp_optionsShopify OS 2.0App Embed + UCP /mcpBRIDGE ROUTERSurvives theme& host updates✓ HTTP 200 LIVE• /llms.txt (200)• /agents.md (200)• head JSON-LD1. WORDPRESS .PHP OR SHOPIFY OS 2.0 EMBEDZero SFTP or theme merge conflicts✓ HTTP 200 /LLMS.TXT · /AGENTS.MD · JSON-LDPersists cleanly across Dawn & WordPress updates
DROP-IN CMS CONNECTOR BRIDGES · ZERO SFTP REQUIRED
Select your CMS connector architecture
WORDPRESS 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 &amp; 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 BridgeTarget RuntimeProtocol Endpoints ExposedUpgrade Persistence
verisource-geo-connector.phpWordPress 6.0+ · PHP 7.4+/llms.txt (200) · /agents.md (200) · wp_head JSON-LDStored in wp_options across theme switches
blocks/verisource-ai-truth.liquidShopify Online Store 2.0OnlineStore + MerchantReturnPolicy JSON-LD · /pages/ai-factsTheme App Embed survives Dawn & theme updates
FREE 60-SECOND AI VISIBILITY & CMS AUDIT

Test your own domain across ChatGPT, Gemini & Perplexity right now.

$0 TODAY · 7-DAY FREE TRIAL
OR TEST A LIVE BENCHMARK DOMAIN:stripe.comlinear.appcal.comshopify.com