Skip to content
This storage backend stores files named after their hash value and adds a symlink with the original name. No duplication and you can SEO your heart out.
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
seo
.gitignore
LICENSE
README.rst
setup.py

README.rst

Just One of those things

Seo ville slugger will solve the problems you are having with django, media files and filenames.

Django's default storage backend has some pretty annoying behaviour. When uploading the same file for the second time, you get a second file on disk with some kind of crazy hash value added at the end.

There are 2 kinds of people that are not happy with that.

  1. The person that has to pay for disk space
  2. The SEO people your customer has hired.

This storage backend stores files named after their hash value and adds a symlink with the original name. No duplication and you can SEO your heart out.

Media file and pagespeed mobile score

Ideally, you would want to have long cache expiry headers for your site’s uploaded files, Just like you’ve got with your static files. That usually poses a problem in conjunction with the pretty urls. It is safe to put long expiry headers when using SEOStorage, because the files are distributed over folders named after a tiny piece of the hash. Obviously this small hash could lead to collisions, so the storage backend will prevent it as follows:

In the rare case we encounter two different files with exactly the same filename, and they end up in the same folder due to hash collision, the new file will not get the pretty SEO url. Instead the full hashed filename will be used instead. In these rare cases you might get a SEO unfriendly url.

We can’t worry about that can we? Phat phat chance anyone will notice!

Usage

You can use the storage backend on a global level by adding the following to your django settings:

DEFAULT_FILE_STORAGE = 'seo.ville.slugger.SEOStorage'

Sorl thumbnail

Suppose you want sorl thumbnail to also have nice urls based on the original filename?:

THUMBNAIL_BACKEND = 'seo.ville.sorl.SEOThumbnailBackend'
THUMBNAIL_STORAGE  = 'seo.ville.sorl.SEOThumbnailStorage'

With sorl you can pass the slug as a parameter to the thumbnail tag:

{% thumbnail image "330x450" upscale=True slug=slug as thumb %}

Settings

HASH_BLOCKSIZE change this if you think hashing of the file use too much or not enough memory HASH_DIRNAME_SLICE_SIZE change this if you find there are too many collisions.

You can’t perform that action at this time.