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
- Appearance → Themes → Add New → Upload Theme.
- Upload
odysseo.zipand click Install, then Activate. - 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:
- Install & activate the free One Click Demo Import plugin (Plugins → Add New).
- Go to Appearance → Import Demo Data.
- 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)
| 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.
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
- Go to Settings → Odysseo SEO, choose a provider (OpenAI or Google Gemini) and paste your own API key, or define
ODYSSEO_SEO_API_KEYinwp-config.php. - 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_DEBUGis 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.