=== Travel Booking for Duffel ===
Contributors: travelbookingwp
Tags: flights, travel, duffel, flight-search, travel-agency
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a responsive flight-search experience to WordPress, with a useful demo mode and an optional paid connection to your own Duffel account.

== Description ==

TravelBookingWP gives travel agencies, tour operators, and WordPress builders a focused way to place flight search on an existing website.

The free plugin is a self-contained demonstration: visitors can use the responsive search form, airport suggestions, sample results, and offer screens without creating a Duffel account or sending data to Duffel.

The paid version connects the same interface to the site owner's Duffel account for live place suggestions, test or live flight searches, current offer details, and test-mode order validation.

= Free Version =

* Responsive flight-search shortcode
* Airport and city suggestions from an included demonstration data set
* One-way and round-trip searches
* Adult, child, and infant search controls
* Sample results and offer-detail screens
* Theme-scoped styles and a primary-color control
* Setup wizard and demonstration pages

= Paid Version =

* Live place suggestions from Duffel
* Test-mode or live flight offers from the site's own Duffel account
* Current offer retrieval before the test booking step
* Operating-carrier disclosure in flight results
* Test-mode order creation for supported adult itineraries
* One-site and five-site license options
* Higher-tier branding and custom-CSS controls

Live order creation and customer card collection are not included in version 1.0. Site owners should keep live booking in their established agent workflow. Duffel Payment Intents access is not assumed.

= How It Works =

1. Install and activate the plugin.
2. Run the setup wizard or add `[duffel_flight_search]` to a page.
3. Use the included demonstration mode immediately.
4. Purchase a paid license and add your own Duffel API token to enable live flight search.
5. Validate the integration with Duffel test mode before using live search on a public site.

= Requirements =

* WordPress 6.0 or higher
* PHP 7.4 or higher
* A Duffel account and API token for paid live-search features
* HTTPS and a current backup before enabling any live travel workflow

= External Services =

The free version uses included demonstration data and does not contact Duffel.

When a paid license and Duffel API token are configured, the plugin sends traveller search criteria to the Duffel API to retrieve place suggestions, flight offers, and current offer details. In Duffel test mode, an administrator can also validate supported test orders. Data sent can include origin, destination, travel dates, cabin, passenger types, and, only during a test order, passenger contact and identity fields entered by the tester.

* Duffel service: https://duffel.com/
* Duffel terms: https://duffel.com/terms
* Duffel services agreement: https://duffel.com/services-agreement
* Duffel privacy policy: https://duffel.com/privacy-policy

== Installation ==

1. Upload the plugin ZIP through **Plugins > Add New > Upload Plugin**.
2. Activate TravelBookingWP.
3. Follow the setup wizard.
4. Add `[duffel_flight_search]` to a page, or use the Flight Search block.
5. For paid live search, enter a Duffel test token first and run the connection check.

== Frequently Asked Questions ==

= Does the free plugin search live airline inventory? =

No. The free plugin is a working interface demonstration with clearly labelled sample data. A paid license and your own Duffel account are required for live flight offers.

= Does version 1.0 collect customer card payments? =

No. Customer payment gateways and live order creation remain disabled until a payment path can be verified safely. The paid plugin supports live search and test-mode order validation; live bookings stay in your normal agent workflow.

= Does the plugin include a Duffel account or airline accreditation? =

No. The site owner is responsible for their Duffel account, eligibility, balance, supplier access, commercial agreements, and compliance obligations.

= Can I customize the appearance? =

Yes. The interface uses scoped styles and appearance settings. Paid tiers include additional branding and custom-CSS controls.

= Are hotels included? =

No. Version 1.0 is flight-search only. Duffel Stays access is separate and is not promised by this plugin.

== Screenshots ==

1. Responsive flight-search form
2. Airport and city suggestions
3. Flight results with operating-carrier disclosure
4. Current offer details
5. Setup wizard
6. Connection and API-mode settings
7. Appearance controls
8. Test-mode booking validation

== Changelog ==

= 1.0.0 =

* Initial sale-readiness release
* Responsive demonstration flight search
* Paid Duffel place suggestions and flight search
* Current-offer refresh and server-authoritative test-order data
* Operating-carrier disclosure
* Test-mode order validation for supported adult itineraries
* Admin setup, connection checks, appearance controls, and scoped packaging

== Upgrade Notice ==

= 1.0.0 =

The paid version connects TravelBookingWP to your own Duffel account for live flight search and supported test-mode integration checks.
