Samba Booking Widgets
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:
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).