Opened 9 years ago

Closed 9 years ago

#4793 closed (fixed)

template documentation has wrong example

Reported by: Can Burak Cilingir <canburak@…> Owned by: nobody
Component: Documentation Version: master
Severity: Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

following code causes "module has no stringfilter" error

from django import template

@template.stringfilter
def lower(value):
    return value.lower()

you also need to register that filter (stringfilter is not registering it). correct example would be:

from django import template

@register.filter(name="endswith")
@template.defaultfilters.stringfilter
def endswith(value,arg):
    return value.endswith(arg)

Attachments (1)

4793.patch (2.0 KB) - added by Chris Beaven 9 years ago.

Download all attachments as: .zip

Change History (4)

comment:1 Changed 9 years ago by Chris Beaven

Triage Stage: UnreviewedAccepted

Example is here: http://www.djangoproject.com/documentation/templates_python/#template-filters-which-expect-strings

The example just shows the code which needs to be added for the specific case, not a full working example of a template.

...although perhaps the "registering a filter" bit could have a heading of it's own and it could go below "template filters which expect strings" to clarify things.

Changed 9 years ago by Chris Beaven

Attachment: 4793.patch added

comment:2 Changed 9 years ago by Chris Beaven

Has patch: set
Triage Stage: AcceptedReady for checkin

comment:3 Changed 9 years ago by Malcolm Tredinnick

Resolution: fixed
Status: newclosed

(In [6143]) Fixed #4793 -- Tweaked custom filter documentation a little to possibly reduce some confusion. Thanks, SmileyChris.

Note: See TracTickets for help on using tickets.
Back to Top