🏙️ Drop-in replacement of https://placehold.it for Django
MIT License
A fully featured drop-in replacement of placehold.it
_ for Django
+--------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+ | .. image:: https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/160.gif | .. image:: https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/custom-dimensions.gif | .. image:: https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/custom-text.gif | +--------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+ | .. image:: https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/custom-colors.gif | .. image:: https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/automatically.gif | .. image:: https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/formats.jpg | | +------------------------------------------------------------------------------------------------------------------+ | | | .. image:: https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/scaled.gif | | +--------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+
placehold.it
_ doesYou 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')),
)
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)
PLACEHOLDIT_FONT_PATH
# FONT_PATH that locates the font to be used. e.g. '/usr/share/fonts/opentype/noto/NotoSansCJK-Bold.ttc'. Defaults to None
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">
Feel free to fork django-placeholdit <https://github.com/stevelacey/django-placeholdit>
_
on GitHub! I'd love to see your pull requests.
.. _placehold.it: http://placehold.it