| Name | wagtail-image-from-url JSON |
| Version |
1.0.2
JSON |
| download |
| home_page | None |
| Summary | Add images to Wagtail via URL - A production-ready plugin for importing images from external URLs |
| upload_time | 2025-11-05 10:30:35 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
wagtail
django
cms
image
upload
url
import
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 🖼️ Wagtail Image From URL
[](https://pypi.org/project/wagtail-image-from-url/)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://www.djangoproject.com/)
[](https://wagtail.org/)
[](https://pypi.org/project/wagtail-image-from-url/)
A powerful and user-friendly Wagtail plugin that enables you to import images directly from URLs into your Wagtail image library without the need to manually download them first. Perfect for content editors who need to quickly add images from external sources.
---
## ✨ Features
### 🚀 Core Functionality
- **Bulk URL Import**: Add multiple images simultaneously by providing multiple URLs in a single form submission.
- **Direct Integration**: Seamlessly integrates into the Wagtail admin interface
- **Real-time Feedback**: Inline status indicators show success/failure for each URL
- **Beautiful UI**: Modern, responsive design with smooth animations and transitions
- **Smart Validation**: Client-side and server-side URL validation
- **File size limit**: Each imported image is limited to a maximum size of 10 MB (to avoid excessively large downloads and memory usage).
### 🎨 User Experience
- **Intuitive Interface**: Clean, modern UI that follows Wagtail design patterns
- **Batch Processing**: Submit multiple URLs with a single click
- **Dynamic Field Management**: Add or remove URL fields on the fly
- **Visual Feedback**: Success/error messages with icons
- **Responsive Design**: Works perfectly on desktop and mobile devices
- **No Page Reload**: AJAX-based submission for smooth user experience
---
## 📋 Requirements
- **Python**: 3.10 or higher
- **Django**: 4.2 or higher
- **Wagtail**: 5.0 or higher
- **Additional Dependencies**:
- `requests` - For HTTP operations
- `Pillow` - For image validation and processing
- **Max image size**: 10 MB per image (the plugin validates file sizes and will reject images larger than this limit)
---
## 📦 Installation
### Step 1: Install the Package
Install from PyPI:
```bash
pip install wagtail-image-from-url
```
Alternatively, install from GitHub:
```bash
pip install git+https://github.com/awais786/wagtail-image-from-url.git@main
```
### Step 2: Add to Installed Apps
Add `image_url_upload` to your Django `INSTALLED_APPS` in `settings.py`:
```python
INSTALLED_APPS = [
# ... other apps
'wagtail.images',
'wagtail.search',
'wagtail.admin',
'wagtail',
'image_url_upload', # ← Add this line
# ... other apps
]
```
That's it! The package is ready to use. Static files will be automatically discovered by Django's staticfiles system.
---
## 🎯 Usage
### Quick Start
1. **Navigate to Images**: Go to the Wagtail admin and click on "Images" in the sidebar
2. **Click "Add an Image from URL"**: You'll see a new button in the images index page header
3. **Enter Image URLs**:
- Enter one or more image URLs (you can add multiple URLs in the same form to perform a bulk import).
- Each image must be 10 MB or smaller — larger files will be rejected by the plugin.
- Click "Add Another URL" to add more fields
- Remove unwanted fields using the trash icon
4. **Fetch Images**: Click the "Fetch All Images" button to import all images at once
5. **View Results**: See real-time status updates next to each URL field
## 🧪 Testing
The project includes comprehensive tests. To run them:
```bash
# Install test dependencies separately
pip install pytest pytest-django
# Run tests
pytest
```
---
## 🛠️ Development Setup
```bash
# Clone the repository
git clone https://github.com/awais786/wagtail-image-from-url.git
cd wagtail-image-from-url
# Create a virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install package in editable mode
pip install -e .
# Install test/development tools (optional)
pip install pytest pytest-django black flake8
# Run tests
pytest
```
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 📞 Support
- **Issues**: [GitHub Issues](https://github.com/awais786/wagtail-image-from-url/issues)
- **Discussions**: [GitHub Discussions](https://github.com/awais786/wagtail-image-from-url/discussions)
- **Wagtail Slack**: Find us in the [#packages channel](https://wagtail.org/slack/)
## 📊 Changelog
### Version 1.0.1 (Current)
- ✨ Production-ready release
- ✅ Bulk URL import functionality
- ✅ Real-time status feedback
- ✅ Support for JPEG, PNG, GIF, BMP, and WEBP formats
- ✅ 10 MB file size limit
- ✅ Smart filename extraction with fallbacks
- ✅ Content-type validation
- ✅ Timeout protection (10 seconds)
- ✅ Comprehensive error handling
For detailed changelog, see [CHANGELOG.md](CHANGELOG.md)
---
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
---
<div align="center">
[⭐ Star on GitHub](https://github.com/awais786/wagtail-image-from-url) | [🐛 Report Bug](https://github.com/awais786/wagtail-image-from-url/issues) | [💡 Request Feature](https://github.com/awais786/wagtail-image-from-url/issues)
**Made with ❤️ for the Wagtail community**
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "wagtail-image-from-url",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "wagtail, django, cms, image, upload, url, import",
"author": null,
"author_email": "Awais Qureshi <awais.qureshi@arbisoft.com>",
"download_url": "https://files.pythonhosted.org/packages/94/49/6b8466c562fd0a7b9dc450fdf88e451f9b4cead9779f4ab4edd925b9db00/wagtail_image_from_url-1.0.2.tar.gz",
"platform": null,
"description": "# \ud83d\uddbc\ufe0f Wagtail Image From URL\n\n[](https://pypi.org/project/wagtail-image-from-url/)\n[](https://opensource.org/licenses/MIT)\n[](https://www.python.org/downloads/)\n[](https://www.djangoproject.com/)\n[](https://wagtail.org/)\n[](https://pypi.org/project/wagtail-image-from-url/)\n\nA powerful and user-friendly Wagtail plugin that enables you to import images directly from URLs into your Wagtail image library without the need to manually download them first. Perfect for content editors who need to quickly add images from external sources.\n\n---\n\n## \u2728 Features\n\n### \ud83d\ude80 Core Functionality\n- **Bulk URL Import**: Add multiple images simultaneously by providing multiple URLs in a single form submission.\n- **Direct Integration**: Seamlessly integrates into the Wagtail admin interface\n- **Real-time Feedback**: Inline status indicators show success/failure for each URL\n- **Beautiful UI**: Modern, responsive design with smooth animations and transitions\n- **Smart Validation**: Client-side and server-side URL validation\n- **File size limit**: Each imported image is limited to a maximum size of 10 MB (to avoid excessively large downloads and memory usage).\n\n\n### \ud83c\udfa8 User Experience\n- **Intuitive Interface**: Clean, modern UI that follows Wagtail design patterns\n- **Batch Processing**: Submit multiple URLs with a single click\n- **Dynamic Field Management**: Add or remove URL fields on the fly\n- **Visual Feedback**: Success/error messages with icons\n- **Responsive Design**: Works perfectly on desktop and mobile devices\n- **No Page Reload**: AJAX-based submission for smooth user experience\n\n---\n\n## \ud83d\udccb Requirements\n\n- **Python**: 3.10 or higher\n- **Django**: 4.2 or higher\n- **Wagtail**: 5.0 or higher\n- **Additional Dependencies**:\n - `requests` - For HTTP operations\n - `Pillow` - For image validation and processing\n- **Max image size**: 10 MB per image (the plugin validates file sizes and will reject images larger than this limit)\n\n---\n\n## \ud83d\udce6 Installation\n\n### Step 1: Install the Package\n\nInstall from PyPI:\n\n```bash\npip install wagtail-image-from-url\n```\n\nAlternatively, install from GitHub:\n\n```bash\npip install git+https://github.com/awais786/wagtail-image-from-url.git@main\n```\n\n### Step 2: Add to Installed Apps\n\nAdd `image_url_upload` to your Django `INSTALLED_APPS` in `settings.py`:\n\n```python\nINSTALLED_APPS = [\n # ... other apps\n 'wagtail.images',\n 'wagtail.search',\n 'wagtail.admin',\n 'wagtail',\n \n 'image_url_upload', # \u2190 Add this line\n \n # ... other apps\n]\n```\n\nThat's it! The package is ready to use. Static files will be automatically discovered by Django's staticfiles system.\n---\n\n## \ud83c\udfaf Usage\n\n### Quick Start\n\n1. **Navigate to Images**: Go to the Wagtail admin and click on \"Images\" in the sidebar\n\n2. **Click \"Add an Image from URL\"**: You'll see a new button in the images index page header\n\n \n\n3. **Enter Image URLs**: \n - Enter one or more image URLs (you can add multiple URLs in the same form to perform a bulk import).\n - Each image must be 10 MB or smaller \u2014 larger files will be rejected by the plugin.\n - Click \"Add Another URL\" to add more fields\n - Remove unwanted fields using the trash icon\n\n4. **Fetch Images**: Click the \"Fetch All Images\" button to import all images at once\n\n \n\n5. **View Results**: See real-time status updates next to each URL field\n\n\n## \ud83e\uddea Testing\n\nThe project includes comprehensive tests. To run them:\n\n```bash\n# Install test dependencies separately\npip install pytest pytest-django\n\n# Run tests\npytest\n```\n\n---\n\n## \ud83d\udee0\ufe0f Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/awais786/wagtail-image-from-url.git\ncd wagtail-image-from-url\n\n# Create a virtual environment\npython -m venv venv\nsource venv/bin/activate # On Windows: venv\\Scripts\\activate\n\n# Install package in editable mode\npip install -e .\n\n# Install test/development tools (optional)\npip install pytest pytest-django black flake8\n\n# Run tests\npytest\n```\n\n\n---\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n\n## \ud83d\udcde Support\n\n- **Issues**: [GitHub Issues](https://github.com/awais786/wagtail-image-from-url/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/awais786/wagtail-image-from-url/discussions)\n- **Wagtail Slack**: Find us in the [#packages channel](https://wagtail.org/slack/)\n\n\n## \ud83d\udcca Changelog\n\n### Version 1.0.1 (Current)\n- \u2728 Production-ready release\n- \u2705 Bulk URL import functionality\n- \u2705 Real-time status feedback\n- \u2705 Support for JPEG, PNG, GIF, BMP, and WEBP formats\n- \u2705 10 MB file size limit\n- \u2705 Smart filename extraction with fallbacks\n- \u2705 Content-type validation\n- \u2705 Timeout protection (10 seconds)\n- \u2705 Comprehensive error handling\n\nFor detailed changelog, see [CHANGELOG.md](CHANGELOG.md)\n\n---\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n---\n\n<div align=\"center\">\n\n[\u2b50 Star on GitHub](https://github.com/awais786/wagtail-image-from-url) | [\ud83d\udc1b Report Bug](https://github.com/awais786/wagtail-image-from-url/issues) | [\ud83d\udca1 Request Feature](https://github.com/awais786/wagtail-image-from-url/issues)\n\n**Made with \u2764\ufe0f for the Wagtail community**\n\n</div>\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Add images to Wagtail via URL - A production-ready plugin for importing images from external URLs",
"version": "1.0.2",
"project_urls": {
"Bug Tracker": "https://github.com/awais786/wagtail-image-from-url/issues",
"Documentation": "https://github.com/awais786/wagtail-image-from-url#readme",
"Homepage": "https://github.com/awais786/wagtail-image-from-url"
},
"split_keywords": [
"wagtail",
" django",
" cms",
" image",
" upload",
" url",
" import"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c6976177de12bee0fc8010b2e412cbdb789c372d31357924f30f65a3d1a9e92e",
"md5": "89c64b3b0212f370ceef8063f44b59f8",
"sha256": "24aedf3c60cb4d2bcedfdb22243f76a4d6ffca0a4a4764fff04c9d5dc61406a5"
},
"downloads": -1,
"filename": "wagtail_image_from_url-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "89c64b3b0212f370ceef8063f44b59f8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 14851,
"upload_time": "2025-11-05T10:30:34",
"upload_time_iso_8601": "2025-11-05T10:30:34.755394Z",
"url": "https://files.pythonhosted.org/packages/c6/97/6177de12bee0fc8010b2e412cbdb789c372d31357924f30f65a3d1a9e92e/wagtail_image_from_url-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "94496b8466c562fd0a7b9dc450fdf88e451f9b4cead9779f4ab4edd925b9db00",
"md5": "a27fcbb7665ddfc7cf8df30b5eb6831e",
"sha256": "86d19463ae7eef057daa99b165aadcb03ca8c51bb73d78173c9a418dd00e5a5d"
},
"downloads": -1,
"filename": "wagtail_image_from_url-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "a27fcbb7665ddfc7cf8df30b5eb6831e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 16510,
"upload_time": "2025-11-05T10:30:35",
"upload_time_iso_8601": "2025-11-05T10:30:35.906198Z",
"url": "https://files.pythonhosted.org/packages/94/49/6b8466c562fd0a7b9dc450fdf88e451f9b4cead9779f4ab4edd925b9db00/wagtail_image_from_url-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-05 10:30:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "awais786",
"github_project": "wagtail-image-from-url",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "wagtail-image-from-url"
}
