# 📚 Examples

This directory contains practical examples demonstrating how to use MCP Hub tools.

## 📂 Files

- **[basic_usage.py](basic_usage.py)** - Basic WordPress operations
- **[bulk_operations.py](bulk_operations.py)** - Batch processing and bulk updates
- **[woocommerce_shop.py](woocommerce_shop.py)** - E-commerce management examples
- **[content_migration.py](content_migration.py)** - Migrating content between sites
- **[.env.example](.env.example)** - Configuration template for examples

## 🚀 Quick Start

### 1. Setup Environment

```bash
# Copy environment template
cp examples/.env.example examples/.env

# Edit with your WordPress credentials
nano examples/.env
```

### 2. Run Examples

```bash
# Activate virtual environment
source venv/bin/activate  # Linux/Mac
.\venv\Scripts\Activate.ps1  # Windows

# Run an example
python examples/basic_usage.py
```

## 📖 Example Descriptions

### Basic Usage

Demonstrates fundamental operations:
- Listing posts
- Creating posts
- Updating posts
- Deleting posts
- Working with media
- Managing categories

**Use Case**: Learning the basics, quick operations

### Bulk Operations

Shows how to handle large-scale tasks:
- Bulk post creation
- Batch updates
- Mass deletion
- Progress tracking
- Error handling

**Use Case**: Content migrations, mass updates, cleanup

### WooCommerce Shop

E-commerce management examples:
- Product CRUD operations
- Inventory management
- Order processing
- Customer management
- Sales reports

**Use Case**: Online store management, inventory sync

### Content Migration

Cross-site content transfer:
- Migrating posts between sites
- Copying pages
- Media migration
- Taxonomy mapping
- URL rewriting

**Use Case**: Site consolidation, content backup, multi-site sync

## 🔧 Prerequisites

1. **Configured WordPress sites** in `.env`
2. **Valid credentials** (Application Passwords)
3. **WooCommerce** installed (for e-commerce examples)
4. **Sufficient permissions** on WordPress sites

## 💡 Tips

### Error Handling

All examples include comprehensive error handling:

```python
try:
    result = wordpress_create_post(...)
    print(f"Success: {result}")
except Exception as e:
    print(f"Error: {e}")
    # Log error, retry, or handle appropriately
```

### Rate Limiting

Examples respect rate limits:

```python
import time

for item in items:
    process(item)
    time.sleep(0.1)  # Avoid hitting rate limits
```

### Progress Tracking

For long-running operations:

```python
from tqdm import tqdm

for post in tqdm(posts, desc="Processing posts"):
    update_post(post)
```

## 🧪 Testing Examples

Before running on production:

1. **Test on staging site first**
2. **Backup your WordPress site**
3. **Start with small batches**
4. **Verify results manually**

## 📞 Support

If you encounter issues with examples:

- Check [Troubleshooting Guide](../docs/troubleshooting.md)
- Review [Getting Started](../docs/getting-started.md)
- Contact: hello@mcphub.dev

---