Home Getting Started Getting Started

Getting Started

Last updated on Sep 16, 2025

Getting Started

Create your first page with Tourismo content using the Itinerator plugin.

Prerequisites

Before you begin, make sure you have:

  • ✅ Plugin installed and activated - See Installation
  • ✅ API keys configured - See Configuration
  • ✅ Content in your Tourismo admin - Add some itineraries, listings, or events

Quick Start: Template Pages First

Before creating collection pages, you need to set up template pages for each content type you want to display.

Step 1: Create Template Pages

You need a template page for each content type that will have individual detail pages:

Essential Templates (Most Common):

  • Single Region - Template for individual region pages
  • Single Itinerary - Template for individual itinerary pages
  • Single Listing - Template for individual business/listing pages
  • Single Event - Template for individual event pages

Additional Templates (As Needed):

  • Single Challenge - Template for individual challenge pages
  • Single Content - Template for custom content types

Step 2: Set Page Type

For each template page:

  1. Create a new page (Pages → Add New)
  2. Set the Itinerator Page Type in the page settings panel:
    • Block Editor: Look for "Itinerator Page Type" in the right sidebar
    • Classic Editor: Look for "Itinerator Page Type" meta box
  3. Choose the appropriate type (Region, Itinerary, Listing, Event, etc.)

Step 3: Add Content Blocks

Each template page uses Itinerator Content blocks to define the layout:

Common Content Blocks:

  • Title - Display the item's title
  • Description - Show the item's description
  • Content - Display main content
  • Info - Look for listing/event info block (name, contact, hours, etc.)

Example Template Structure:

Single Itinerary Template:
├── Title Block
├── Description Block
└── Itinerary Block

Creating Collection Pages

Once your template pages are set up, you can create pages that display collections of content or drop a collection block onto an existing page.

Step 1: Create a Collection Page

  1. Go to Pages → Add New
  2. Give your page a title (e.g., "All Tourismo Content")
  3. Add collection blocks like:
    • Itineraries - Show all itineraries
    • Listings - Display business listings
    • Events - Show upcoming events
    • Regions - List all regions

Step 2: Configure Collection Blocks

  1. Select your collection block to open settings
  2. Configure display options (columns, items to show or hide, etc.)
  3. The collection will automatically use your template pages for individual items, or if you have multiple template pages, it will allow you to select the proper template.

Step 3: Publish and Test

  1. Click Publish to make your page live
  2. View the page to see how it looks
  3. Test on mobile to ensure responsiveness

Implementation Examples

Example 1: Itinerary Website

Step 1: Create Template Pages

  1. Single Itinerary Template - Set Page Type to "Single Itinerary"

    • Add Title, Description, Itinerary blocks

  2. Single Region Template - Set Page Type to "Single Region"

    • Add Title, Description, Content blocks, Map Block

Step 2: Create Collection Pages

  1. "All Itineraries" Page
    • Add Itineraries collection block
    • Configure: 3 columns, show images, descriptions
  2. "Regions" Page
    • Add Regions collection block
    • Configure: Grid layout, show region overviews

Example 2: Business Directory

Step 1: Create Template Pages

  1. Single Listing Template - Set Page Type to "Listing"
    • Add Listing Info blocks
  2. Single Event Template - Set Page Type to "Event"
    • Add Event Info block (for event details)

Step 2: Create Collection Pages

  1. "Local Businesses" Page
    • Add Listings collection block
    • Add Filter block for categories or search
  2. "Events" Page
    • Add Events collection block
    • Configure: Show date filter, locations, descriptions

Example 3: Tourism Website

Step 1: Create Template Pages

  1. Single Itinerary Template - Set Page Type to "Itinerary"
  2. Single Listing Template - Set Page Type to "Listing"
  3. Single Event Template - Set Page Type to "Event"
  4. Single Region Template - Set Page Type to "Region"

Step 2: Create Collection Pages

  1. "Plan Your Trip" Page
    • Add Itineraries collection block
    • Add Regions collection block
  2. "Local Attractions" Page
    • Add Listings collection block
    • Add Filter block
  3. "Events Calendar" Page
    • Add Events collection block

Using Page Builders

If you're using Elementor, Divi, or another page builder, see the Editor Options guide for detailed shortcode usage and integration methods.

Best Practices

  • Start simple - Use 2-3 blocks maximum
  • Test on mobile - Ensure responsive design
  • Clear hierarchy - Use titles to organize content
  • Logical flow - Arrange blocks in a sensible order

Troubleshooting

No content displaying:

  • Check if you have content in your Tourismo admin
  • Verify API keys are working
  • Clear any caching plugins

Template pages not working:

  • Ensure you've set the "Itinerator Page Type" on template pages
  • Check that template pages are published
  • Verify you're using the correct page type for your content

Collection blocks not linking to templates:

  • Make sure template pages exist for each content type
  • Verify template pages have the correct "Itinerator Page Type" set

Next Steps

Once you've created your first page: