Skip to main content

Templates. New in Django 1.4


Continuing those series of tasty features in Django 1.4. It's templates and newly added templatetags this time. Many things improved in template logic now. Lets move on point by point...

Tag {% elif %}

For most of us it is almost killer feature of new Django 1.4. You will have simpler logic in your templates, if you have advanced logic there, of course. ;)

Key-value arguments for user tags

You can use key-value for tags along with old, positional, arguments, e.g.:

{% custom_tag 123 "test" thing.var text=msg|upper username=user.get_full_name %}

All of this implemented using common "args" and "kwargs":

@register.simple_tag
def custom_tag(a, b, *args, **kwargs):
    warning = kwargs['text']
    profile = kwargs['username']
    ...
    return ...

assignment_tag

Some tags are not built to output something in template, like simple_tag. They only have to change something in context during rendering of templates. (Built-in {% with %} tag, for e.g.).
You can make it output time like so:

{% get_common_time "%Y-%m-%d %I:%M %p" as object_time %}
The time is {{ object_time }}.

SO now you can use "assignment_tag", to make creating tags like this simpler:


@register.assignment_tag
def get_common_time(time_format):
    return datetime.datetime.now().strftime(time_format)


Translation marks in context

Django 1.3 appeared to have functions pgettext() and ngettext() to indicate context for translatable strings. It solved problem of short text phrases partially. It suited phrases that can have different translation depending on context. Now you can transfer it in template directly:

{% trans "Iurii" context "username" %}
{% trans "Do" context "verb" %}
{% blocktrans with name=user.username context "hello message" %}Hi {{ name }}{% endblocktrans %}

New {% static %} tag

You can now share STATICFILES_STORAGE with special tag:

{% load static from staticfiles %}
<img src="{% static "app/css/base.css" %}" />

Most profit will get those one's that for e.g. use CDN on S3, or another not "standart" way. {{STATIC_URL}} is equivalent to {% static %} in other cases.

You also get new storage.CachedStaticFilesStorage, that can add md5-hash to filenames from static, to make cash for css, js, images and so on definitely invalid.

|truncatechars filter

Incredible but true. After 4,5 years of Django dev you received |truncatechars in default filers list. It can trim string to provided amount of characters and  change the end of it into three dots... Anyway |truncate_words is also available.

Almost all "IMHO tasty new features in 1.4 templates" covered. The farther the more will come. Stay tuned.

Comments

Popular posts from this blog

Pretty git Log

SO you dislike git log output in console like me and do not use it... Because it looks like so: How about this one? It's quite easy... Just type: git log - - graph - - pretty = format : '%Cred%h%Creset -%C ( yellow ) %d%Creset %s %Cgreen ( %cr) %C ( bold blue ) <%an>%Creset' - - abbrev - commit - - It may be hard to enter such an easy command every time. Let's make an alias instead... Copypaste this to your terminal: git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --" And use simple command to see this pretty log instead: git lg Now in case you want to see lines that changed use: git lg - p In order for this command to work remove  the -- from the end of the alias. May the code be with you! NOTE: this article is a rewritten copy of  http://coderwall.com/p/euwpig?i=3&p=1&t=git   and have b...

Django: Resetting Passwords (with internal tools)

I have had a task recently. It was about adding a forms/mechanism for resetting a password in our Django based project. We have had our own registration system ongoing... It's a corporate sector project. So you can not go and register yourself. Admins (probably via LDAP sync) will register your email/login in system. So you have to go there and only set yourself a password. For security reasons you can not register. One word. First I've tried to find standart decision. From reviewed by me were: django-registration and django password-reset . These are nice tools to install and give it a go. But I've needed a more complex decision. And the idea was that own bicycle is always better. So I've thought of django admin and that it has all the things you need to do this yourself in no time. (Actually it's django.contrib.auth part of django, but used out of the box in Admin UI) You can find views you need for this in there. they are: password_reset password_reset_...

Vagrant error: * Unknown configuration section 'hostmanager'.

Sometimes you get a vagrant environment or boilerplate with a Vagrantfile config in there and do a vagrant up command. And see some errors. like this: There are errors in the configuration of this machine . Please fix the following errors and try again : Vagrant: * Unknown configuration section 'hostmanager'. To fix this one needs: $ vagrant plugin install vagrant - hostmanager Installing the ' vagrant-hostmanager ' plugin . This can take a few minutes . . . Fetching : vagrant - hostmanager - 1.8 .6 . gem ( 100 % ) Installed the plugin ' vagrant-hostmanager (1.8.6) ' ! So command to fix this as follows: vagrant plugin install vagrant-hostmanager