About this plugin
Samba Booking Widgets puts your Samba
tour and activity booking widgets on your WordPress site — no HTML, no hand-copied
iframes. Paste your workspace key once, then drop a Book Now button, an
availability calendar, an upcoming departures list, or a product grid
onto any page with a Gutenberg block or a shortcode. Widget types and options are
served live from your Samba account, with a real-time preview in the block editor.
It’s built for tour operators, activity providers and travel agencies that take
bookings with Samba and want them on their own WordPress site in minutes.
Booking widgets you can embed
- Book Now button — opens Samba checkout in a modal, with an optional “from” price.
- Upcoming Departures — a live list of your next departures with seats and prices.
- Calendar — a month view showing availability, times and prices per day.
- Product List — a card grid of your trips with images and next departures.
Why tour operators use it
- No code, no HTML — pick a widget and a trip from dropdowns, and a live preview shows exactly what visitors will see.
- Always up to date — trips, prices and availability come straight from Samba, so your site never shows stale information.
- Works everywhere — a Gutenberg block, a native Elementor widget, and a [samba_widget] shortcode for classic themes and other page builders.
- Secure — your Samba key stays on your server and is never shown to visitors.
- Fast — the booking script loads only on pages that use a widget.
Comparing Samba with FareHarbor, Bokun, Rezdy, Peek Pro, WeTravel or WP Travel Engine?
Samba is a modern booking platform for tour and activity operators — an alternative
both to SaaS systems and to self-hosted WordPress booking plugins like WP Travel
Engine. If you’re weighing it against another system, read the honest, side-by-side
breakdowns:
- Samba vs FareHarbor
- Samba vs Peek Pro
- Samba vs Bókun
- Samba vs Rezdy
- Samba vs WeTravel
Once you’re on Samba, this plugin is how you put your booking widgets on WordPress.
How it works
- Connect once in Settings → Samba with your workspace secret key.
- Add the Samba block to any page or post, then pick a widget type and experience — or place [samba_widget] in your content.
- Publish. The widget renders live from your Samba account.
A Samba account is required. Find your workspace secret key in the Samba dashboard
under Settings → Website Widgets → WordPress.
External services
This plugin connects to Samba to validate your account
and display live booking widgets. It requires a Samba account. It connects to two
Samba services:
- Samba API — https://api.sambahq.com
- What it does: validates your workspace secret key and loads your widget
configuration, experiences, and booking data.
- What is sent, and when: when you save your key in Settings → Samba, and when
the block editor loads, your site makes server-side requests to the Samba API
that include your secret key in an Authorization header. Your secret key is
stored on your server and is never sent to the visitor’s browser.
- On the front end, widgets request public booking data (such as availability,
departures, and prices) for the widget and experience you configured,
identified only by your public workspace slug.
- Samba embed script — https://files.sambahq.com/widgets/embed.js
- What it does: loaded only on pages that contain a Samba widget, it renders
the widget in the visitor’s browser and fetches public booking data from the
Samba API for the configured widget.
Your use of Samba is governed by Samba’s Terms of Service
and Privacy Policy.
Development
The block’s uncompiled source ships in src/; the files in build/ are
generated from it with @wordpress/scripts ( npm run build ).