WordPress Plugin Guide

Option A: Upload via WordPress Admin

1. 1.Download the plugin ZIP file from your QuoteLab dashboard (Settings → Integrations → WordPress).
2. 2.In your WordPress admin, go to Plugins → Add New → Upload Plugin.
3. 3.Choose the ZIP file and click Install Now.
4. 4.Click Activate Plugin. The setup wizard will start automatically.

Option B: Manual Upload via FTP/SFTP

1. 1.Extract the ZIP file on your computer.
2. 2.Upload the quotelab folder to /wp-content/plugins/ on your server.
3. 3.Go to Plugins in your WordPress admin and click Activate next to “QuoteLab - Booking Widget”.

Connection

Your API key, business slug, and API base URL. Use the Verify Connection button to confirm everything is working. The business name and slug are auto-populated from QuoteLab when you verify.

Widget Defaults

Configure the default widget and display mode (inline or floating). These defaults apply to shortcodes and blocks when you don't specify overrides. This section also contains the floating widget toggle, auto-generated service pages toggle, and floating button customization options.

Booking widget

[quotelab]

Embeds the booking widget using your default settings.

Booking widget with overrides

[quotelab widget="exterior-detail" mode="inline"]

Override the widget configuration and display mode per instance.

Reviews widget

[quotelab_reviews]

Displays your customer reviews.

Reviews widget with options

[quotelab_reviews count="5" theme="dark"]

Show a specific number of reviews and set the color theme.

How to enable

1. 1.Go to Settings → QuoteLab.
2. 2.Check “Auto-Generate Service Pages” under Widget Defaults.
3. 3.Save changes. The plugin will create pages for all your active services.

How it works

• One WordPress page per active service, with the booking widget pre-inserted
• A daily WP-Cron job checks for new or removed services and syncs automatically
• Pages are created as drafts by default so you can review and customize before publishing
• You can edit the generated pages like any other WordPress page

What gets added

• LocalBusiness schema with your business name, address, and contact info
• Service schema for each of your services with names and pricing
• Data is fetched from your QuoteLab account and cached for performance

Yoast SEO integration

If you have Yoast SEO installed, the plugin integrates with Yoast's schema graph instead of injecting a separate JSON-LD block. This avoids duplicate schema and follows Yoast's best practices for structured data.

Supported platforms

• Google Analytics 4 - events sent via gtag() if detected on the page
• Google Tag Manager - events pushed to dataLayer if GTM is present
• Facebook/Meta Pixel - events sent via fbq() if the pixel is installed

Events forwarded

[quotelab] attributes

[quotelab_reviews] attributes

Widget does not appear on the page

• Verify the plugin is activated under Plugins.
• Go to Settings → QuoteLab and click Verify Connection. You should see a green “Connected!” confirmation.
• Ensure you have at least one active service in your QuoteLab dashboard.
• Check your browser console (F12) for JavaScript errors.

“Connection failed” when verifying

• Double-check your API key. Copy it fresh from your dashboard settings (Integrations tab).
• Make sure your business slug is entered correctly (no spaces, lowercase).
• Check that your server can make outbound HTTPS requests to quotelab.io. Some hosting providers block outbound requests by default.

Widget styling looks broken

The widget runs inside Shadow DOM, which isolates its styles from your theme. If you see layout issues, it is usually caused by aggressive CSS resets targeting the widget's container element. Try adding some width to the container:

.bookkit-widget-container {
  max-width: 100%;
  width: 100%;
}

Caching plugin showing stale content

If you use a caching plugin (WP Super Cache, W3 Total Cache, LiteSpeed Cache, etc.), clear your cache after making changes to the plugin settings. The widget itself loads dynamically and is not affected by page caching, but the shortcode output and schema markup may be cached.

Conflict with another plugin

The QuoteLab plugin has zero dependencies and is designed to coexist with any other plugin. If you suspect a conflict, temporarily deactivate other plugins one by one to identify the culprit. Common sources of conflicts are security plugins that block external scripts and optimization plugins that defer or minify JavaScript.

Floating button not showing

• Confirm the floating widget is enabled in Settings → QuoteLab.
• If your trigger is set to “scroll” or “delay”, scroll down or wait for the button to appear.
• Check for a z-index conflict with your theme's sticky header or other fixed elements.