# Installation Guide

This guide will walk you through installing and activating the Itinerator WordPress plugin.

## Prerequisites

Before installing the plugin, ensure you have:

- **WordPress 5.0+** (for Gutenberg block editor support)
- **PHP 7.4+**
- **Administrator access** to your WordPress site
- **Tourismo account** with API access (you'll configure API keys after installation)

## Installation Methods

### Method 1: Upload Plugin File (Recommended)

1. **Download the plugin**
   - Get the latest version from https://tourismo.co/wordpress-plugin
   - The file will be named `itinerator-wp-plugin.zip`

2. **Upload to WordPress**
   - Go to **WordPress Admin → Plugins → Add New**
   - Click **Upload Plugin**
   - Choose the `itinerator-wp-plugin.zip` file
   - Click **Install Now**

3. **Activate the plugin**
   - After installation, click **Activate Plugin**
   - You'll see a success message when activated

### Method 2: Manual Installation

1. **Extract the plugin**
   - Unzip the `itinerator-wp-plugin.zip` file
   - Upload the `itinerator-wp-plugin` folder to `/wp-content/plugins/`

2. **Activate via WordPress Admin**
   - Go to **WordPress Admin → Plugins**
   - Find "Itinerator" in the list
   - Click **Activate**

## Post-Installation Steps

After activation, you'll need to:

1. **Configure API keys** - See [Configuration](configuration.md)
2. **Create your first page** - See [Getting Started](getting-started.md)

## Verification

To verify the plugin is working correctly:

1. **Check the admin menu**
   - You should see "Itinerator" in your WordPress admin menu
   - Go to **Itinerator → Settings** to access configuration

2. **Check for blocks**
   - Edit any page with the block editor
   - Search for "Itinerator" in the block inserter
   - You should see Itinerator block categories

## Troubleshooting Installation

### Common Issues

**Plugin won't activate:**
- Check WordPress version (requires 5.0+)
- Check PHP version (requires 7.4+)
- Verify file permissions on the plugin directory

**Blocks don't appear:**
- Ensure you're using the Gutenberg block editor
- Check if the plugin is properly activated
- Clear any caching plugins

**Admin menu missing:**
- Check if you have administrator privileges
- Verify the plugin is activated

## Next Steps

Once installation is complete, proceed to:

- **[Configuration](configuration.md)** - Set up your API keys
- **[Getting Started](getting-started.md)** - Create your first page