## 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

WordPress | 6.0 or higher
PHP | 7.4 or higher (8.0+ recommended)
Plugins | None required. Optional: One Click Demo Import (free) for the demo.

## 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.

Demo images: the demo references free hosted images, which are pulled in on import — nothing heavy is bundled in the theme. Replace them with your own media afterwards; buyers/end-users simply add their own content.

## 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)

Section | What it controls
--- | ---
Site Identity | Logo, site title, tagline, site icon (favicon)
Brand Colors | Primary/secondary/accent/dark/light — drives buttons, gradients, accents
Fonts | Self-hosted (default, no external calls) or Google Fonts; heading + body family
Currency | Code + symbol (used in SEO price data)
Contact Information | Owner, phone, email, WhatsApp, address, city/region/country, map embed, geo
Home / About / CTA / Footer | Headlines, subtext, stats, section copy, footer credit
Social Media | Facebook, Instagram, X, YouTube, LinkedIn URLs

## 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.

If an item has no featured image, the theme shows a neutral placeholder — add a featured image to each item for the best look.

## 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.

You supply your own API key; all AI usage is billed to you by the provider. AI is optional and only runs when you click Generate. This makes your site SEO-ready — it does not submit your site to Google or guarantee rankings.

### 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:

Resource | License
--- | ---
Swiper | MIT
AOS (Animate On Scroll) | MIT
Font Awesome (Free) | Icons CC BY 4.0, Fonts SIL OFL 1.1, Code MIT
Google Fonts (Cormorant Garamond, Outfit) | SIL Open Font License 1.1
Demo images | Free stock photos (referenced by URL, not bundled)

## 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.