Changes between Version 42 and Version 43 of BackwardsIncompatibleChanges

Timestamp:

Nov 26, 2005, 5:21:39 PM (19 years ago)

Author:

Adrian Holovaty

Comment:

--

BackwardsIncompatibleChanges

@@ -369 +369 @@
 == Changed the way custom template tags and filters are registered ==
 
-As of [], we changed the way custom template tags and filters are registered. If you've written custom template tags or filters, you'll need to make a small change to the way they're registered.
-
-Old way:
-{{{
-from django.core import template
-
+As of [], we changed the way custom template tags and filters are registered. If you've written custom template tags or filters, you'll need to make a couple of changes:
+
+=== Filter arguments ===
+
+For any filters that don't take an argument, remove the second argument to the filter function.
+
+Old:
+{{{
 def lower(param, _):
     return param.lower()
+}}}
+
+New:
+{{{
+def lower(param):
+    return param.lower()
+}}}
+
+The system now introspects the function's arguments to find out whether a filter argument is required.
+
+=== Change the way your tags/filters are registered ===
+
+Old way:
+{{{
+from django.core import template
 
 template.register_filter('lower', lower, False)
@@ -386 +403 @@
 {{{
 from django.core import template
-
-def lower(param): # If a filter takes no arguments, leave off the argument.
-    return param.lower()
 
 register = template.Library()
@@ -395 +409 @@
 }}}
 
-A new decorator syntax is also supported.
+=== Change template decorator calls ===
+
+If you're using the undocumented template decorators (simple_tag and inclusion_tag), change your calls to be members of the library class.
+
+[INSERT EXAMPLE HERE]
 
 See [http://www.djangoproject.com/documentation/templates_python/#writing-custom-template-filters Writing custom template filters] and [http://www.djangoproject.com/documentation/templates_python/#writing-custom-template-tags Writing custom template tags] for full documentation.