Home Getting Started Configuration

Configuration

Last updated on Sep 16, 2025

Configuration Guide

Configure your API keys and settings to connect the Itinerator plugin to the Tourismo platform.

Accessing Settings

  1. Go to Itinerator Settings

    • In your WordPress admin, click Itinerator → Settings
    • Or navigate to Settings → Itinerator

  2. Settings Overview

    • The settings page contains all configuration options
    • Settings are organized into logical sections
    • Changes are saved automatically

Required API Keys

Platform API Key

What it's for: Connects to the main Tourismo platform to display content like itineraries, listings, events, and challenges.

How to get it:

  1. Log into your Tourismo admin account
  2. Go to Settings → API Keys
  3. Copy your Platform API key
  4. Paste it into the WordPress plugin settings

Verification:

  • The plugin will test the key automatically

DMO Partner API Key (Optional)

What it's for: Displays itineraries that are related to a specific Destination Marketing Organization (DMO).

How to get it:

  1. Contact your DMO partner representative
  2. Request your DMO Partner API key
  3. Add it to the plugin settings

When to use:

  • Only needed if you're displaying DMO-itineraries
  • Most users only need the Platform API key

Google Maps API Key (Optional)

What it's for: Enables interactive maps in itinerary and map blocks.

How to get it:

  1. Go to Google Cloud Console
  2. Create a new project or select existing
  3. Enable the Maps JavaScript API
  4. Create credentials (API key)
  5. Add it to the plugin settings

Important: Restrict the API key to your domain for security.

Optional Settings

Google Maps Map ID

What it's for: Customizes the appearance of Google Maps with your own styling.

How to get it:

  1. In Google Cloud Console, go to Maps → Map Management
  2. Create a new Map ID
  3. Apply custom styling if desired
  4. Copy the Map ID to the plugin settings

Page Whitelist

What it's for: Limits plugin scripts to specific pages for performance.

How to use:

  • Enter page IDs separated by commas
  • Leave empty to load on all pages
  • Useful for large sites with many pages

Cache Settings

What it's for: Controls whether the api caching feature is active or not

reCAPTCHA Protection

What it's for: Adds Google reCAPTCHA protection to forms to prevent spam submissions and bot attacks.

How to configure:

  1. Go to Google reCAPTCHA Console
  2. Create a new site with reCAPTCHA v2 (checkbox)
  3. Copy your Site Key and Secret Key
  4. Add them to the plugin settings

Settings:

  • reCAPTCHA Site Key: Your public site key from Google reCAPTCHA console
  • reCAPTCHA Secret Key: Your private secret key (keep this secure)

Features:

  • Automatically loads reCAPTCHA script when configured
  • Can be enabled/disabled per form block
  • Validates submissions server-side with Google
  • Preserves form data if validation fails

Note: reCAPTCHA is only loaded when both keys are configured and enabled on a form.

Powered by Tourismo Footer

What it's for: Controls the display of a "Powered by Tourismo" footer attribution on your site.

Options:

  • Disabled (No Footer): No footer is displayed automatically (default)
  • Dark Theme: Displays a dark footer with white text
  • Light Theme: Displays a light footer with dark text

Shortcode Usage: When disabled, you can use the shortcode to place a simple "Powered by Tourismo" link anywhere on your site:

  • [tourismo-powered-by color="auto"] - Inherits text color from parent element, no logo background (default)
  • [tourismo-powered-by color="dark"] - Dark text color with white logo background
  • [tourismo-powered-by color="light"] - Light text color with white logo background
  • [tourismo-powered-by color="#ff0000"] - Custom hex color with white logo background

Examples:

  • Add to a page: [tourismo-powered-by color="auto"]
  • Place in a widget: [tourismo-powered-by color="dark"]
  • Custom color: [tourismo-powered-by color="#0066cc"]
  • Embed anywhere: <p>[tourismo-powered-by]. Bringing enchanting experiences and results to life</p>

Note: The shortcode outputs a simple text link with a small logo. When using custom colors, the logo gets a white background with rounded corners for better visibility. The logo size automatically scales with your text (2em height).

Testing Your Configuration

  1. Create a test page with the block editor
  2. Add an Itinerator block (any collection block)
  3. Check if content loads without error messages

Common Configuration Issues

Platform API Key Invalid:

  • Check for extra spaces or characters
  • Verify the key is copied completely
  • Ensure your Tourismo account is active

Google Maps Not Working:

  • Verify the API key is correct
  • Check if Maps JavaScript API is enabled
  • Ensure billing is set up in Google Cloud Console
  • Check domain restrictions on the API key

No Content Displaying:

  • Verify API keys are valid
  • Check if content exists in your Tourismo admin
  • Clear any caching plugins

Security Best Practices

  1. Keep API keys private - Don't share them publicly
  2. Use domain restrictions - Limit Google Maps API key to your domain

Next Steps

Once configuration is complete: