All Docs
DocsWordPress Plugin

WordPress Plugin

Embed an AI-powered quote widget on your WordPress site in under 5 minutes. Every lead gets an AI score — so you only call the ones worth your time.

Download Plugin v1.0.0
Requires: WordPress 6.0+·PHP: 7.4+·Tested up to: WordPress 6.7·Licence: GPL-2.0-or-later

Setup walkthrough video — coming soon

3-minute demo from download to first live lead

Step-by-step setup

Six steps — takes about 5 minutes start to finish.

1

Download the plugin

  1. aClick "Download Plugin" above — a .zip file will save to your computer.
  2. bDo not unzip the file. WordPress installs it as a .zip.
📸 Screenshot: Download button on this page → .zip saved to Downloads folder
2

Install and activate

  1. aLog in to your WordPress admin (yoursite.com.au/wp-admin).
  2. bGo to Plugins → Add New Plugin → Upload Plugin.
  3. cClick "Choose File", select the .zip, then click "Install Now".
  4. dClick "Activate Plugin" once installation completes.
📸 Screenshot: WordPress Plugins → Upload Plugin → Install Now screen
3

Get your API key

  1. aLog in to your QuoteShield dashboard.
  2. bGo to Settings → API Keys → Generate new key.
  3. cCopy the full key (starts with qs_).
📸 Screenshot: QuoteShield dashboard → Settings → API Keys → copy key
4

Connect your account

  1. aIn WordPress, go to Settings → QuoteShield.
  2. bPaste your API key into the field and click "Connect Account".
  3. cYour business name and plan will appear — connection confirmed.
📸 Screenshot: WordPress Settings → QuoteShield — connected state showing business name
5

Add the widget to a page

  1. aGutenberg: Open any page, click "+", search for "QuoteShield Widget", and insert it.
  2. bClassic Editor / shortcode: Add [quoteshield] anywhere in the page content.
  3. cPublish the page — the widget is live.
📸 Screenshot: Block editor with "QuoteShield Widget" block inserted on a page
6

Check your dashboard widget

  1. aGo to your WordPress admin home (Dashboard).
  2. bLook for the "QuoteShield — Recent Leads" widget showing your 5 latest leads with AI scores.
📸 Screenshot: WordPress admin dashboard with QuoteShield recent leads widget (green/yellow/red dots)

Shortcode reference

Add the shortcode to any page, post, or Classic Editor widget.

[quoteshield]
[quoteshield height="700" width="100%"]

Ready to install?

Download the plugin zip and follow the steps above.

quoteshield-wordpress.zip
Getting StartedUnderstanding Lead Scoring

Troubleshooting & FAQ

The widget is not showing on my page.

Make sure the plugin is activated (Plugins → Installed Plugins) and your API key is connected (Settings → QuoteShield). If you use a caching plugin (WP Rocket, W3 Total Cache), clear the cache after adding the shortcode or block.

I get "API key invalid" when I try to connect.

Double-check that you copied the full key from your QuoteShield dashboard. Keys start with qs_ and are case-sensitive. Make sure there are no leading or trailing spaces when you paste.

The widget shows a blank white box.

This is usually a JavaScript conflict with another plugin or theme. Open your browser's developer console (F12 → Console) and check for JS errors. Try deactivating other plugins one at a time to isolate the conflict.

Can I put the widget on multiple pages?

Yes — add [quoteshield] or the Gutenberg block to as many pages as you like. All submissions go to the same QuoteShield account.

The dashboard widget shows "Could not load leads".

The plugin cannot reach the QuoteShield API. Check that your server can make outbound HTTPS requests on port 443. Some shared hosts block this — contact your host if needed.

How do I customise the widget height or width?

Use the shortcode attributes: [quoteshield height="700" width="100%"]. The Gutenberg block uses the same defaults (100% width, 650px height) and can be adjusted via block settings.

Is my API key stored securely?

Yes. The key is encrypted with AES-256-CBC before being written to the database. It is never exposed in page source or REST API responses.

How do I uninstall cleanly?

Deactivate then delete the plugin via Plugins → Installed Plugins. All stored options (API key, settings) are removed automatically via the plugin uninstall hook.

Still stuck? Our support team typically replies within a few hours on business days.

Email support →