Skip to main content

A Django template tag library which allows to download external images, store them locally and return the local path to locally stored image to a desired context variable

Project description

A Django template tag library which allows to download external images, store them locally and return the local path to locally stored image to a desired context variable, along with width and height of the image fetched. Caches the fetched images locally for the given time (set in settings).

You could, for example, use this app to solve the problems with displaying of a mixed content (assets loaded from HTTP and HTTPS sources).

Prerequisites

  • Django 1.5.+
  • Python 2.6.8+, 2.7.+, 3.3.+

Installation

  1. Install eximagination

Latest stable version on PyPI:

$ pip install eximagination

Latest stable version from github:

$ pip install -e git+https://github.com/barseghyanartur/eximagination/@stable#egg=eximagination

Latest stable version from bitbucket:

$ pip install -e hg+http://bitbucket.org/barseghyanartur/eximagination@stable#egg=eximagination
  1. Add ‘eximagination’ to INSTALLED_APPS
>>> INSTALLED_APPS = (
>>>     # ...
>>>     'eximagination',
>>>     # ...
>>> )
  1. Configure

By default, eximagination expects your files to be stored in ‘/media/external_images’ directory. If location varies, redefine the directories in your Django settings, make sure the path is writable and that www-data (or whatever is applicable) has rights to write into it.

>>> # Example settings.py
>>> import os
>>> PROJECT_DIR = lambda s: os.path.abspath(os.path.join(os.path.dirname(__file__), s).replace('\\','/'))
>>> EXIMAGINATION_MEDIA_ROOT = PROJECT_DIR('media/external_images/')
>>> EXIMAGINATION_MEDIA_URL = '/media/external_images'
>>> EXIMAGINATION_MEDIA_RELATIVE_ROOT = 'external_images/'
>>> EXIMAGINATION_EXPIRATION_INTERVAL = 2592000 # After 30 days we re-fetch the file anyway.

Usage example (in a Django template)

See the example directory in https://bitbucket.org/barseghyanartur/eximagination/src for working code example.

{% load eximaginate %}

<img src=”{{ MEDIA_URL }}{% eximaginate ‘http://www.google.com/intl/en/images/logo.gif’ %}”>

or

{% load eximaginate thumbnail %}

{% eximaginate ‘http://www.google.com/intl/en/images/logo.gif’ as original %}

<img src=”{% thumbnail original 100x100 %}”>

In both cases there are two additional context variables added:

ei_width - Width of the image

ei_height - Height of the image

License

GPL 2.0/LGPL 2.1

Support

For any issues contact me at the e-mail given in the Author section or open an issue on bitbucket/github.

Author

Artur Barseghyan <artur.barseghyan@gmail.com>

Project details


Release history Release notifications

This version
History Node

0.7

History Node

0.6

History Node

0.5

History Node

0.4

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
eximagination-0.7.tar.gz (6.2 kB) Copy SHA256 hash SHA256 Source None Oct 7, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page