Injects the widget script
<script async src="https://api.orcalinq.com/w.js" data-tenant="chat_…" data-api="https://api.orcalinq.com"> on every public page. Same shape the dashboard's install snippet emits.
Install · WordPress
Install OrcaLinq on WordPress in 5 minutes
A thin connector plugin that injects the widget, manages the CSP allowlist, and verifies install status. All knowledge, routing, agent, audit, and analytics configuration lives in the OrcaLinq Admin Portal.
Step 1
Don't have a OrcaLinq account yet?
Sign up free — passwordless sign-in by email, no credit card. The free plan includes the website widget and a sandbox tenant.
- 1. Create a free account at app.orcalinq.com/signup.
- 2. In the dashboard: Domains → Add domain → enter your WordPress site's hostname.
- 3. Domains → Installation → copy your Tenant Key (looks like
chat_…). - 4. Continue with the install steps below.
Path A — recommended
OrcaLinq Connector plugin
The simplest install: a thin WordPress plugin that injects the widget, manages the CSP allowlist, and reports install status. No theme edits.
- 1. Download: orcalinq-widget-latest.zip (or open Downloads in the admin portal).
- 2. Install: WordPress admin → Plugins → Add New → Upload Plugin → pick the zip → Install Now → Activate.
- 3. Configure: Settings → OrcaLinq → paste your Tenant Key → Save.
- 4. Verify: click Verify installation. The status panel flips green within seconds.
What the plugin does
Three things, then it gets out of the way
Manages the CSP allowlist
Three modes — Auto-allow (default; emit a permissive CSP only when your site has no other CSP), Force, or Off. Defers to existing security plugins automatically.
Verifies install status
A server-side check against the OrcaLinq install-verify endpoint. Works on staging sites that aren't reachable from the public internet.
Path B — alternative
Header / footer plugin
Use this if you already have WPCode, Insert Headers and Footers, or Code Snippets installed and don't want another plugin.
- Open the chosen plugin's settings.
- Paste the snippet from OrcaLinq Admin → Domains → Installation into the Header / Site Wide Header box.
- Save. Open any public page on the site. The Admin Portal install card flips to green within ~5 seconds.
Path C — power users
Theme File Editor
- Appearance → Theme File Editor → header.php.
- Paste the snippet just before
</head>. - Update.
WooCommerce
Same plugin, optional data connector
WooCommerce stores get the widget through the same WordPress plugin — it loads on every public page including product, cart, and checkout.
Live order data, customer identity, and stock lookup require the WooCommerce data connector (not yet shipped). Without the connector, the AI answers from approved knowledge (FAQ, return policy, shipping policy, public product pages) and hands off when live order data is needed.
Troubleshooting
Common install issues
Widget heartbeat not seen
View page source on a public URL and search for api.orcalinq.com/w.js. If missing, the plugin isn't enqueueing — re-check that the Tenant Key is saved and the Load on public site checkbox is on.
Strict CSP blocking the widget
If your security plugin (Wordfence, Sucuri, Solid Security, Really Simple SSL Pro) sets a strict CSP, the OrcaLinq plugin defers to it automatically. Add api.orcalinq.com to both script-src and connect-src in your existing rule.
Bot challenge blocking wp-admin
If you can't reach /wp-admin at all and the browser shows a security interstitial that never resolves, your edge security rules may be blocking admin access. Add a rule in your security provider to skip bot challenges when the URI path contains /wp-admin.
Wrong domain detected
The plugin verifies against home_url(), which uses your WordPress site URL. If WordPress is on example.com but visitors hit www.example.com, add both domains in OrcaLinq Admin or use a wildcard (*.example.com).
Tenant Key not recognized
Re-issue the key from OrcaLinq Admin Portal → Domains → Installation → Rotate. The old key keeps working until the new one is saved.
WordPress install FAQ
Frequently asked questions
Does this work with WordPress.com or only self-hosted?
Self-hosted WordPress (WordPress.org) only. WordPress.com Business+ tiers that allow plugins also work; lower tiers don't allow custom plugins. For WordPress.com sites without plugin access, paste the install snippet via Code Injection.
Does it work with caching plugins?
Yes. The script tag uses async loading; caching plugins (WP Rocket, W3 Total Cache, LiteSpeed Cache, etc.) don't need any special configuration. The plugin uses wp_enqueue_script so caching plugins compose correctly.
Will it slow my site down?
No. The bubble script is tiny (~2.4 KB gzipped) and loads async. The heavy chat UI is loaded lazily inside an iframe only when the visitor clicks the bubble.
Why doesn't this plugin have an inbox / AI settings / analytics?
By design. OrcaLinq keeps the entire control plane in the Admin Portal so a single source of truth is maintained across web, WhatsApp, LINE, Telegram, Instagram, Messenger, and Shopify. The plugin's only job is install + CSP + status.
Can I disable the widget on certain pages?
Use the standard WordPress filters (wp_enqueue_scripts) to dequeue 'aichat-widget' on specific pages or post types. Per-URL visibility rules in the plugin UI are on the roadmap.
How do updates work?
Once listed on wordpress.org, updates ship via the standard WordPress plugin auto-update channel. For manual installs, download a new zip and re-upload — settings are preserved.
Related pages
Keep exploring
Need help?
Sign in to your <a href="https://app.orcalinq.com">tenant admin portal</a> and use Domains → Installation → Diagnose for a server-side troubleshooting wizard, or get in touch.