Context Navigation

Ticket #17568: 17568_2.diff

File 17568_2.diff, 1.8 KB (added by Zbigniew Siciarz, 12 years ago)
Link to reverse_lazy. Also changed the example to use regular patterns() instead of i18n_patterns(), as these are mentioned at the end of the note.

diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index d8260b0..71adff7 100644

                The URL where requests are redirected after login when the
 This is used by the :func:`~django.contrib.auth.decorators.login_required`
 decorator, for example.
+.. _`note on LOGIN_REDIRECT_URL setting`:
+.. note::
+    You can use :func:`~django.core.urlresolvers.reverse_lazy` to reference
+    URLs by their name instead of providing hardcoded value::
+        # urls.py
+        urlpatterns = patterns('',
+            url(_(r'^home/$'), 'test_app.views.home', name='home'),
+        )
+        # settings.py
+        LOGIN_REDIRECT_URL = reverse_lazy('home')
+    This also works fine with localized URLs using :func:`~django.conf.urls.i18n.i18n_patterns`.
 .. setting:: LOGIN_URL
 LOGIN_URL
-…
+               Default: ``'/accounts/login/'``
 The URL where requests are redirected for login, especially when using the
 :func:`~django.contrib.auth.decorators.login_required` decorator.
+.. note::
+    See the `note on LOGIN_REDIRECT_URL setting`_
 .. setting:: LOGOUT_URL
 LOGOUT_URL
-…
+               Default: ``'/accounts/logout/'``
 LOGIN_URL counterpart.
+.. note::
+    See the `note on LOGIN_REDIRECT_URL setting`_
 .. setting:: MANAGERS
 MANAGERS

diff --git a/docs/topics/http/urls.txt b/docs/topics/http/urls.txt
index 29ee851..fe90bbc 100644

                reverse_lazy()
 A lazily evaluated version of `reverse()`_.
+.. function:: reverse_lazy(viewname, [urlconf=None, args=None, kwargs=None, current_app=None])
 It is useful for when you need to use a URL reversal before your project's
 URLConf is loaded. Some common cases where this function is necessary are: