🆓 Step 1 — Install the Free Plugin (from WordPress.org)

Pick one method. The easiest way is to install directly from the WordPress repository:

1. Go to Plugins → Add New Plugin in the admin dashboard.
2. Type "ABP Tour & Travel" in the search box and press Enter.
3. Click Install Now on the ABP Tour & Travel plugin card.
4. Click Activate when the installation finishes.

📦 Step 2 — Install by Uploading a ZIP

If you have the ZIP file locally (downloaded from your account on abp-team.com), use the upload method instead:

1. Go to Plugins → Add New Plugin.
2. Click the Upload Plugin button at the top.
3. Choose the .zip file and click Install Now.
4. Click Activate Plugin to make it live.

🔧 Step 3 — First-time Setup

After the plugins are active, configure them in this order so everything has the data it needs:

1. Go to ABP Tour & Travel → Configuration and set the tour label, slug and general settings.
2. In the same Configuration tab open Dates and set the global date format, sale buffer and advance-booking window.
3. Decide which features you need under Configuration → ON/OFF.
4. Create reusable Global Data — Locations, and (if enabled) Categories, Operators, Features, Additional Services, Traveler Forms, Guides, Why Book With Us and Resources.
5. Create Ticket types and/or Seat plans under Ticket/Seat Plan that the tours will reuse.
6. Open Tour Lists → Add New to create your first tour and fill in its configuration tabs left to right.
7. Publish the tour and place a test booking through the WooCommerce checkout to confirm tickets and seats work.

The cards below group every feature of the plugin. Overarching capabilities such as the all-in-one tour booking dashboard and the tour management system apply across the whole plugin.

🎭 Events & experiences you can sell

🌍 Supported tour types

• Single-date events with one or more starting times
• Recurring / periodic tours (for example, every weekend)
• Multi-location experiences using reusable Locations
• Multi-category listings using reusable Categories
• Guided experiences with guide profiles shown on the tour page
• Itinerary-driven tours using the Timeline section

📊 Menu overview

The menu bar shown inside the ABP Tour & Travel admin area contains the following tabs:

⚙️ Configuration sub-menu

Under the single Configuration tab the following sub-tabs are available (some appear only when the related feature switch is ON):

• Tour (shows your custom label) — general tour label, slug and store settings
• ON/OFF — enable or disable individual plugin features
• Dates — global date format, buffer and advance-booking window
• Locations — reusable tour locations
• Category — reusable tour categories
• 🏢 Organizer — reusable tour organizers / operators
• 🧑‍🏫 Guides — reusable guide profiles
• 🔗 Features — reusable tour features (badges)
• 🧰 Additional Services — reusable additional services
• 📋 Traveler Forms — reusable traveler information fields
• ❓ FAQ — global questions and answers
• 📜 Terms & Conditions — global terms and conditions
• ⭐ Why Book With Us — global reasons
• Slider — featured tour slider settings
• Contact Information — company details shown on bookings
• CSS Property — custom CSS colors and fonts

📥 Demo Import

The Demo Import menu lets you import a ready-made set of sample tours (with locations, categories, ticket types and images) so you can explore the plugin safely — and remove that demo data again with one click when you are done.

⚡ Quick Actions

The Quick Actions card on the Dashboard gives fast access to commonly used screens in one click:

• Manage Tour — open the tour list
• Orders — view and filter bookings
• Ticket/Seat Plan — design seat layouts
• Configuration — reusable data (dates, locations, categories and more) plus plugin settings
• ON/OFF Configuration — enable and disable features
• Global Date — manage global dates
• Additional Services, Traveler Forms, Locations — feature-dependent shortcuts

👋 Welcome Banner

The top hero section greets the logged-in admin by name, shows today's date and summarizes what is happening with the tour booking business today. Two quick buttons are always available:

• ＋ Add New — opens the WordPress editor to create a new tour.
• Orders — jumps straight to the admin Order List.

🔢 Key Performance Cards

Clickable stat cards summarize the whole business. Each card opens the matching admin screen when clicked:

