WanderLux Documentation

1 Overview

WanderLux turns WordPress into a complete travel-agency website. Holiday packages, standalone activities, and destination guides are managed as their own content types, each with galleries, itineraries, pricing, and reviews. Visitors search by destination, travel month, and holiday type from the homepage, browse curated sections, and either submit a quick enquiry or — on the Pro edition — complete a full online booking with payment-method selection.

The theme ships as two separate installable packages built from the same codebase:

• WanderLux Free — every public-facing template, the hero search, lead-capture enquiries, and a focused admin dashboard.
• WanderLux Pro — everything in Free, plus the multi-step booking & payment flow, Wishlist, admin Bookings/Analytics/Subscribers, the newsletter popup, and GA4/GTM tracking.

You only install one of the two zip files — never both at once.

Fully responsive — the mobile menu, hero search, and every template adapt down to phone width.

2 System Requirements

The theme uses a custom database table (wp_wl_bookings) for the Pro booking system, created automatically on activation — no manual database setup is required.

3 Installation

Method A — Upload via WordPress Admin (recommended)

1. In your WordPress dashboard go to Appearance → Themes → Add New → Upload Theme.
2. Choose WanderLux-Free.zip or WanderLux-Pro.zip and click Install Now.
3. Click Activate once the install finishes.

Method B — FTP / File Manager (if the uploader is blocked)

Some hosts block zip uploads that contain .php files as a security precaution. If you see an error like "The package could not be installed", use this method instead:

1. Extract the zip file on your computer — you'll get a WanderLux folder.
2. Connect to your server with an FTP client (e.g. FileZilla) or your host's File Manager.
3. Upload the entire WanderLux folder into wp-content/themes/, so the path becomes wp-content/themes/WanderLux/style.css.
4. Go to Appearance → Themes in wp-admin — WanderLux now appears there. Click Activate.

4 Demo Data Import

After activating the theme, the fastest way to see WanderLux fully populated is the built-in demo importer.

1. Go to WanderLux → Demo Data in the admin menu.
2. Click Install Demo Content. This creates sample packages, activities, destinations, testimonials, team members, pages (Home, Packages, Activities, Destinations, About, Contact, Booking Confirmation, My Bookings), a menu, and assigns the homepage.
3. Wait for the progress steps to complete — this can take 20–60 seconds depending on your server.

You can re-run the importer at any time; it will not duplicate pages that already exist by slug.

5 Menus & Pages

WanderLux registers four menu locations:

• Primary Navigation — the main header menu.
• Footer Column 1 / 2 / 3 — the three link columns in the footer.

Assign menus under Appearance → Menus, or let the Demo Data importer create and assign a starter menu for you. Set your homepage under Settings → Reading → Your homepage displays (the importer does this automatically when you choose the "Home" page).

6 Theme Settings

All agency-wide settings live under WanderLux → Settings in wp-admin, organised into cards:

7 Customizer

Open Appearance → Customize for live-preview options:

• Site Identity — custom logo, site title, tagline.
• Hero Content — homepage headline and subline text.
• Footer — copyright text.

For deeper visual changes (colors, spacing, fonts), the design tokens are defined as CSS custom properties at the top of assets/css/main.css — for example --navy, --orange, --teal, --radius. Changing these values restyles the whole site consistently.

8 Custom Post Types

Packages are grouped with the wl_pkg_cat taxonomy (International, Domestic, Honeymoon, Weekend, Adventure, Family, Group, Luxury, etc.) — used by the hero search's Holiday Type field and the archive page filters.

9 Hero Search Bar

The homepage hero search lets visitors filter by destination (free-text with autocomplete suggestions), travel month, and holiday type, then submits to the packages archive with the matching filters pre-applied. The Holidays / Activities / Destinations pill tabs above the search bar are plain links that jump straight to each archive — no JavaScript required for that part, so they always work even if a script fails to load elsewhere on the page.

10 Lead Enquiries (Free & Pro)

The "Plan My Trip" modal, available on every page, is the universal lead-capture form. A visitor submits their name, contact details, destination, travel month and traveller count; you receive an instant email and the enquiry is saved under WanderLux → Enquiries, where you can change its status (New / Contacted / Quoted / Booked / Lost) and add internal notes.

On the Free edition this is the only way visitors can request a holiday — there is no self-service checkout.

11 Booking & Payments PRO

On a Pro-licensed site, the "Book This Tour" button on every package page opens a 3-step booking modal instead of the lead-capture form:

Trip details → Contact details → Review → Confirmation, end to end.

1. Trip details — travel date (with a date picker), number of adults/children with live price calculation, and a payment method (Bank Transfer, Cash/Cheque, or UPI/Online).
2. Contact details — name, email, phone, country, special requests, and terms acceptance.
3. Review & confirm — a summary of everything entered before the booking is submitted.

On submit, a unique booking reference (e.g. WL-A1B2C3D4) is generated, confirmation emails are sent to both the customer and the agency admin, and the visitor is shown a success screen before being redirected to the Booking Confirmation page, where the reference, itinerary and total are displayed.

12 Wishlist PRO

The heart icon on every package card and on each package's detail page lets visitors save tours to a personal wishlist, stored in their browser (localStorage, no account required) and viewable at /wishlist/. On the Free edition the heart icon is still visible but shows an "Upgrade to Pro" message instead of saving — so the upsell is visible without breaking the page layout.

Clicking the heart instantly saves the card and shows a confirmation toast.

13 Newsletter Popup PRO

An exit-intent / 30-second-delay popup offering a discount code in exchange for an email address. Configure the offer headline and subtext under WanderLux → Settings → Newsletter Popup, then tick Enable Newsletter Popup. Subscribers collected here (and from the footer newsletter form) are listed under WanderLux → Subscribers.

14 Admin Dashboard

Available to every edition under WanderLux → Dashboard, but the content differs:

Pro also adds two dedicated admin pages: Bookings (full list with filters, status updates and CSV export) and Analytics (deeper revenue/traffic charts). Both are hidden from the menu entirely on Free — not just locked, so the menu stays clean.

15 Analytics & Tracking PRO

Paste a Google Analytics 4 Measurement ID and/or a Google Tag Manager ID into WanderLux → Settings → Analytics & Tracking and the corresponding snippets are injected into every page automatically on the Pro edition. A generate_lead GA4 event also fires automatically whenever a Plan My Trip enquiry is submitted, so lead volume shows up in your GA4 reports without extra configuration.

16 Free vs Pro — Full Comparison

17 Troubleshooting

"The theme is missing the style.css stylesheet"

This means the zip didn't extract correctly on the server. Use Method B (FTP / File Manager) from the Installation section instead of the zip uploader.

Demo images don't load

Demo content links to Unsplash for preview only — confirm your server can make outbound HTTPS requests, or simply replace featured images with your own uploads.

Booking / Wishlist buttons don't do anything

Confirm you've installed WanderLux-Pro.zip, not Free — these are Pro-only features and are intentionally inactive on Free.

Emails aren't arriving

WordPress sends mail via PHP's mail() function by default, which many hosts block or mark as spam. Install an SMTP plugin (e.g. WP Mail SMTP) and connect it to a transactional email service for reliable delivery.

18 Credits & Support

• Font Awesome 6 — icons
• Google Fonts (Playfair Display, Inter) — typography
• Flatpickr — date picker (Pro booking flow)
• Chart.js — admin analytics charts (Pro)
• Demo photography — Unsplash, for preview purposes only

For support, refer to README.txt in the theme folder, or contact your theme provider through the marketplace you purchased from.