add new login_required example

mattmakai · mattmakai · commit d5b5acedaced · 2019-08-02T08:50:45.000-04:00
diff --git a/content/pages/examples/django/django-code-examples.markdown b/content/pages/examples/django/django-code-examples.markdown
@@ -151,6 +151,7 @@ open source under the
 * [django.db.models CharField](/django-db-models-charfield-examples.html)
 * [django.db.models DateTimeField](/django-db-models-datetimefield-examples.html)
 
+
 ### django-oscar
 [django-oscar](https://github.com/django-oscar/django-oscar/) 
 ([project website](http://oscarcommerce.com/))
@@ -162,6 +163,7 @@ source under a
 Further code examples from django-oscar:
 
 * [django.contrib.admin](/django-contrib-admin-examples.html)
+* [django.contrib.auth.decorators login_required](/django-contrib-auth-decorators-login-required-examples.html)
 
 
 ### django-smithy
diff --git a/content/pages/examples/django/django-contrib-auth-decorators-login-required.markdown b/content/pages/examples/django/django-contrib-auth-decorators-login-required.markdown
@@ -21,6 +21,10 @@ boilerplate like `if not request.user.is_authenticated:`.
 web app built in [Django](/django.html). The code is open source under the
 [MIT license](https://github.com/dccnconf/dccnsys/blob/master/LICENSE).
 
+The dccnsys project provides a typical `login_required` decorator usage 
+example. The decorator is placed on a view function, in this case `personal`,
+to protect it from being accessible by unauthenticated users.
+
 [**dccnsys / wwwdccn / registration / views.py**](https://github.com/dccnconf/dccnsys/blob/master/wwwdccn/registration/views.py)
 
 ```python
@@ -83,3 +87,80 @@ def subscriptions(request):
         'form': form
     })
 ```
+
+## Example 2 from django-oscar
+[django-oscar](https://github.com/django-oscar/django-oscar/) 
+([project website](http://oscarcommerce.com/))
+is a framework for building e-commerce sites on top of 
+[Django](/django.html). The code for the project is available open 
+source under a 
+[custom license written by Tangent Communications PLC](https://github.com/django-oscar/django-oscar/blob/master/LICENSE).
+
+The following `login_required` example is one that surprised me
+a bit because I had not previously seen `login_required` applied
+on the parameter to the [url](/django-conf-urls-url-examples.html)
+function. Typically the decorator is used on view function where
+it is defined, but this way works as well as long as you are
+consistent about where you apply the decorator in your code base.
+
+[**django-oscar / src / oscar / apps / customer / apps.py**](https://github.com/django-oscar/django-oscar/blob/master/src/oscar/apps/customer/apps.py)
+
+```python
+from django.conf.urls import url
+~~from django.contrib.auth.decorators import login_required
+from django.utils.translation import gettext_lazy as _
+from django.views import generic
+
+from oscar.core.application import OscarConfig
+from oscar.core.loading import get_class
+
+
+class CustomerConfig(OscarConfig):
+    label = 'customer'
+    name = 'oscar.apps.customer'
+    verbose_name = _('Customer')
+
+    namespace = 'customer'
+
+    def ready(self):
+        from . import receivers  # noqa
+        from .alerts import receivers  # noqa
+
+        self.summary_view = get_class('customer.views', 
+                                      'AccountSummaryView')
+        self.order_history_view = get_class('customer.views', 
+                                            'OrderHistoryView')
+        self.order_detail_view = get_class('customer.views', 
+                                           'OrderDetailView')
+
+    ## ... abbreviating code not relevant to login_required ...
+
+
+    def get_urls(self):
+        urls = [
+            # Login, logout and register doesn't require login
+            url(r'^login/$', self.login_view.as_view(), 
+                name='login'),
+            url(r'^logout/$', self.logout_view.as_view(), 
+                name='logout'),
+            url(r'^register/$', self.register_view.as_view(), 
+                name='register'),
+~~            url(r'^$', login_required(self.summary_view.as_view()),
+~~                name='summary'),
+~~            url(r'^change-password/$',
+~~                login_required(self.change_password_view.as_view()),
+~~                name='change-password'),
+
+            # Profile
+~~            url(r'^profile/$',
+~~                login_required(self.profile_view.as_view()),
+~~                name='profile-view'),
+~~            url(r'^profile/edit/$',
+~~                login_required(self.profile_update_view.as_view()),
+~~                name='profile-update'),
+~~            url(r'^profile/delete/$',
+~~                login_required(self.profile_delete_view.as_view()),
+~~                name='profile-delete'),
+
+## the file continues with further examples that show the same usage
+```
