Title: HaulHQ Bridge Author: HaulHQ Published: July 19, 2026 Last modified: July 19, 2026 --- Search plugins ![](https://ps.w.org/haulhq-bridge/assets/banner-772x250.png?rev=3613091) ![](https://ps.w.org/haulhq-bridge/assets/icon-256x256.png?rev=3613091) # HaulHQ Bridge By [HaulHQ](https://profiles.wordpress.org/haulhq/) [Download](https://downloads.wordpress.org/plugin/haulhq-bridge.1.6.0.zip) * [Details](https://wordpress.org/plugins/haulhq-bridge/#description) * [Reviews](https://wordpress.org/plugins/haulhq-bridge/#reviews) * [Installation](https://wordpress.org/plugins/haulhq-bridge/#installation) * [Development](https://wordpress.org/plugins/haulhq-bridge/#developers) [Support](https://wordpress.org/support/plugin/haulhq-bridge/) ## Description HaulHQ Bridge connects your WordPress site to your [HaulHQ](https://haulhq.app) account. Add your services, dumpster rentals, reviews, and booking tools to any page using simple shortcodes. **Features:** * AI chatbot widget for lead capture and instant pricing * Product grid and detail shortcodes with Schema.org markup * Service listing shortcodes with price ranges * Review display with star rating rich snippets * Service area listing for local SEO * Booking widget embed * Form integration (Gravity Forms, WPForms, Contact Form 7) * Automatic cache invalidation when you update products **Requirements:** * A free HaulHQ account ([sign up here](https://dashboard.haulhq.app/signup)) * Your HaulHQ API key (found in Settings > API Keys) ### External Service This plugin connects to HaulHQ, a third-party software-as-a-service platform, to provide its features. HaulHQ is required for the plugin to function: the plugin sends and receives data from the HaulHQ API to display your products, services, reviews, service area, and booking and chatbot widgets, and to forward leads captured on your site. What is sent, and when: * **On every page that uses a HaulHQ shortcode or widget:** your plugin API key is sent to the HaulHQ API to retrieve your catalog, services, reviews, and service area content for display. No visitor personal data is sent for these read requests. * **When a visitor submits a connected form or the chatbot/booking widget:** the contact details they provide (such as name, email, phone, and message) are sent to the HaulHQ API so the lead can be recorded in your HaulHQ account. The chatbot and booking widgets are loaded from HaulHQ in an iframe and may set cookies as described in the HaulHQ privacy policy. * **Cache invalidation:** HaulHQ may send a signed webhook to your site to refresh cached catalog data when you change products in HaulHQ. * **Google Ads conversion tracking (optional):** if you configure a Google Ads Conversion ID in your HaulHQ dashboard, the plugin loads Google’s gtag.js library from googletagmanager.com and reports conversion events to Google Ads when visitors submit a form, book, or contact the chatbot. This is governed by Google’s privacy policy (https://policies.google.com/privacy). Nothing from Google is loaded if you do not configure a Conversion ID. The service is provided by HaulHQ LLC. By using this plugin you agree to HaulHQ’s terms and privacy policy: * Terms of Service: https://haulhq.app/terms * Privacy Policy: https://haulhq.app/privacy ### Usage **Display your products (dumpsters, trailers, etc.):** [haulhq_products type=”equipment”] **Display a single product detail page:** [haulhq_product slug=”20-yard-dumpster”] **Display your junk removal services:** [haulhq_services] **Display customer reviews with star ratings:** [haulhq_reviews] **Display your service area for local SEO:** [haulhq_service_area] **Add the AI chatbot to any page:** [haulhq_chatbot] **Add the booking widget:** [haulhq_booking] **Add a “Check Availability” zip CTA anywhere (header, page, widget area):** [haulhq_zip_cta] Optional attributes: `theme="dark"` for dark backgrounds, `label="Get My Price"` to change the button text, `color="#f15a22"` to set a custom button color, and ` layout="bar"` for a compact single-row variant that fits in a site header. A visitor enters their zip and the booking flow opens in a pop-up with the zip already answered. A “HaulHQ Zip CTA” block is also available in the block editor. **Compact header bar:** [haulhq_zip_cta layout=”bar”] The `bar` layout keeps the control under 35px tall so it sits inline in a header. Combine with `theme="dark"` on dark headers. The default `layout="box"` is unchanged. For full shortcode documentation and attributes, visit Settings > HaulHQ > Shortcodes in your WordPress admin. ## Blocks This plugin provides 1 block. * HaulHQ Zip CTA A compact zip-code 'Check Availability' field that opens the HaulHQ booking flow with the zip already answered. ## Installation 1. Upload the `haulhq-bridge` folder to `/wp-content/plugins/` 2. Activate the plugin through the Plugins menu 3. Go to Settings > HaulHQ 4. Enter your API key and click Save 5. Add shortcodes to your pages (see Usage below) ## FAQ ### Is HaulHQ free? Yes. HaulHQ has no monthly subscription. You pay $1.50 per completed job, capped at $149/mo. ### Do I need a HaulHQ account? Yes. Sign up for free at dashboard.haulhq.app/signup, then enter your API key in the plugin settings. ### Will this slow down my site? No. Product data is cached locally and refreshed hourly (or instantly when you update products in HaulHQ). ### Where do I get my API key? Log in to your HaulHQ dashboard at dashboard.haulhq.app, go to Settings > API Keys, and copy your key. Paste it into Settings > HaulHQ in your WordPress admin and click Save. ### What data does the plugin send to HaulHQ? For displaying content (products, services, reviews, service area), only your API key is sent to retrieve your account data — no visitor information. When a visitor submits a connected form or uses the chatbot or booking widget, the contact details they enter are sent to HaulHQ to record the lead in your account. See the “External Service” section above for full details and links to HaulHQ’s terms and privacy policy. ### Is this plugin tied to a paid service? The plugin is free and open source (GPL). It requires a HaulHQ account to function. HaulHQ has no monthly subscription; it charges a per-completed-job fee with a monthly cap. SaaS-connected plugins like this are permitted on WordPress.org. ### Does the plugin display any branding? Yes. The chatbot, booking, and quote form widgets display a small “Powered by HaulHQ” link. This appears inside the embedded widget, not on your page content. It is part of the free HaulHQ service. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “HaulHQ Bridge” is open source software. The following people have contributed to this plugin. Contributors * [ HaulHQ ](https://profiles.wordpress.org/haulhq/) [Translate “HaulHQ Bridge” into your language.](https://translate.wordpress.org/projects/wp-plugins/haulhq-bridge) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/haulhq-bridge/), check out the [SVN repository](https://plugins.svn.wordpress.org/haulhq-bridge/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/haulhq-bridge/) by [RSS](https://plugins.trac.wordpress.org/log/haulhq-bridge/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.6.0 * Compliance overhaul for the WordPress.org plugin directory review. * Removed the Custom CSS setting. Use Appearance > Customize > Additional CSS instead; if you had saved CSS, a one-time notice on the HaulHQ settings page shows it for copying. * All iframe resize/scroll listeners moved from inline scripts to a single enqueued script (`haulhq-frames.js`) that only honors messages from your configured HaulHQ embed origin. * Hardened the public `haulhq/v1/lead` REST endpoint: honeypot check, per-IP rate limiting, server-side contact validation, optional REST nonce support (`X-WP- Nonce` or `_wpnonce`, action `wp_rest`). * Uninstall now also removes the auto-configure flag, tracking-config transient, and rate-limit transients. #### 1.5.17 * Gallery: the before/after gallery (`[haulhq_gallery]` and `[haulhq_gallery_page]`) never renders a stack with a missing photo. A set with only one half (e.g. a “ before” with no matching “after”) is skipped instead of showing a broken empty image. Prevents a stale cache from resurfacing a half-populated set on your public site. #### 1.5.16 * Zip CTA: `[haulhq_zip_cta]` accepts an optional `booking_url` attribute (e.g.`[ haulhq_zip_cta booking_url="/book-online/"]`). When set, submitting a zip sends the visitor to that page with their zip carried in the URL (a real, trackable pageview) instead of opening a popup. The destination page must embed the `[haulhq_form]` shortcode; it lands the visitor already on the load-size step. UTM parameters are preserved. Leave the attribute off to keep the existing popup behavior. Also available on the “HaulHQ Zip CTA” block. * Form: `[haulhq_form]` now reads a `?zip=` value from the page URL (exactly 5 digits) and forwards it (plus any UTM parameters) into the booking form, so `/ book-online/?zip=85001` opens the form on the load-size step. Invalid zips are ignored. #### 1.5.15 * Form: `[haulhq_form]` accepts an optional `show_price` attribute (`show_price ="false"` to capture contact before revealing the estimate, `show_price="true"` to force prices on). Omit it to use your dashboard default (Settings > Quote Form > “Show prices on the form”). Lets you A/B price-gated vs price-shown forms on different pages. #### 1.5.14 * Chatbot: new “After-Hours Chatbot” option (Settings > Chatbot in your HaulHQ dashboard). When enabled, the floating chat widget appears only outside your business hours so daytime visitors reach your team directly. Open/closed is computed in the browser from your schedule + timezone, so it flips exactly at open/close. If no hours are set, the widget stays always-on. Off by default. #### 1.5.13 * Admin: documented the Zip CTA `layout` attribute (box / bar) in the Shortcodes reference + builder (Settings > HaulHQ Bridge > Shortcodes), so the header-bar variant is discoverable. No front-end changes. #### 1.5.12 * Zip CTA: new `layout="bar"` attribute (and a Layout control on the block) renders a compact single-row variant, made to drop into a site header. The control is ~35px tall on desktop and grows to ~44px on phones so it stays comfortably tappable. The default `layout="box"` is unchanged. #### 1.5.11 * Zip CTA: added left padding inside the zip field so the location pin no longer overlaps the placeholder/typed text. Padding is enforced so host themes can’t crowd it back. #### 1.5.10 * Zip CTA: the location pin now sits inside the zip field, and a new `color="#f15a22"` attribute sets a custom button color. * Removed the duplicate `[haulhq_book]` shortcode (use `[haulhq_booking]` for the equipment/dumpster rental widget). * Renamed the `[haulhq_form]` entry in the admin Shortcodes tab to “Junk Quote & Booking Form” with an accurate description (it was mislabeled “Legacy”). #### 1.5.9 * Added the new Zip Code CTA to the admin Shortcodes reference + builder (Settings > HaulHQ Bridge > Shortcodes), so it’s discoverable and copy-pasteable alongside the other shortcodes. No front-end changes. #### 1.5.8 * New `[haulhq_zip_cta]` shortcode and matching “HaulHQ Zip CTA” block: a compact“ Check Availability” zip field you can place anywhere (header, page, or widget area). A visitor enters their zip and the booking flow opens in a pop-up with the zip already filled in, so they start on the load-size step. Supports `theme ="dark"` and a custom button `label`. #### 1.5.7 * Removed the redundant Plugin URI header (it duplicated the Author URI). No functional changes. #### 1.5.6 * Set an explicit version flag on the Google gtag.js script enqueue so it no longer triggers a Plugin Check warning. Updated the plugin description and search tags. No functional changes. #### 1.5.5 * The chatbot attention grab (auto-open after a delay) now respects a 24-hour cooldown after a visitor closes it. Previously it reopened on every page load even after being dismissed. Manually opening or closing the chat is unaffected. #### 1.5.4 * Added Google Ads conversion tracking. Configure your Conversion ID and labels in your HaulHQ dashboard (Settings > Tracking & Ads) and the plugin injects gtag. js and reports conversions when visitors submit the quote form, complete a booking, or give the chatbot their contact info. Native WordPress form submissions (Gravity Forms, WPForms, Contact Form 7) also report as conversions. No scripts are loaded for sites without tracking configured. #### 1.5.3 * Attention grab delay now reads the live setting from your HaulHQ dashboard (Settings > Chatbot) instead of a separate plugin value, so changes take effect without reconfiguring the plugin. Made the auto-open reliable on mobile browsers. Add? haulhq_debug=1 to a page URL to log widget timing to the browser console. #### 1.5.2 * WordPress.org directory submission prep: added GPL license headers to all PHP files, added a LICENSE file, added an External Service disclosure section and expanded FAQ in the readme, and bumped the tested-up-to version to WordPress 7.0. No functional changes. #### 1.5.1 * Attention grab now opens the chat window after the configured delay instead of bouncing the button. Set the delay to 0 to disable. Removed the bounce animation. #### 1.4.0 * Plugin distribution: downloadable ZIP from HaulHQ dashboard (Settings > WordPress) * Dashboard shows API key, connection status, site URL, webhook secret, and installation guide * Build script for packaging plugin as installable WordPress ZIP #### 1.3.0 * Admin page redesigned with 4-tab layout (Connection, Shortcodes, Styling, Cache) * Visual shortcode builder with AJAX preview rendering * Styling controls: default styles toggle, CTA color pickers, custom CSS * Cache management: status badge, TTL dropdown, clear cache button * URL hash deep linking for admin tabs #### 1.2.0 * Webhook cache invalidation: HaulHQ SaaS sends HMAC-signed POST to clear transient cache on product changes * REST endpoint at /wp-json/haulhq/v1/cache-clear with HMAC-SHA256 validation and 5-minute replay protection * Manual “Clear Cache” button on admin settings page * Webhook secret auto-generated on activation, displayed read-only for copy-paste into HaulHQ dashboard #### 1.1.0 * New shortcode library with full Schema.org markup (Product, Service, AggregateRating, GeoCircle) * Shared catalog client with singleton pattern and transient caching * Product grid/list with detail_url linking, specs, CTA buttons * Single product detail view with image gallery and specs table * Service listing with price ranges and Schema.org Service markup * Service area display with zip codes and GeoCircle schema * Booking widget shortcode with service pre-selection * BEM-prefixed responsive CSS (mobile, tablet, desktop breakpoints) * CTA button JavaScript with chatbot/booking widget integration #### 1.0.0 * Security hardening: masked API key with reveal/copy, capability checks, allowlist validation * Added Quick Start shortcode reference on admin page * Added PHP 8.0 and WordPress 6.0 version checks * Added uninstall.php for clean removal * Updated plugin branding and metadata * Rewritten readme.txt to WordPress.org standards #### 0.2.1 * Added product catalog, services, reviews, and service area shortcodes * Added booking widget shortcode * Legacy SaaS URL auto-healing #### 0.1.0 * Initial release * Chatbot widget embed * Gravity Forms, WPForms, CF7 integration * Generic REST endpoint for custom forms * Admin settings with connection test ## Meta * Version **1.6.0** * Last updated **2 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.0.2** * PHP version ** 8.0 or higher ** * Tags * [booking](https://wordpress.org/plugins/tags/booking/)[chatbot](https://wordpress.org/plugins/tags/chatbot/) [junk removal](https://wordpress.org/plugins/tags/junk-removal/)[shortcodes](https://wordpress.org/plugins/tags/shortcodes/) * [Advanced View](https://wordpress.org/plugins/haulhq-bridge/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/haulhq-bridge/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/haulhq-bridge/reviews/) ## Contributors * [ HaulHQ ](https://profiles.wordpress.org/haulhq/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/haulhq-bridge/)