Eliminated (Generic)ForeignKey evaluations in shipherd's NavigationManager.update_cac...

[philo.git] / philo / templatetags / nodes.py

diff --git a/philo/templatetags/nodes.py b/philo/templatetags/nodes.py
index 00d9764..52da236 100644 (file)
--- a/philo/templatetags/nodes.py
+++ b/philo/templatetags/nodes.py
@@ -1,3 +1,8 @@
+"""
+The node template tags are automatically included as builtins if :mod:`philo` is an installed app.
+
+"""
+
 from django import template
 from django.conf import settings
 from django.contrib.sites.models import Site
@@ -34,7 +39,7 @@ class NodeURLNode(template.Node):
                if self.with_obj is None and self.view_name is None:
                        url = node.get_absolute_url()
                else:
-                       if not node.view.accepts_subpath:
+                       if not node.accepts_subpath:
                                return settings.TEMPLATE_STRING_IF_INVALID
                        
                        if self.with_obj is not None:
@@ -65,13 +70,18 @@ class NodeURLNode(template.Node):
                        return url
 
 
-@register.tag(name='node_url')
-def do_node_url(parser, token):
+@register.tag
+def node_url(parser, token):
        """
-       {% node_url [for <node>] [as <var>] %}
-       {% node_url with <obj> [for <node>] [as <var>] %}
-       {% node_url <view_name> [<arg1> [<arg2> ...] ] [for <node>] [as <var>] %}
-       {% node_url <view_name> [<key1>=<value1> [<key2>=<value2> ...] ] [for <node>] [as <var>]%}
+       The :ttag:`node_url` tag allows access to :meth:`.View.reverse` from a template for a :class:`.Node`. By default, the :class:`.Node` that is used for the call is pulled from the context variable ``node``; however, this can be overridden with the ``[for <node>]`` option.
+       
+       Usage::
+       
+               {% node_url [for <node>] [as <var>] %}
+               {% node_url with <obj> [for <node>] [as <var>] %}
+               {% node_url <view_name> [<arg1> [<arg2> ...] ] [for <node>] [as <var>] %}
+               {% node_url <view_name> [<key1>=<value1> [<key2>=<value2> ...] ] [for <node>] [as <var>] %}
+       
        """
        params = token.split_contents()
        tag = params[0]