🗓️ Today Tours

The main column lists today's tours. Each row shows the tour, date and time and availability counts. Clicking a tour opens a popup with a live Seat Map (for seat-plan tours) or a Ticket Type Breakdown (for ticket-only tours), plus the list of bookings for that tour.

🧾 Recent Orders

The Recent Orders card shows the latest bookings with view tabs for the last orders and today's orders, plus an All Orders link that opens the full Order List.

⚡ Quick Actions (side panel)

The sidebar gives one-click shortcuts to the most commonly used screens:

• ON/OFF Configuration — enable or disable plugin features.
• Global Date — manage global dates.
• Additional Services and Traveler Forms — shown only when the related feature switch is enabled.
• Locations — manage reusable tour locations.

🖥️ System Status & Content Breakdown

The sidebar also shows a System Status card with the current plugin, WordPress, PHP and WooCommerce versions, plus quick tools to install WooCommerce, create the booking / tour-list / gallery pages — and import or remove the demo data. A Content Breakdown card shows quick counts of your content by type.

📋 What the list shows

• Tour thumbnail, title and status (Published / Draft / Trash)
• The tour's category, location and organizer (when enabled)
• Ticket / seat summary — total tickets and sold count
• Pagination for large catalogs

🛠️ Available actions

📝 Core fields

🏷️ Classification

• Category — pick from the reusable global categories (shown when the Category switch is ON).
• Location — pick the tour's reusable location / meeting point.
• Organizer / Operator — pick the reusable organizer (shown when enabled).
• Features — highlight badges shown on the tour page (E-Ticket, VIP Access, Parking…).

🎟️ Ticket selling mode

Also on this tab you choose how the tour sells tickets, and whether multiple ticket categories are allowed:

• Ticket Type — general admission by quantity (best for festivals, conferences, workshops).
• Seat Plan — assigned seating; customers pick a seat (best for concerts, theaters, buses).
• Multiple Ticket Type — enable to sell several categories at once (Adult + Child + VIP).

🧩 Selling modes

💰 Price & quantity fields

📉 How stock decreases

Seats / tickets are deducted from inventory when an order reaches the status you set in Configuration → General → Booked Status. Paid orders therefore reduce the numbers customers see on the tour page.

📅 Date types

⏳ Advance booking & buffer

• Advance booking — how far ahead customers can book (from the global date settings).
• Sale buffer — a minimum lead time before a date so you don't sell too close to departure.
• Global formatting, sale buffer and the advance window are set under Configuration → Dates.

🕘 What you configure

• Start time — the departure / start time for the tour.
• Multiple times — add several start times so customers can choose a slot.
• Duration — the tour length, shown to customers on the tour page.

🔁 Multiple time slots

Each time slot is sold against the same ticket stock or seat plan unless the tour uses a seat plan per slot. Use multiple slots to sell the same experience several times in a day.

🧩 What a service contains

📥 Import & customise

• Create a reusable list once under Configuration → Additional Services.
• Import those services into any tour and adjust the price / quantity per tour.
• Disable a service for a single tour without changing the global list.
• Customers select available services during checkout; the total updates live.

🧩 Building the form

• Add fields and choose their type (text, e-mail, phone, number, date, select, textarea…).
• Mark fields as required or optional.
• Set a label and placeholder so customers know what to enter.
• Reorder fields to match your booking flow.

👥 Multiple travelers

When a booking includes several tickets, the form collects details per guest (where configured), so you have a complete traveler list for each booking.

🕘 Timeline entries

Each entry is a small step made of a time, a title and an optional description. Add one entry per moment in the itinerary:

1. Time — e.g. 09:00.
2. Title — e.g. “Meet at the entrance”.
3. Description — a short line describing what happens.

👤 Guide profile fields

🔗 Assigning guides to tours

• Enable Tour Guide in Configuration → ON/OFF.
• Create guide profiles under Configuration → Guides.
• On the tour, open the Guides tab and select the guide(s) for that tour.
• Guides appear below the timeline on the tour page, each linking to its own profile page.

