Booking Widget for Mews
Booking Widget for Mews simplifies the integration of the Mews Booking Engine into any WordPress website. Hotels, rental companies, and hospitality businesses can add a “Book Now” button or link anywhere on their site using simple shortcodes or the included Gutenberg block.
Features
- Easy setup — just enter your Mews Configuration ID and you are ready to go.
- Default widget —
[bwfm_booking_widget]displays arrival/departure date pickers and a “Check Availability” button, matching the standard Mews Booking Engine experience. - Multiple modes — use
mode="button"for a simple button, ormode="hidden"to load the engine invisibly for use with your own UI elements. - Shortcodes —
[bwfm_booking_button]for a button and[bwfm_booking_link]for a link that opens the booking engine. - Gutenberg block — a native “Mews Booking Button” block with text and style controls.
- Open Elements — define CSS selectors so any existing element on your site can open the booking engine on click.
- Language & Currency — set default language and currency for the booking engine.
- Demo mode — test with the Mews demo environment before going live.
- Developer-friendly — action and filter hooks for extensions and customization.
How It Works
- Install and activate the plugin.
- Go to Settings > Mews Booking and enter your Configuration ID.
- Add
[bwfm_booking_widget]to any page — it displays date pickers and a “Check Availability” button by default. Visitors pick dates, click the button, and the Mews Booking Engine opens with their dates pre-filled. - Alternatively, use
[bwfm_booking_button]for a simple booking button, or[bwfm_booking_widget mode="hidden"]to load the engine invisibly alongside your own custom buttons.
External services
This plugin relies on external services operated by Mews Systems B.V. (“Mews”) to load and run the booking engine.
Mews Distributor (production)
When a page uses a booking shortcode or the included block, the plugin loads JavaScript from:
https://app.mews.com/distributor/distributor.min.js
This script is required to display the Mews Booking Engine and handle availability and reservations. Your saved Configuration ID(s) are passed to this script when the page loads so the correct property is targeted. No visitor personal data is sent to Mews until the visitor interacts with the booking flow.
Mews Demo API
If you enable Demo Mode in the plugin settings (Advanced tab), the booking engine uses Mews’ demo environment. The front-end code then directs API traffic to:
https://api.mews-demo.com
This happens only while Demo Mode is on. The same Configuration ID(s) from your settings are used against the demo sandbox for testing; no live bookings are made. The same Mews terms and privacy policy apply.
