A fully featured drop-in replacement of placehold.it for Django
Project description
A fully featured drop-in replacement of placehold.it for Django
Features
Everything placehold.it does
Identical URL structure
Improved font rendition and vertical text alignment
Installation
You can pip install the app from PyPi (recommended):
$ pip install django-placeholdit
or GitHub:
$ pip install git+git://github.com/stevelacey/django-placeholdit.git#egg=DjangoPlaceholdit
Add django_placeholdit to your INSTALLED_APPS in settings.py:
INSTALLED_APPS = ( # ... 'django_placeholdit', )
Add the routes into your urls.py, feel free to customise the prefix or namespace, no trailing slash:
urlpatterns = patterns( # ... url(r'^placeholders', include('django_placeholdit.urls', namespace='placeholdit')), )
Configuration
The following options can be configured in your settings.py:
PLACEHOLDIT_CACHE_SECONDS # Number of seconds to cache placeholders. Defaults to 86400 * 7 (a week)
Usage
In templates:
<img src="{% url 'placeholdit:placeholder' width=160 %}"> <img src="{% url 'placeholdit:placeholder' width=240 height=160 text='Custom dimensions' %}"> <img src="{% url 'placeholdit:placeholder' width=160 text='Custom text!' %}"> <img src="{% url 'placeholdit:placeholder' width=160 background='F77A00' color='fff' text='Custom colors!' %}"> <img src="{% url 'placeholdit:placeholder' width=240 height=80 background='fbd206' color='fff' text='Automatically' %}"> <img src="{% url 'placeholdit:placeholder' width=240 height=80 background='fbd206' color='fff' text='scaled!' %}"> <img src="{% url 'placeholdit:placeholder' width=160 background='93C663' color='3F740E' text='gif/jpeg/png' format='jpg' %}">
Resulting in:
<img src="http://example.com/placeholders/160"> <img src="http://example.com/placeholders/240x160&text=Custom%20dimensions"> <img src="http://example.com/placeholders/160&text=Custom%20text%21"> <img src="http://example.com/placeholders/160/F77A00/fff&text=Custom%20colors%21"> <img src="http://example.com/placeholders/240x80/fbd206/fff&text=Automatically"> <img src="http://example.com/placeholders/240x80/fbd206/fff&text=scaled%21"> <img src="http://example.com/placeholders/160.jpg/93C663/3F740E&text=gif/jpeg/png">
Contributing
Feel free to fork django-placeholdit on GitHub! I’d love to see your pull requests.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.