django-webp 1.0.1

django webp

django-webp
===========

Returns a webp image instead of jpg, gif or png to browsers which have support.

[](https://travis-ci.org/andrefarzat/django-webp)
[](https://coveralls.io/r/andrefarzat/django-webp)
[](https://requires.io/github/andrefarzat/django-webp/requirements/?branch=master)


## Usage

Load the `webp` module in your template and use the `webp` templatetag to point
to the image you want to convert.

```html
{% load webp %}

{# Use webp as you would use static templatetag #}
<img src="{% webp 'path/to/your/image.png' %}" alt="image" />
<!--
If the browser has support, generates:
<img src="/static/WEBP_CACHE/path/to/your/image.webp" alt="image" />

else, generates:
<img src="/static/path/to/your/image.webp" alt="image" />
-->
```


## Installation

First of all, you must install the webp support.
Please, check [the official guide](https://developers.google.com/speed/webp/docs/precompiled).

Then, install `django-webp`.

```sh
pip install django-webp
```

add it to `INSTALLED_APPS` configuration

```python
INSTALLED_APPS = (
'django.contrib.staticfiles',
'django_webp',
'...',
)
```

and to `TEMPLATE_CONTEXT_PROCESSORS` configuration

```python
TEMPLATE_CONTEXT_PROCESSORS = (
"django.core.context_processors.static",
"django_webp.context_processors.webp",
"..."
)