Skip to main 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.

Project description

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.

Project details


Download files

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

Source Distribution

seo-ville-slugger-0.0.5.tar.gz (4.3 kB view details)

Uploaded Source

File details

Details for the file seo-ville-slugger-0.0.5.tar.gz.

File metadata

  • Download URL: seo-ville-slugger-0.0.5.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/3.6

File hashes

Hashes for seo-ville-slugger-0.0.5.tar.gz
Algorithm Hash digest
SHA256 8fb75e7e47c99b8db04d8b66d73e723103d083a209f499c866db06cff4feac0d
MD5 c5c6e3e75dfc2a95e0fa16626bcd59f8
BLAKE2b-256 f149936574c7bce6987a2d934aba23b605b89453e2066fc7730eb7c3dff03db2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page