Skip to main content

A fully featured drop-in replacement of placehold.it for Django

Project description

A fully featured drop-in replacement of placehold.it for Django

https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/160.gif https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/custom-dimensions.gif https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/custom-text.gif
https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/custom-colors.gif https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/automatically.gif https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/formats.jpg
https://raw.githubusercontent.com/stevelacey/django-placeholdit/master/examples/scaled.gif

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


Download files

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

Files for django-placeholdit, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size django-placeholdit-1.0.2.tar.gz (4.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page