# 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](installation.md)
- ✅ **API keys configured** - See [Configuration](configuration.md)
- ✅ **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](../general/editor-options.md) 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](../general/blocks-overview.md)** - Learn about all available blocks
- **[Template Customization](../general/template-customization.md)** - Customize the appearance