Wagtail WordPress Image Importer

A Django management command to import images from a WordPress XML export into Wagtail.

Installation

pip install wagtail-wordpress-image-importer

Configuration

Add to your INSTALLED_APPS in Django settings:

INSTALLED_APPS = [
    ...
    'wagtail_wordpress_image_importer',
    ...
]

Usage

Export your WordPress content as XML from WordPress admin (Tools > Export).

Then run:

python manage.py import_wordpress_images /path/to/your/wordpress-export.xml

Options

• --debug: Show detailed debug information during import
• --collection: Import images into specified collection
• --delete-existing: Delete all existing Wagtail images before importing (for specified collection, if provided)

License

MIT License

Development

Local development

# Clone the repository
git clone git@github.com:tomdyson/wagtail-wordpress-image-importer.git
cd wagtail-wordpress-image-importer

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows

# Install dependencies
pip install -e .

Releasing a new version

1. Update the version number in pyproject.toml
2. Commit your changes
3. Create and push a new tag:

   git tag v0.1.1
   git push origin v0.1.1
   

4. Create a new release on GitHub using this tag
5. The GitHub Action will automatically build and publish to PyPI