1. Introduction

Thank you for choosing Odysseo — a premium theme for travel agencies, tour operators and car-rental businesses. It ships with custom post types for Destinations, Tour Packages, Fleet and Testimonials, a full Customizer panel, a built-in SEO system, a WhatsApp quick-quote, and one-click demo import. Everything is editable without touching code.

2. Requirements

3. Installation

1. Appearance → Themes → Add New → Upload Theme.
2. Upload odysseo.zip and click Install, then Activate.
3. On activation the theme creates the core pages (Home, About, Fleets, Gallery, Contact, Blogs) and sets Home as the front page.

4. Demo Import (recommended)

The fastest way to match the showcased layout:

1. Install & activate the free One Click Demo Import plugin (Plugins → Add New).
2. Go to Appearance → Import Demo Data.
3. Click Import on “Odysseo — Full Demo” and wait for it to finish.

The import recreates all content (Destinations, Tour Packages, Fleet, Testimonials, Gallery, sample posts and pages), applies the Customizer settings, sets the front/blog pages and builds the Primary menu.

5. Front Page & Menus

• Front page: Settings → Reading → “A static page” → Home (set automatically on activation/import).
• Menus: Appearance → Menus → create a menu and assign it to the Primary Menu location. If none is set, a sensible default menu is shown.

6. Customizer (Appearance → Customize)

7. Content — Custom Post Types

Each type has its own admin menu with custom fields:

• Destinations — tagline, best time, duration, how-to-reach, attractions, things to do, gallery; “States” taxonomy.
• Tour Packages — duration, price, best season, group size, highlights, day-by-day itinerary, inclusions/exclusions, gallery.
• Fleet — type, seats, AC, luggage, price-per-day.
• Testimonials — designation/location, rating (1–5).
• Gallery — image + category.

8. WhatsApp Quick-Quote

The floating button + popup sends the buyer’s enquiry straight to your WhatsApp. The number comes from Customize → Contact Information → WhatsApp Number. The contact form emails the site admin address.

9. SEO & AI module (Settings → Odysseo SEO)

The theme is fully SEO-ready out of the box — meta tags, Open Graph/Twitter cards, and structured data are generated automatically with smart fallbacks, even if you never open an SEO field.

Per-post fields

Each post/page/CPT has an Odysseo SEO box: SEO Title, Meta Description, Focus Keywords, OG Title, OG Description. Leave them blank to use the automatic fallbacks.

Optional AI assistance

1. Go to Settings → Odysseo SEO, choose a provider (OpenAI or Google Gemini) and paste your own API key, or define ODYSSEO_SEO_API_KEY in wp-config.php.
2. Edit a post and click Generate with AI — it fills the fields for you to review and save.

Search Console

Paste your verification token in Settings → Odysseo SEO → Google Search Console verification.

10. XML Sitemap

A lightweight sitemap is available at /odysseo-sitemap.xml (Posts, Pages, Destinations, Tour Packages, Fleet) and is advertised in robots.txt. Submit that URL in Google Search Console.

11. Translation

The theme is translation-ready (text domain odysseo). The template is at languages/odysseo.pot — translate it with Poedit and drop the resulting odysseo-{locale}.mo file into languages/.

12. Performance

• All scripts, styles and fonts are self-hosted — no external CDN requests by default (GDPR-friendly).
• CSS/JS ship minified; source files are loaded automatically when SCRIPT_DEBUG is on.
• Rebuild minified assets after editing the sources:

  npx esbuild assets/css/main.css --minify --outfile=assets/css/main.min.css
  npx esbuild assets/js/main.js  --minify --outfile=assets/js/main.min.js

13. Credits & Licenses

The theme is licensed GPL v2 or later. Bundled third-party resources:

14. Support

For help, contact the author via the item page on your marketplace. When reporting an issue, include your WordPress and PHP versions and the steps to reproduce.

Odysseo v1.0.0 — Thank you for your purchase.