| @@ -1,11 +1,11 @@ | ||
| 1 | 1 | === Yatra - Travel Booking & Tour Operator Software === |
| 2 | 2 | Contributors: MantraBrain |
| 3 | 3 | Tags: tour-booking, travel-booking, tour-operator, travel, travel-agency |
| 4 | 4 | Requires at least: 6.0 |
| 5 | -Tested up to: 7.0 | |
| 5 | +Tested up to: 7.1 | |
| 6 | 6 | Requires PHP: 7.4 |
| 7 | -Stable tag: 3.0.11 | |
| 7 | +Stable tag: 3.0.16 | |
| 8 | 8 | License: GPLv2 or later |
| 9 | 9 | License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 10 | 10 | |
| 11 | 11 | WordPress travel booking plugin for tour operators. Trips, departures, payments, OTAs, AI. Free + [Pro](https://wpyatra.com/pricing/) from $99/yr. |
| @@ -139,9 +139,9 @@ | ||
| 139 | 139 | * **Trip categories** — `yatra/trip-category` (same card layout as destinations; links use your trip category base from Settings). |
| 140 | 140 | |
| 141 | 141 | **Shortcodes** (all accept string values as in the plugin defaults — use `yes` / `no` or `0` / `1` where noted): |
| 142 | 142 | |
| 143 | -* **`[yatra_trip]`** — Trip listing. Alias: **`[yatra_tour]`**. Filters: `destination`, `activity`, `category` accept comma-separated classification IDs. Optional: `order`, `featured_priority` (`featured` / `new` / `limited`), `per_page`, `difficulty`, `price_min`, `price_max`, `duration_min`, `duration_max`, `search`, `columns`, `show_pagination`, `title`. Pagination: `trip_page`. Examples: `[yatra_trip]`, `[yatra_trip destination="44" activity="12"]`, `[yatra_trip featured_priority="new" per_page="6"]`. | |
| 143 | +* **`[yatra_trip]`** — Trip listing. Alias: **`[yatra_tour]`**. Filters: `destination`, `activity`, `category` accept comma-separated classification IDs. Optional: `order`, `featured_priority` (`featured` / `new` / `limited`), `per_page`, `difficulty`, `price_min`, `price_max`, `duration_min`, `duration_max`, `search`, `columns`, `show_pagination`, `title`, `card_layout`. Pagination: `trip_page`. Examples: `[yatra_trip]`, `[yatra_trip destination="44" activity="12"]`, `[yatra_trip featured_priority="new" per_page="6"]`, `[yatra_trip card_layout="compact_all"]`. | |
| 144 | 144 | * **`[yatra_activity]`** — Activity listing cards. |
| 145 | 145 | * **`[yatra_destination]`** — Destination showcase. |
| 146 | 146 | * **`[yatra_trip_category]`** — Trip category cards. |
| 147 | 147 | * **`[yatra_search]`** — Advanced trip search form. Per-field visibility attributes — `keyword`, `destination`, `activities`, `duration`, `budget` — each `yes` / `no`. Omit one to inherit its **Settings → Search & Listing** toggle; pass a value to force it on/off for that placement. Example: `[yatra_search budget="no" duration="no"]`. (The built-in listing page sets these automatically from your settings.) |
| @@ -150,8 +150,10 @@ | ||
| 150 | 150 | * **`[yatra_discount_and_deals]`** — Discounted trips. |
| 151 | 151 | |
| 152 | 152 | **Empty-term filtering (`hide_empty`):** `[yatra_destination]`, `[yatra_activity]` and `[yatra_trip_category]` accept `hide_empty="yes"` to skip taxonomy terms that have zero published trips. Opt-in (default `no`). |
| 153 | 153 | |
| 154 | +**Card layout (`card_layout`):** `[yatra_trip]` / `[yatra_tour]` and `[yatra_discount_and_deals]` accept `card_layout` to set how the trip cards look for that one listing, overriding the site-wide **Settings → Design → Listing Card Layout** default. Values: `inherit` (default — follow the site setting), `standard` (full card), `compact_mobile` (compact horizontal cards on phones only, unchanged on desktop), `compact_all` (compact everywhere). The compact card shows image, title, price and a **View Details** button. Each listing is independent, so different listings on the same page can use different layouts. Example: `[yatra_trip per_page="6" card_layout="compact_all"]`. The **Trip** block offers the same choice under **Trip Settings → Card layout**. | |
| 155 | + | |
| 154 | 156 | **Note:** If you're migrating from an older build, `[yatra_cart]`, `[yatra_checkout]` and `[yatra_mini_cart]` are no longer registered — checkout and the booking flow now use Yatra's own front-end routes and templates. See **[docs.wpyatra.com](https://docs.wpyatra.com)** for full shortcode reference, URLs and page setup. |
| 155 | 157 | |
| 156 | 158 | = 🎨 Compatible WordPress travel themes = |
| 157 | 159 | |
| @@ -267,20 +269,106 @@ | ||
| 267 | 269 | Pricing starts at **$99/yr** (Starter, sale) and goes up to **$599/yr** (Scale 15-site, sale). Lifetime plans available from **$499** one-time. Every Pro tier includes a **14-day refund** window. See the **[full pricing breakdown](https://wpyatra.com/pricing/)**. |
| 268 | 270 | |
| 269 | 271 | == Screenshots == |
| 270 | 272 | |
| 271 | -📷 **Screenshots** (as shown on WordPress.org) | |
| 273 | +1. Trip pages that sell themselves — gallery, duration, season and a sticky "Book Now" price button on any theme | |
| 274 | +2. Book in a few taps, no redirects — live departure availability, traveller count and enquiry, all inline | |
| 275 | +3. Your whole operation at a glance — bookings, revenue and upcoming departures the moment you log in | |
| 276 | +4. Every trip in one organised list — search, filter by status, and see pricing, type and availability instantly | |
| 277 | +5. Build a complete trip in one place — basics, pricing, itinerary, media and SEO, guided step by step | |
| 278 | +6. Never lose track of a reservation — filter by traveller, payment state and status across every departure | |
| 279 | +7. Full booking detail, one-click invoice — payment summary, traveller records and a downloadable invoice | |
| 280 | +8. Every transaction accounted for — Stripe, PayPal, bank transfer and manual payments in one ledger | |
| 281 | +9. Run offers without spreadsheets — coupon codes with usage limits, expiry dates and live status | |
| 272 | 282 | |
| 273 | -1. Yatra dashboard inside WordPress — bookings, revenue and quick access to daily tasks | |
| 274 | -2. Trip Creation Process — content, pricing, media and settings in one workspace | |
| 275 | -3. Trip list & All listing page — search, filters and status at a glance | |
| 276 | -4. Trip Booking Process — hero, itinerary and book flow | |
| 277 | -5. Global Settings - Payment Gateways etc. | |
| 278 | -6. Traveler account — bookings, payments and documents | |
| 279 | - | |
| 280 | 283 | == Changelog == |
| 281 | 284 | |
| 282 | 285 | The two most recent releases are listed below. For the complete version history, see [changelog.txt](https://plugins.svn.wordpress.org/yatra/trunk/changelog.txt). |
| 286 | + | |
| 287 | += 3.0.16 — 24 September 2026 = | |
| 288 | + | |
| 289 | +**Please read if you use reCAPTCHA.** With reCAPTCHA switched on for the booking form, checkout could not be completed on Stripe, Square or Authorize.net — the card form showed "reCAPTCHA verification failed. Please try again." and the payment never went through. Lowering the score threshold did not help, because no token was being sent at all. This release fixes that; if you turned reCAPTCHA off to take payments, you can turn it back on. | |
| 290 | + | |
| 291 | +**New** | |
| 292 | +* **Download a booking's invoice from the dashboard.** Bookings → ⋮ → *Download invoice*, and a *Download invoice* button on the booking detail, produce a PDF for the whole booking rather than for a single payment. Available to anyone who can view bookings. | |
| 293 | +* **Exclude a whole period from a recurring rule.** Trip → Availability → Recurring Rules gains **Excluded Periods**: give a first and last day and the rule skips everything in between, instead of adding a business vacation one day at a time. The existing single-date exclusions are unchanged and the two can be mixed. | |
| 294 | +* **Choose what goes in the sitemap.** Settings → SEO → *Content in the sitemap* lets you publish only the types you want — trips, destinations, activities, trip categories, listing pages. Leaving a type out of the sitemap does not stop search engines indexing it, so there is a separate, deliberately opt-in **Also add noindex to excluded types**. It is off by default, because switching it on removes those pages from search results. | |
| 295 | +* **Google Calendar controls** (with Yatra Pro). The Google Calendar screen gains *Resync Everything*, which walks every booking in batches and repairs the calendar in one click; an **Event reminders** editor so the 7/3/1-day reminders are no longer fixed; **Add customers as guests**, which keeps the customer's address off the event entirely so Google sends them no reminders or cancellations; and **One event per departure**, which puts every booking on the same departure into a single event with each booking's details in the description. The last one is off by default. | |
| 296 | + | |
| 297 | +**Fixed** | |
| 298 | +* **reCAPTCHA blocked checkout.** Gateways that handle the card themselves (Stripe here, Square and Authorize.net in Pro) submit the booking directly, so they never attached a reCAPTCHA token and the server rejected every attempt. Each now sends its own fresh token. The account-registration form on the booking page had the same gap and is fixed too. | |
| 299 | +* **Excluded dates were still bookable.** A date excluded from a recurring rule disappeared from the calendar but could still be booked by posting that date directly, because the resolver fell through to the trip's default availability. Excluded dates are now refused at checkout. An explicit availability row for that date, or another rule that generates it, still opens it as before. | |
| 300 | +* **Availability times were demanded for tours that have none.** Adding or editing an availability date on a single-day tour insisted on a start and end time even when the tour has no time slots configured, so the date could not be saved. Times are now required only for day tours that actually use time slots, arrival time is always optional, and every field says whether it is required. The capacity field also stops overwriting a value you have already typed, and its help text names the tour's own maximum. | |
| 301 | +* **Invoices and emails named the gateway, not its title.** Payment details showed the internal gateway id (`bank_transfer`) instead of the title your customers see at checkout ("Bank Transfer"). The payment invoice, the booking invoice, payment emails and the booking confirmation page now all use the checkout title, falling back to a readable version of the id for a gateway that no longer exists. | |
| 302 | +* The sitemap is rebuilt as soon as you change what it contains, instead of waiting up to an hour for its cache to expire. | |
| 303 | + | |
| 304 | += 3.0.15 — 15 September 2026 = | |
| 305 | +_With thanks to [Vista-Tours](https://vista-tours.de) for detailed testing and feedback._ | |
| 306 | + | |
| 307 | +**Please read before updating — three things start happening that did not before:** | |
| 308 | +* **Pre-trip reminder emails send again.** The reminder sweep was never scheduled and had no handler, and its booking query referenced a database column that does not exist, so no reminder has gone out. Both are fixed. Check the *Trip Reminder* template under Settings → Emails, or set *Booking Reminder (days)* to `0` to keep it off. | |
| 309 | +* **Unpaid bookings are cancelled automatically** after *Settings → Booking → Booking Expiry (hours)* (default 24) — that setting previously did nothing at all. Only bookings created after you update are ever expired, so your existing pending bookings are never cancelled retroactively. Expiring a booking now also releases its departure seat. Set the hours to `0` to disable. | |
| 310 | +* **Cancelling a booking now notifies your integrations.** `yatra_booking_cancelled` was never fired in-app, so Google Calendar kept cancelled bookings on the calendar and WhatsApp / webhook cancellation events never ran. Review those templates first. | |
| 311 | + | |
| 312 | +**New** | |
| 313 | +* **Day trips show hours.** A single-day tour with a duration in hours now reads "8 hours" instead of "1 Day" everywhere — trip cards, hero, quick facts, availability dates, checkout, the confirmation page and email, saved trips, and the voucher / itinerary PDF. | |
| 314 | +* **Configurable booking horizon.** *Settings → Booking → Booking horizon (months)* controls how far ahead customers can book (1–36, default 12); it was hard-coded to 12. | |
| 315 | +* **Quick status changes for enquiries.** The Enquiries list's ⋮ menu gains Mark as Completed / Closed / Spam, so an enquiry can be handled without opening it. | |
| 316 | +* **Auto-Confirm Bookings becomes a three-way choice** — don't auto-confirm, online payments only, or all. | |
| 317 | +* **Compact listing card layout** for trip archives, shortcodes and the Trip block. | |
| 318 | +* **Per-trip booking forms and per-trip email templates (with Yatra Pro).** Settings → Booking Form gains a **Conditions** button (Pro Dynamic Form Field) so selected trips, categories or trip types can use their own version of each form; Email → Templates gains **Override templates** (Pro Email Automation) — a trip-specific version of any booking email, sent *instead of* the global one. The free plugin ships the editors, a trip-aware `GET /settings/booking-form?trip_id=` endpoint, `trip_id` in every booking email's merge variables, and the `yatra_booking_form_config( $config, $tripId )` filter; without Pro nothing changes. | |
| 319 | +* **Payments card on the booking detail** listing every payment recorded against the booking (amount, method, date, reference, status). | |
| 320 | + | |
| 321 | +**Fixed** | |
| 322 | +* **A manually recorded payment now counts.** *Payments → Add New Payment* defaulted to *Pending* and offered a *Partial* status the database does not have, so a deposit recorded by hand never increased the booking's paid amount, never reduced the balance and triggered nothing. The form now defaults to **Completed**, *Partial* is gone, and a payment that becomes Completed (recorded, edited or *Mark as Completed*) fires `yatra_payment_completed` exactly like an online payment — payment-received emails, Pro `payment.partial_received` / `payment.received` automations, webhooks and WhatsApp — once per payment. | |
| 323 | +* **Partial payments used the wrong email on Pro sites.** With the Pro *Partial Payment Received* template switched on, a deposit still went out as the full *Payment Received* email (`payment.received`); the chooser only honoured the free plugin's own toggle. It now honours the active Pro template, so a payment that leaves a balance sends the partial template and event. | |
| 324 | +* **Language metadata followed the plugin, not the site.** Trip and listing pages printed `og:locale="en_US"`, `hreflang="en-US"` and `inLanguage="en-US"` on every site; they now follow the WordPress locale (`de_DE` / `de-DE` on a German site, including *Deutsch (Sie)*). | |
| 325 | +* **Empty 360° tour and video modals were injected into every page** by `tour-viewer.js` / `video-player.js` (an empty `h3.yatra-tour-viewer-title` on the homepage, for example). Both are now built on first use only. YouTube *Shorts* URLs now embed correctly. | |
| 326 | +* *Resend → Booking confirmation* on a **completed** booking sends the "Booking confirmed" email, not the pending-wording one. | |
| 327 | +* Booking Form settings are now sanitised on save (the structured sanitiser was unreachable); the storefront date-pricing request no longer returns HTTP 500 on trips with date-specific departures; Edit Booking no longer hits a 401 loading tax settings. | |
| 328 | +* **Duration (Hours) can now be saved.** The trip form showed the field for single-day tours but never included it in the save request, so the value was dropped and the field reloaded empty — the new hours display could not be used. Switching a trip back to multi-day now clears any stored hours rather than leaving a stale value. | |
| 329 | +* Departures: *Upcoming* no longer hides sold-out departures; capacity is a separate **Availability** filter; the list is genuinely paginated and its search box works. | |
| 330 | +* Enquiries: the status tabs showed `0` for every count; the bulk *Mark as Completed* action silently did nothing; a submission containing a `subject` field returned a server error. | |
| 331 | +* The confirmation email is sent when a gateway payment auto-confirms a booking, and *Resend → Booking confirmation* resends the right template. | |
| 332 | +* Gateways honour the Auto-Confirm setting instead of always confirming. | |
| 333 | +* The "Payment not completed" notice can now be translated. | |
| 334 | + | |
| 335 | += 3.0.14.2 — 31 August 2026 = | |
| 336 | +* **Fresh installs now create the trips table correctly:** a semicolon inside a column comment broke the `wp_yatra_trips` table creation during dbDelta, so a brand-new install could end up without the trips table — the tour list and sample-data import then failed. Existing sites were unaffected; updating recreates the table automatically. | |
| 337 | + | |
| 338 | += 3.0.14.1 — 31 August 2026 = | |
| 339 | +* Declared compatibility with WordPress 7.1. | |
| 340 | + | |
| 341 | += 3.0.14 — 31 August 2026 = | |
| 342 | +_With thanks to [Vista-Tours](https://vista-tours.de) for extensive beta testing and the detailed feedback behind many of the fixes in this release._ | |
| 343 | + | |
| 344 | +* **Resend booking and payment emails by hand:** administrators can now re-send a booking's confirmation, payment, cancellation, reminder and completed emails — and the admin copies — from the booking view, after a manual change or when an automated email failed to arrive. | |
| 345 | +* **Set a day tour's length in hours:** a single-day trip can carry a duration in hours (for example an 8-hour experience). The tour then shows its length in hours, and — with Yatra Pro — Google Calendar creates a same-day timed event of that length instead of an all-day, multi-day one. | |
| 346 | +* **Dashboard capacity and occupancy match the Departures page:** the dashboard now reads capacity from your Availability configuration, exactly like Departures, so the two no longer disagree. Legacy "unlimited" capacity markers left on old departures are normalised, and a fully-booked upcoming tour stays visible on the dashboard instead of dropping out of the list. | |
| 347 | +* **Star rating on the booking confirmation shows the right colour:** the rating stars rendered all grey on the confirmation page because a stylesheet was not loaded there; the correct colours are now applied. | |
| 348 | +* **Cancelling a gateway payment returns to a working page:** cancelling PayPal (or any gateway) under a custom booking page led to a 404. Cancel and failure now land on the booking-confirmation page with a clear "payment not completed" notice. | |
| 349 | +* **Offline gateways are never auto-completed:** Bank Transfer and Pay Later bookings could be marked paid automatically; they now stay pending until you confirm the payment by hand. | |
| 350 | +* **Correct decimal separator in payment amounts:** amounts formatted wrongly on some European browsers; currency now formats consistently from your store settings. Invoices also use the booking reference as the invoice number. | |
| 351 | +* **Completed (past) departures stay visible** in the tour list and the Past tab, independent of when the daily maintenance runs; **bulk-deleting departures** works from the all-tours view; and a new optional **date filter** in trip search and listings lets visitors find tours available on or after a chosen date. | |
| 352 | +* **Changing a booking's tour moves its departure with it,** releasing the seat from the old departure and reserving it on the new one. | |
| 353 | +* **Global "Always BCC" address can be saved:** the field under Settings → Email accepted an address but never stored it. It now saves, and accepts several comma-separated addresses. | |
| 354 | +* **The email template list opens on the Active view,** so disabled or unused templates stay decluttered out of sight; the All and Inactive tabs remain available to review or re-enable them. | |
| 355 | + | |
| 356 | += 3.0.13 — 21 July 2026 = | |
| 357 | +* **Star ratings now match the number shown:** a 4.9 average drew four-and-a-half stars beside the printed "4.9". Ratings round to the nearest half star everywhere — trip pages, the reviews block, listing cards and the booking confirmation all draw the same rating identically. | |
| 358 | +* **Dashboard occupancy is no longer stuck at 0%:** the dashboard ignored the capacity figures the departures list actually returns, so every tour showed 0% occupied and available seats could read as a negative number, while the individual trip page calculated it correctly from the same departures. | |
| 359 | +* **Departures honour the seats set on a time slot:** a private tour whose vehicle holds 9 passengers but sells a single booking unit per departure still showed 9 available. Capacity defined on a time slot is now used everywhere it applies, and where a date has several departure times each one uses its own seat count instead of the day's total. | |
| 360 | +* **Sold-out dates no longer accept bookings:** a date marked sold out could still be booked, because the seat check looked past the sold-out record and fell back to the tour's overall capacity. Sold-out dates are now refused at checkout, or offered as a waitlist where the waitlist is enabled. | |
| 361 | +* **Choose how sold-out dates appear:** a new *Show sold-out dates* option under Settings → Booking. Leave it on to keep them on the calendar marked "Sold out" (needed for the waitlist), or turn it off to hide them entirely, the way blocked dates are hidden. Existing sites are unchanged. | |
| 362 | +* **Dates marked unavailable are hidden and unbookable:** an unavailable date stayed visible and could still be booked, unlike blocked, closed and cancelled dates. | |
| 363 | +* **Manual payments recorded the wrong currency:** a payment added by hand was saved as USD regardless of the store currency, so a euro shop saw dollar amounts sitting beside correctly-formatted euro ones. Existing payment records are left as they are; new ones follow the store currency. | |
| 364 | +* **Payment methods are labelled consistently:** the Payments list printed whatever each record happened to store, so gateway payments showed "paypal" while hand-entered ones showed "PayPal" or "Credit Card". Every row now shows the gateway's proper name. | |
| 365 | +* **Changing the number of participants is saved:** editing the traveller count on an existing booking had no effect — the booking was saved with the original count, because the number was read from the traveller list rather than the field. Changing it now adds or removes traveller entries to match. | |
| 366 | +* **Confirming a booking from the edit screen sends the confirmation email:** moving a booking to Confirmed from the booking editor saved the status but sent nothing and triggered no automation, while doing the same from the status action worked. Both routes now behave identically — and cancelling from the editor releases the seats, which it previously did not. | |
| 367 | +* **Backend bookings reduce availability on tours with several departures a day:** a booking added from the admin never said *which* departure it was for, so on a tour running more than one departure a day it reserved no seats and the frontend still showed the date as free. The booking screen now asks for the departure time whenever the chosen date runs more than one, and the seats come off that departure. | |
| 368 | +* **Invoices and vouchers show the complete business address:** only the street line was printed, so the town, postcode and country were missing from every document. All the address fields you have filled in are now included. | |
| 369 | +* **The dashboard no longer goes blank:** a payment with no date threw an error that took the whole dashboard down with it. Dates that are missing or unreadable now simply render as "-" anywhere in the admin. | |
| 370 | +* **Choosing a trigger event when creating an email template:** the template panel showed the event as a read-only badge with nothing to change it, directly beneath text asking you to pick one. It is now a working dropdown listing every available event. | |
| 283 | 371 | |
| 284 | 372 | = 3.0.11 — 20 July 2026 = |
| 285 | 373 | * **Departures now honour your recurring availability rule:** a tour with a 9-seat vehicle but a rule allowing only **1 booking per date** showed 9 under Departures. Overlapping rules were resolved in an arbitrary order (every rule carries the same priority), so the wrong one could win and the display fell back to the tour's passenger capacity. Rule matching is now deterministic — the most recently created rule wins a tie — and rules created in the editor are read correctly everywhere. |
| 286 | 374 | * **Departures can be deleted again:** deletion always failed with *"Manual departures or departures with bookings cannot be deleted"*, even for an empty, auto-created departure. The check required an internal value the plugin never actually stores, so **no** departure was ever deletable. A departure can now be removed once no bookings remain — checked against the real booking records rather than a counter that can drift — and departures with bookings are still protected. |
