Skip to content
Wholisphere Docs

WordPress

Two options: drop a snippet into your theme’s functions.php, or install via the WP plugin (coming soon — drop us a line if you’d like early access).

Option A — functions.php snippet (any theme)

Edit your active theme’s functions.php and add:

add_action('wp_footer', function () {
    $key = getenv('WHOLISPHERE_KEY');
    if (!$key) return;
    ?>
    <script
      src="https://cdn.wholisphere.ai/embed.js"
      data-key="<?php echo esc_attr($key); ?>"
      data-position="bottom-right"
      data-wholisphere
    ></script>
    <?php
});

Set the WHOLISPHERE_KEY env var in your hosting panel (Kinsta / WP Engine / Pantheon all expose this in the dashboard).

If your host doesn’t support env vars, hard-code the key — but treat it like a secret and rotate via the dashboard whenever a developer leaves.

Option B — Site Kit / WPCode plugin

If you use the Site Kit, WPCode, or Insert Headers and Footers plugin:

  1. Open the plugin’s “Footer scripts” section.
  2. Paste the same <script> tag with your data-key filled in.
  3. Save.

Custom Gutenberg block toggle

To let editors disable the agent on a per-post basis, add a checkbox to your post meta and gate the snippet:

add_action('wp_footer', function () {
    $disabled = get_post_meta(get_the_ID(), '_wholisphere_disabled', true);
    if ($disabled) return;
    // …emit the script as above
});

Verifying

After saving, view any front-end page logged out. The FAB should appear in the bottom corner. Open the panel; you should see at least the four free capabilities (Read aloud, Focus mode, Distraction remover, Live captions).