Automatic generates images with the right dimensions whenit's missing from the local media storage based on a commondatabase or remote MEDIA_URL.
Project description
Django Images Placeholder
=========================
Automatic generates images with the right dimensions when
it's missing from the local media storage using metadata of
a common database to generate a image or fetching from an
alternative MEDIA_URL.
Installation
------------
1. Install the package with:
`pip install django-images-placeholder`
2. Uninstall the package with:
`pip uninstall django-images-placeholder`
3. Add "django_images_placeholder" to your INSTALLED_APPS setting like this::
```
INSTALLED_APPS = [
...
'django_images_placeholder',
]
```
4. Add and URL to your URLCONF:
```
...
# This is NOT meant to be used in production environment.
if settings.DEBUG:
from django_images_placeholder.views import serve_image_placeholder
urlpatterns = [
url(r'^media/', serve_image_placeholder, name='images_placeholder'),
] + urlpatterns
```
5. On `settings.py`, set `MEDIA_URL` to point to it
```
...
STATIC_URL = '/static/'
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(DATA_DIR, 'media')
STATIC_ROOT = os.path.join(DATA_DIR, 'static')
DEFAULT_FILE_STORAGE = 'django_images_placeholder.custom_storage.OverwritingStorage'
STATICFILES_LOCATION = STATIC_URL
MEDIAFILES_LOCATION = MEDIA_URL
```
6. Optionally, set `ALTERNATIVE_MEDIA_URL` to point to a production MEDIA_URL,
so with the view fail to provide an image by openning it locally or trying
to generating it by original image reference' metadata, it you ultimatelly
try to fetch `ALTERNATIVE_MEDIA_URL` and cache it:
`ALTERNATIVE_MEDIA_URL = 'https://mybucket.s3.amazonaws.com/media/'`
=========================
Automatic generates images with the right dimensions when
it's missing from the local media storage using metadata of
a common database to generate a image or fetching from an
alternative MEDIA_URL.
Installation
------------
1. Install the package with:
`pip install django-images-placeholder`
2. Uninstall the package with:
`pip uninstall django-images-placeholder`
3. Add "django_images_placeholder" to your INSTALLED_APPS setting like this::
```
INSTALLED_APPS = [
...
'django_images_placeholder',
]
```
4. Add and URL to your URLCONF:
```
...
# This is NOT meant to be used in production environment.
if settings.DEBUG:
from django_images_placeholder.views import serve_image_placeholder
urlpatterns = [
url(r'^media/', serve_image_placeholder, name='images_placeholder'),
] + urlpatterns
```
5. On `settings.py`, set `MEDIA_URL` to point to it
```
...
STATIC_URL = '/static/'
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(DATA_DIR, 'media')
STATIC_ROOT = os.path.join(DATA_DIR, 'static')
DEFAULT_FILE_STORAGE = 'django_images_placeholder.custom_storage.OverwritingStorage'
STATICFILES_LOCATION = STATIC_URL
MEDIAFILES_LOCATION = MEDIA_URL
```
6. Optionally, set `ALTERNATIVE_MEDIA_URL` to point to a production MEDIA_URL,
so with the view fail to provide an image by openning it locally or trying
to generating it by original image reference' metadata, it you ultimatelly
try to fetch `ALTERNATIVE_MEDIA_URL` and cache it:
`ALTERNATIVE_MEDIA_URL = 'https://mybucket.s3.amazonaws.com/media/'`
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for django-images-placeholder-0.0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a882384bb2f471b5244cd4323d5f86838ef45a2be24092cb9bec07398a2678fc |
|
MD5 | 09bc1752c77f3bb05334260e807b9545 |
|
BLAKE2b-256 | fe5e299b0e3729a7ee36c7c9946d7b4139f3e1c161341d0df65a48e076f779dc |