djblets.cache.context_processors¶

Context processors for serial numbers used for front-end caching.

These context processors can be used to inject the MEDIA_SERIAL and AJAX_SERIAL settings into templates so that links can be built that take these caching serials into account.

See djblets.cache.serials for more information on building these serials.

media_serial(request)¶

Add MEDIA_SERIAL to template contexts.

Exposes a media serial number that can be appended to a media filename in order to make a URL that can be cached forever without fear of change. The next time the file is updated and the server is restarted, a new path will be accessed and cached.

This returns the value of MEDIA_SERIAL, which must either be set manually or ideally should be set to the value of djblets.cache.serials.generate_media_serial().

ajax_serial(request)¶

Add AJAX_SERIAL to template contexts.

Exposes a serial number that can be appended to filenames involving dynamic loads of URLs in order to make a URL that can be cached forever without fear of change.

This returns the value of AJAX_SERIAL, which must either be set manually or ideally should be set to the value of djblets.cache.serials.generate_ajax_serial().