Getting Started
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:
- Blocks Overview - Learn about all available blocks
- Template Customization - Customize the appearance