WordPress Plugin

Introduction

​

This guide walks you through installing the Airgentic plugin for WordPress. The widget has three modes:

• Hover widget (classic UI) – appears on every page (bottom‑right launcher).

• Service Hub UI (classic UI)– a full‑width chat experience shown on chosen pages only.

• Search UI - a unified site search + chat experience presented in a semi-transparent overlay.

You’ll install one plugin, enter your Airgentic search and account IDs once, and then you can optionally activate search mode by providing the HTML element ID of your search input box and/or search button. 

If you choose to use the Service Hub, you can also. let editors decide where (if anywhere) the Service Hub appears on pages.

​

1. Prerequisites

​​

• WordPress core – 6.4 + (tested up to 6.8.2).

• PHP - 7.4 +

• Permissions – A user with Administrator rights who can install plugins and edit pages/posts.

• Airgentic IDs – have your Account ID and Service ID handy.

​

2. Install the plugin

​

1. Download airgentic-widget.zip (link below).

2. Go to WP‑Admin → Plugins → Add New → Upload Plugin.

3. Choose the ZIP, click Install Now, then Activate.

4. You’ll see a new menu item Settings → Airgentic.

​

​

​

​

​

​

3. Configure global settings

1. Go to Settings → Airgentic.

2. Enter Account ID and Service ID (required).

3. (Optional) Enter Search Input Element ID and/or Search Button Element ID if you want the widget to hook into your site’s existing search box.

   1. These should be the DOM element IDs (e.g., 'search-btn', 'search-box').

   2. Leave blank if you don’t want the website search feature.

4. Tick Enable on front-end and click Save Changes.

Nothing else is required—the hover widget now loads site‑wide.

​

As confirmation, you can. view source of any page – you’ll see the script tag injected automatically. E.g.

<script async id="airgentic-script"
        src="https://chat.airgentic.com/_js/airgentic-1.4.js"
        data-account-id="YOUR_ACCOUNT_ID"
        data-service-id="YOUR_SERVICE_ID"
        data-search-input-id="searchInput"
        data-search-button-id="searchButton"></script>

​

​

4. Add the Service Hub to selected pages

​​​​​

Use the shortcode where you want the full Service Hub container to render:

​

[airgentic_service_hub]

​

• Works in Gutenberg blocks or the Classic Editor.

• The shortcode outputs: <div id="airgentic"></div>

• Position the shortcode wherever you want the Service Hub to appear (e.g., at the top of a landing page template).

​

​

5.  Troubleshooting

​​

Widget not showing at all

• Check Settings → Airgentic: Account ID and Service ID are set and Enable on front-end is ticked.

• Confirm your site’s Content-Security-Policy (if any) allows loading scripts from https://chat.airgentic.com.

• View page source and look for the <script id="airgentic-script" ...> tag.

Search integration not working

• Verify the IDs you entered match real DOM elements on the page (document.getElementById('yourId') returns an element).

• Only use the ID attribute, not class names (no . prefix).

• Avoid duplicate IDs in your theme/templates.

Service Hub not appearing

• Ensure the shortcode [airgentic_service_hub] is present on the page and not inside a hidden/conditional block.

​

Duplicate widget

• Remove any hardcoded Airgentic script from your theme if the plugin is active. Use the plugin only once.

​​

Caching/CDN

• After first install or settings change, purge page cache and any CDN (e.g., Cloudflare) to ensure the updated script/attributes ship.

​

6. Removing the integration

​​

Deactivate or delete the plugin. The script tag and any shortcode container disappear; the plugin stores only basic options (no custom tables).

​