=== Destinely Experiences Widget ===
Contributors: nkambwemedi
Tags: hotel, booking, woocommerce, tourism, experiences
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.0.15
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Help hotel guests discover local experiences after booking and earn commission on every experience booked through your site.

== Description ==

Destinely Experiences Widget connects your WordPress hotel website to the [Destinely](https://www.destinely.com) platform. After a guest completes a hotel booking, a launcher appears on the confirmation page so they can browse and book nearby experiences.

= Why hotels use it =

* Earn commission when guests book experiences through your site
* Setup in minutes with your Hotel ID and Hotel Name
* Works with WooCommerce and common hotel booking plugins
* Appearance and offers managed in your Destinely hotel dashboard
* Mobile-friendly booking with secure Pesapal payments

= How it works =

1. A guest completes a hotel booking on your website
2. The plugin detects the booking confirmation page
3. The Destinely launcher appears with nearby experiences
4. The guest books an experience and your hotel earns commission

= External services =

This plugin connects to `https://www.destinely.com` to show experiences, process bookings, and record basic usage needed for the widget. By using this plugin you agree to the [Destinely Terms of Service](https://www.destinely.com/terms) and [Privacy Policy](https://www.destinely.com/privacy).

Data sent to Destinely may include: Hotel ID, page URL, session ID, browser type, and booking-related events on confirmation pages. WordPress admin passwords are never sent.

== Installation ==

= From wordpress.org =

1. Go to **Plugins → Add New**
2. Search for **Destinely Experiences Widget**
3. Click **Install Now**, then **Activate**
4. Go to **Settings → Destinely Experiences Widget**
5. Enter your **Hotel ID** and **Hotel Name** from your [Destinely hotel dashboard](https://www.destinely.com/dashboard/hotel)
6. Enable the widget and save

Plugin page: https://wordpress.org/plugins/destinely-experiences-widget/

= From a ZIP file =

1. Go to **Plugins → Add New → Upload Plugin**
2. Upload the ZIP, then activate **Destinely Experiences Widget**
3. Go to **Settings → Destinely Experiences Widget**
4. Enter your **Hotel ID** and **Hotel Name** from your [Destinely hotel dashboard](https://www.destinely.com/dashboard/hotel)
5. Enable the widget and save

== Frequently Asked Questions ==

= Do I need a Destinely account? =

Yes. Create a free hotel partner account at [destinely.com/hotel/register](https://www.destinely.com/hotel/register) to get your Hotel ID.

= Can I customize the widget? =

Yes. Title, color, position, and display options are managed in your Destinely hotel dashboard under widget settings.

= Will this slow down my site? =

No meaningful impact for most hotels. The widget script loads only when the plugin is enabled and set up, and it is designed not to block your pages.

= Does it work with WooCommerce? =

Yes. It works with WooCommerce order confirmation pages and common hotel booking plugins such as Tourfic and similar thank-you or confirmation pages.

= Where do guests see the widget? =

On the booking confirmation page after a successful hotel booking. It does not show on every page of your site.

= How do I get support? =

Visit [destinely.com/docs](https://www.destinely.com/docs) or open your [hotel dashboard](https://www.destinely.com/dashboard/hotel).

== Screenshots ==

1. Plugin settings page with Hotel ID and enable toggle
2. Widget launcher on a hotel booking confirmation page
3. Experience cards with booking flow

== Changelog ==

= 3.0.15 =
* Settings link on the Plugins screen next to Deactivate

= 3.0.14 =
* More reliable widget after page refresh
* Clearer guest activity tracking (opens, clicks, and booking starts)
* Widget layout and click behavior aligned with the live Destinely demo

= 3.0.11 =
* Fixed cases where the launcher did not open or load experiences
* Timing now respects your configured display delay

= 3.0.10 =
* Widget loads only on booking confirmation pages, not the rest of your site

= 3.0.9 =
* Confirmation-page detection, notification sound, and page blur matched to the live demo
* Clearer settings menu label

= 3.0.8 =
* Hotel sites now use the same Destinely widget experience as the live demo

= 3.0.7 =
* Fixed cases where the launcher did not appear on some confirmation pages

= 3.0.6 =
* Better automatic detection for WooCommerce and popular hotel booking confirmation pages

= 3.0.5 =
* Fixed an install issue that could block plugin activation from a ZIP file

= 3.0.3 =
* Stability and WordPress coding-standard improvements

= 3.0.2 =
* Plugin details and license information updated for the WordPress.org directory

= 3.0.1 =
* Compatibility updates for current WordPress versions
* Cleaner translation handling

= 3.0.0 =
* Simpler setup: Enable, Hotel ID, and Hotel Name only
* Cleaner admin settings and confirmation-page detection for WordPress and WooCommerce

= 2.7.0 =
* Widget configuration aligned with the Destinely platform

== Upgrade Notice ==

= 3.0.15 =
Adds a Settings link on the Plugins screen. Same plugin. Safe to upgrade.

= 3.0.14 =
More reliable widget loading and tracking. Safe to upgrade from 3.0.6 or newer.

= 3.0.9 =
Matches the live Destinely demo behavior. Safe to upgrade.

= 3.0.8 =
Hotel widget now matches the live demo. Safe to upgrade.

= 3.0.7 =
Fixes the launcher not appearing on some confirmation pages. Safe to upgrade.

= 3.0.6 =
Better detection on WooCommerce and hotel booking confirmation pages. Safe to upgrade.

= 3.0.2 =
Directory listing updates. Safe to upgrade. No settings changes required.

= 3.0.1 =
Major cleanup release. Re-enter Hotel ID and Hotel Name after upgrading if settings do not appear.

== Privacy Policy ==

This plugin stores three settings on your WordPress site: enable flag, Hotel ID, and Hotel Name. Guest activity and bookings are handled by Destinely over HTTPS. See [destinely.com/privacy](https://www.destinely.com/privacy).