📝 FAQ structure

• Each entry is a question paired with its answer.
• Questions are displayed as an accordion on the tour page.
• Order questions so the most important ones appear first.

🔄 Global vs. tour-specific

Import the global FAQ into a tour to inherit every global question, then customise that tour's list independently — the global list is not changed.

📝 What to include

• Booking and cancellation policies
• Refund and rescheduling rules
• Entry requirements and age restrictions
• Any venue- or tour-specific conditions

🔄 Global vs. tour-specific

Import the global terms into a tour to start from your standard policy, then adjust it for that tour if needed. Changes stay on the tour and never modify the global text.

🧩 Structure

🔒 What “hidden” means

• The tour does not appear in the tour list / booking listing.
• The tour is excluded from category, location and search results.
• The tour page itself still works when accessed directly by its URL.
• Booking, tickets, seats and checkout behave exactly like a normal tour.

🔗 How to use it

1. Create the tour as usual with all its configuration.
2. Mark it as hidden.
3. Share the direct tour URL (or a booking shortcode pointing to the tour's post_id) with the people who should be able to book it.

🔎 Advanced Order Filtering

A powerful filtering system lets you narrow down bookings by tour, date, location and order date.

📊 Booking Status Tabs

Separate status tabs let you view bookings according to their current booking and payment status.

🎫 Booking & Ticket Information

Each order row displays key booking details at a glance.

• Tour — the tour associated with the booking.
• Date & Time — the selected tour date and time slot.
• Ticket Info — selected ticket types or seats, quantities and ticket prices.
• Additional Info — additional services or other booking-related information.

💰 Order & Payment Information

• Price — the base ticket or order price.
• Additional — additional service charges.
• Total — the final booking amount.
• Payment Method — the payment method used for the booking.
• Status — the current order status.

👤 Customer & Billing Information

• View customer billing name and email information.
• Access billing details associated with each booking.
• Review guest and booking information from the order list.

📋 Order Management

• View complete booking information from the centralized order table.
• Track booking and payment status quickly.
• Review date, ticket, guest and pricing information.
• Access detailed order information when required.

🎫 Ticket Type Management

Define reusable ticket types that can be shared across multiple tours and seat plans.

• Create and manage dynamic ticket types for use across tours.
• Define ticket names, icons, colors and ticket prefixes.
• Use different ticket types such as Ticket, VIP, Business Class, Special, Couple, Female, Adult, Child and Economy.
• Reuse the same ticket types across multiple seat plans and tours.
• Configure ticket types according to your booking requirements.

🎨 Decor Item Management

Decor items represent non-seat elements of the layout — doors, aisles, windows and so on.

• Create and manage decorative items for seat plan layouts.
• Use items such as Driver Seat, Door Entry, Stairs, Aisle/Walkway, Window, Engine Box, Toilet, Luggage Rack, Food/Snacks and Emergency Exit.
• Arrange decorative elements to represent the real layout.
• Use decor items for visual organisation without treating them as passenger seats.

💺 Reusable Seat Plans

Create a seat layout once and assign it to multiple tours. This reduces repetitive work when the same arrangement is shared by different events.

• Create and manage multiple reusable seat plans.
• Assign a seat plan to multiple tours.
• Automatically calculate the total number of available seats.
• Automatically identify and count assigned ticket types.
• View seat type quantities directly from the seat plan list.
• Duplicate or manage existing seat plans when needed.

⚙️ Seat Plan Layout Configuration

• Define the number of rows and columns for the seat layout.
• Configure the seat plan background image or background color.
• Set individual cell width, height, gap and radius.
• Add or remove rows and columns according to the required layout.
• Create complex layouts using multiple cells for selected elements.
• Arrange seats and decorative items according to the real structure.

🪑 Seat Type Assignment

• Select a ticket type and assign it to available seat cells.
• Automatically assign seat numbers according to the selected ticket type.
• Manage different seat categories within the same seat plan.
• View ticket-type-wise seat quantities while designing the layout.
• Select and modify individual seats or multiple cells when required.

🖱️ Interactive Seat Plan Editor

• Drag cells to change their position.
• Drag-select multiple cells for easier layout management.
• Double-click to edit row/column span settings.
• Ctrl + Click to select a particular item or range.
• Shift + Click to select any range of cells.

🔢 Automatic Seat Numbering

• Automatically generate seat numbers when assigning ticket types.
• Maintain ticket-type-specific seat numbering (e.g. VIP-01, B-01).
• Keep seat numbering organized across the complete seat plan.

🧩 What belongs here

🎛️ Popular switches you may want to change

🟢 Extra tour-page sections (turn ON to show)

• Tour Timeline — time-by-time itinerary section.
• Tour Guide — guide profiles and public guide pages.
• Google Location Map — map for the tour location.
• Why Book With Us — trust-building reasons section.

Global configuration helps maintain consistent data across tours while reducing repetitive setup and simplifying the management of locations, schedules, tickets, guests, services and other booking-related information.

🌍 Centralized Global Configuration

• Manage commonly used booking data from one centralized location
• Create reusable configurations for multiple tours
• Reduce repetitive data entry and configuration work
• Maintain consistent information throughout the booking system

⚙️ Available reusable data

🔄 Reusable configuration

• Configure data once and reuse it across multiple tours
• Import or apply global settings where supported
• Customize tour-level settings when specific requirements are needed
• Keep commonly used booking data organized and easy to manage

🚀 Benefits

• Saves time during tour configuration
• Reduces duplicate data entry
• Keeps common booking information consistent
• Makes large booking systems easier to manage

🧩 What you configure

🧩 What a location contains

🔗 Where locations are used

• Selected on the tour's General tab.
• Available as a filter on the frontend tour listing.
• Shown with a map when the Google Location Map switch is ON.

🧩 What a category contains

• A name shown in listings and filters.
• An optional image / icon for category cards.
• An optional description.

🔗 Where categories are used

• Selected on each tour's General tab.
• Used as a filter on the frontend tour listing.
• Usable as a parameter (cat_id) in listing shortcodes.

🧩 What an organizer contains

🔗 Where organizers are used

• Selected on each tour's General tab.
• Available as a filter on the frontend listing.
• Usable as a parameter (organizer_id) in listing shortcodes.

🧩 Guide profile fields

🔗 Assigning guides to tours

• Create the profiles here under Configuration → Guides.
• On a tour, open the Guides tab and select the guide(s).
• Guides appear below the timeline on the tour page and link to their profile page.

🧩 What a feature contains

• A title — the short badge label.
• An icon — an icon or emoji shown next to the label.
• Optional supporting detail if configured.

🔗 Where features are used

• Selected on each tour's General tab.
• Displayed as badges on the tour page to communicate what's included.
• Reusable across every tour that shares the same amenities.

🧩 What a service contains

🧩 Field options

• Choose a field type (text, e-mail, phone, number, date, select, textarea).
• Set a label and placeholder.
• Mark the field required or optional.
• Reorder fields to match your booking flow.

👥 Typical fields

• Full name, e-mail and phone number
• Age or date of birth (for age-restricted events)
• Passport / ID number (for travel experiences)
• Dietary requirements or accessibility notes

🧩 Structure

• Question — the customer's question.
• Answer — the response shown when the question is expanded.
• Order the entries so the most important questions come first.

🚀 Examples

• “Do I need to print my ticket?”
• “What happens if it rains?”
• “Is there an age restriction?”
• “Can I get a refund?”

📝 What to include

• Booking confirmation rules
• Cancellation, refund and rescheduling policy
• Late arrival / no-show policy
• Age restrictions and entry requirements
• Liability and conduct statements

🧩 Structure

🚀 Strong reasons to include

• Instant ticket delivery
• Secure payment
• Free cancellation
• Expert guides
• Small groups
• Best-price guarantee
• 24/7 customer support

🧩 What you configure

• Display style — gallery or slider.
• Autoplay — whether the slider advances automatically and the delay between slides.
• Navigation — arrows and the image indicator strip.
• Popup viewer — clicking an image opens it in a full-screen popup with next / previous navigation.

🧩 What to fill in

🧩 What you can set

• Primary color — buttons, links and highlights.
• Secondary / accent color — secondary actions and badges.
• Text color — body text on the booking pages.
• Font family and size — typography of the interface.

🧩 What customers see

• A list of their own tour bookings only.
• Booking status and details for each order.
• The selected tour, date and time.
• Ticket / seat and guest information.
• A paginated list for customers with many bookings.

📦 What gets imported

• Sample tours with images, descriptions and schedules
• Sample locations and categories
• Sample ticket types and seat plans
• Supporting configuration for the samples

🔄 Removing the demo data

The same screen includes a Remove option that deletes the demo content and its imported media in one step, leaving your own content untouched. The plugin marks demo items internally so only demo data is removed.

🔄 Overview

Each shortcode supports parameters for controlling layout, filtering, item count and frontend display. Parameters can be combined to create customised tour listing and booking pages tailored to your requirements.

🎫 Booking Shortcode

The [abptt-booking] shortcode displays the full booking interface — a tour listing with search and filters that leads into ticket / seat selection and checkout. Ideal for your dedicated Booking page.

📋 Listing Shortcode

The [abptt-post] shortcode displays a tour listing without the booking wrapper. It is useful for dedicated listing pages. Ideal for your Tour List page.

🖼️ Gallery Shortcode

The [abptt-gallery] shortcode displays tour images in a gallery or slider layout anywhere on your website, with a popup viewer and next / previous navigation.

🛠️ Template Override

To start customising the plugin templates, copy the tt_templates folder from the plugin directory and paste it into your wp-content directory. Once the custom template folder is detected, the plugin loads your customised template files instead of the corresponding default plugin templates.

📁 Customise Only the Required Templates

You do not need to keep every template file in the copied folder. Keep only the files you actually want to customise and remove any unnecessary files. This allows the plugin to continue using its default templates for all other sections and makes future template maintenance easier.

🎨 Timeline Themes

The timeline ships with multiple built-in styles (default, light, modern). The active style is chosen in the plugin settings and its template can also be overridden from the same tt_templates folder.

🔄 Plugin Updates & Template Overrides

Custom template files are not automatically updated when the plugin is updated. If a new plugin version introduces changes to the default templates, compare your overridden files with the latest plugin templates and update your customisations when necessary.

⚠️ Development Requirements

• Basic knowledge of WordPress template structure is recommended.
• Basic PHP and HTML knowledge may be required for template customisation.
• Make changes carefully and test customised templates after plugin updates.
• Always keep a backup of your customised templates before making major changes.

🔤 Translate ABP Tour & Travel

Follow these steps to create a translation for your preferred language using Loco Translate:

1. Install Loco Translate — Go to Plugins → Add New, search for Loco Translate, then install and activate the plugin.
2. Open the plugin — Navigate to Loco Translate → Plugins and select ABP Tour & Travel.
3. Create a translation — Choose an existing language or click New language to create a translation for your preferred language, then select the appropriate translation location and create the translation file.
4. Sync and translate — Click Sync to load the latest translatable strings from the plugin, translate the required strings, and click Save.

🔄 Updating Translation Strings

When the plugin is updated and new translatable strings are added, open the corresponding translation in Loco Translate and click Sync to update the translation catalog. You can then translate any newly added or modified strings and save the changes.

💡 Translation Notes

• ABP Tour & Travel uses standard WordPress translation functions and is translation-ready.
• Plugin interface text and other registered translatable strings can be translated through Loco Translate or another compatible translation plugin.
• Dynamic content entered by administrators — tour names, location names, ticket names and custom descriptions — may require separate translation depending on how the content is created and displayed.
• Documentation content is not automatically translated through the plugin's translation files.

🛡️ Keep Your Translations Safe

To prevent translations from being overwritten during plugin updates, avoid storing customised translation files directly inside the plugin's own directory. Use the custom or system-protected translation location provided by Loco Translate whenever possible.