Metadata-Version: 1.1
Name: django-images-placeholder
Version: 0.0.2
Summary: Automatic generates images with the right dimensions whenit's missing from the local media storage based on a commondatabase or remote MEDIA_URL.
Home-page: https://bitbucket.org/3mwdigital/django-images-placeholder
Author: Joao Vitor Gomes [at] The Goodfellas
Author-email: joao.gomes@thegoodfellas.com.br
License: BSD 2
Description-Content-Type: UNKNOWN
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/'`
        
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: Framework :: Django :: 1.11
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
