{% media %}

Незабвенный герой Анатолия Папанова говаривал, что ежели человек идиот, то это надолго. Мне сейчас кажется, что я как раз в такой ситуации :-). Это я о том, как в джанговских шаблонах делать ссылки на JS, CSS и прочую media.

Я всегда пропагандировал простой способ: прокидывать в шаблоны переменную MEDIA_URL, используя стандартный контекст-процессор media. А в шаблоне просто составлять слова рядом:

<link rel="stylesheet" href="{{ MEDIA_URL }}css/style.css">

Это типа работает, но у такого способа есть пара минусов:

• Нужно всегда использовать RequestContext для шаблонов. Что, впрочем, в принципе хорошая идея, поэтому минус этот условный.
• Вот что реально плохо, это что эту переменную приходится вручную прокидывать в любой inclusion-тег, в котором понадобилась media. Это особенно неприятно, потому что периодически мешает параллельности работы верстальщика и программиста.

И тут вдруг у меня сошлись в голове какие-то правильные мысли с разных сторон, и я написал себе удобный тег для формирования ссылок на media-файлы в шаблонах с парой полезных дополнений.

• В простейшем случае он просто присоединяет имя файла к MEDIA_URL:

  {% media "images/edit.png" %}
  

  Однако если параметр начинатся со слеша или с протокола ("http://"), то он уже не будет присоединяться к MEDIA_URL.

• Можно добавить флажок, чтобы ссылка всегда была абсолютной:

  <!-- /media/edit.png становится http://example.com/media/edit.png -->
  {% media "images/edit.png" "absolute" %}
  

• Можно добавить к файлу timestamp по времени обновления, что очень полезно для css- и js-файлов, чтобы при изменении их на сервере, браузер автоматически получали новую версию без необходимости заставлять юзеров вручную рефрешить страницу. Больше того, для css- и js-файлов это включено автоматически. Поведение это явно можно включать и выключать флажками "timestamp" и "no-timestamp"

  {% media "css/style.css" %}                <!-- ...style.css?123456789 -->
  {% media "css/style.css" "no-timestamp" %} <!-- ...style.css -->
  {% media "images/edit.png" "timestamp" %}  <!-- ...edit.png?123456789 -->
  

Флажки "timestamp", "no-timestamp" и "absolute" можно использовать одноврменно (через запятую).

Выкладывать отдельным проектом я его не хочу, потому что уж очень маленький. Вместо этого я хочу собрать мнения по поводу полезности самого подхода и может быть предложить включить его в Django. А пока вот его небольшой код:

def _absolute_url(url):
    if url.startswith('http://') or url.startswith('https://'):
        return url
    domain = Site.objects.get_current().domain
    return 'http://%s%s' % (domain, url)

@register.simple_tag
def media(filename, flags=''):
    flags = set(f.strip() for f in flags.split(','))
    url = urlparse.urljoin(settings.MEDIA_URL, filename)
    if 'absolute' in flags:
        url = _absolute_url(url)
    if (filename.endswith('.css') or filename.endswith('.js')) and 'no-timestamp' not in flags or \
       'timestamp' in flags:
        fullname = os.path.join(settings.MEDIA_ROOT, filename)
        if os.path.exists(fullname):
            url += '?%d' % os.path.getmtime(fullname)
    return url