add new examples pages

mattmakai · mattmakai · commit 8454935d90a1 · 2019-08-02T08:26:50.000-04:00
diff --git a/content/pages/examples/django/django-code-examples.markdown b/content/pages/examples/django/django-code-examples.markdown
@@ -46,9 +46,10 @@ system built with [Django](/django.html). The code is open source under the
 
 dccnsys is shown on the following code example pages:
 
+* [django.contrib.auth get_user_model](/django-contrib-auth-get-user-model-examples.html)
+* [django.contrib.auth.decorators login_required](/django-contrib-auth-decorators-login-required-examples.html)
 * [django.urls.path](/django-urls-path-examples.html)
 
-
 ### django-allauth
 [django-allauth](https://github.com/pennersr/django-allauth) 
 ([project website](https://www.intenct.nl/projects/django-allauth/)) is a
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
@@ -0,0 +1,85 @@
+title: django.contrib.auth.decorators login_required Example Python Code
+category: page
+slug: django-contrib-auth-decorators-login-required-examples
+sortorder: 50025
+toc: False
+sidebartitle: django.contrib.auth.decorators login_required
+meta: Python code examples for the Django function login_required from the django.contrib.auth.decorators module.
+
+
+[Django](/django.html)'s
+[login_required](https://docs.djangoproject.com/en/dev/topics/auth/default/#the-login-required-decorator)
+function is used to secure views in your web applications by forcing
+the client to authenticate with a valid logged-in User. This decorator
+is a handy shortcut that can reduce the amount of code in your view
+functions and eliminate the need for every function to have
+boilerplate like `if not request.user.is_authenticated:`.
+
+
+## Example 1 from dccnsys
+[dccnsys](https://github.com/dccnconf/dccnsys) is a conference registration 
+web app built in [Django](/django.html). The code is open source under the
+[MIT license](https://github.com/dccnconf/dccnsys/blob/master/LICENSE).
+
+[**dccnsys / wwwdccn / registration / views.py**](https://github.com/dccnconf/dccnsys/blob/master/wwwdccn/registration/views.py)
+
+```python
+from django.contrib.auth import get_user_model
+~~from django.contrib.auth.decorators import login_required
+from django.shortcuts import render, redirect
+
+from users.models import generate_avatar
+from users.forms import (PersonalForm, ProfessionalForm, 
+                         SubscriptionsForm)
+
+User = get_user_model()
+
+
+~~@login_required
+def personal(request):
+    profile = request.user.profile
+    if request.method == 'POST':
+        form = PersonalForm(request.POST, instance=profile)
+        if form.is_valid():
+            form.save()
+            profile.avatar = generate_avatar(profile)
+            profile.save()
+            return redirect('register-professional')
+    else:
+        form = PersonalForm(instance=profile)
+    return render(request, 'registration/personal.html', {
+        'form': form
+    })
+
+
+~~@login_required
+def professional(request):
+    profile = request.user.profile
+    if request.method == 'POST':
+        form = ProfessionalForm(request.POST, instance=profile)
+        if form.is_valid():
+            form.save()
+            return redirect('register-subscriptions')
+    else:
+        form = ProfessionalForm(instance=profile)
+    return render(request, 'registration/professional.html', {
+        'form': form
+    })
+
+
+~~@login_required
+def subscriptions(request):
+    subscriptions = request.user.subscriptions
+    if request.method == 'POST':
+        form = SubscriptionsForm(request.POST, instance=subscriptions)
+        if form.is_valid():
+            form.save()
+            request.user.has_finished_registration = True
+            request.user.save()
+            return redirect('home')
+    else:
+        form = SubscriptionsForm(instance=subscriptions)
+    return render(request, 'registration/subscriptions.html', {
+        'form': form
+    })
+```
diff --git a/content/pages/examples/django/django-contrib-auth-get-user-model.markdown b/content/pages/examples/django/django-contrib-auth-get-user-model.markdown
@@ -0,0 +1,82 @@
+title: django.contrib.auth get_user_model Example Code
+category: page
+slug: django-contrib-auth-get-user-model-examples
+sortorder: 50024
+toc: False
+sidebartitle: django.contrib.auth get_user_model
+meta: Python code examples for the Django function get_user_model from the django.contrib.auth module.
+
+
+[Django](/django.html)'s
+[get_user_model](https://docs.djangoproject.com/en/dev/topics/auth/customizing/#django.contrib.auth.get_user_model)
+function is the appropriate way of referencing the 
+[Django User model](https://docs.djangoproject.com/en/dev/ref/contrib/auth/#django.contrib.auth.models.User)
+rather than a direct import of User.
+
+
+## Example 1 from dccnsys
+[dccnsys](https://github.com/dccnconf/dccnsys) is a conference registration 
+web app built in [Django](/django.html). The code is open source under the
+[MIT license](https://github.com/dccnconf/dccnsys/blob/master/LICENSE).
+
+[**dccnsys / wwwdccn / registration / views.py**](https://github.com/dccnconf/dccnsys/blob/master/wwwdccn/registration/views.py)
+
+```python
+## views.py
+~~from django.contrib.auth import get_user_model
+from django.contrib.auth.decorators import login_required
+from django.shortcuts import render, redirect
+
+from users.models import generate_avatar
+from users.forms import PersonalForm, ProfessionalForm, SubscriptionsForm
+
+~~User = get_user_model()
+
+
+@login_required
+def personal(request):
+    profile = request.user.profile
+    if request.method == 'POST':
+        form = PersonalForm(request.POST, instance=profile)
+        if form.is_valid():
+            form.save()
+            profile.avatar = generate_avatar(profile)
+            profile.save()
+            return redirect('register-professional')
+    else:
+        form = PersonalForm(instance=profile)
+    return render(request, 'registration/personal.html', {
+        'form': form
+    })
+
+@login_required
+def professional(request):
+    profile = request.user.profile
+    if request.method == 'POST':
+        form = ProfessionalForm(request.POST, instance=profile)
+        if form.is_valid():
+            form.save()
+            return redirect('register-subscriptions')
+    else:
+        form = ProfessionalForm(instance=profile)
+    return render(request, 'registration/professional.html', {
+        'form': form
+    })
+
+
+@login_required
+def subscriptions(request):
+    subscriptions = request.user.subscriptions
+    if request.method == 'POST':
+        form = SubscriptionsForm(request.POST, instance=subscriptions)
+        if form.is_valid():
+            form.save()
+            request.user.has_finished_registration = True
+            request.user.save()
+            return redirect('home')
+    else:
+        form = SubscriptionsForm(instance=subscriptions)
+    return render(request, 'registration/subscriptions.html', {
+        'form': form
+    })
+```
diff --git a/content/pages/meta/00-change-log.markdown b/content/pages/meta/00-change-log.markdown
@@ -15,6 +15,11 @@ on GitHub.
 
 
 ## 2019
+### August
+* Added new [Django](/django-code-examples.html) code examples pages:
+    * [django.contrib.auth get_user_model](/django-contrib-auth-get-user-model-examples.html)
+    * [django.contrib.auth.decorators login_required](/django-contrib-auth-decorators-login-required-examples.html)
+
 ### July
 * Pushed the [3000th commit](https://github.com/mattmakai/fullstackpython.com/commit/180051047a582b9154874b15dccb315600f23300)
   to Full Stack Python, a bit over 3 years after the
diff --git a/theme/templates/table-of-contents.html b/theme/templates/table-of-contents.html
@@ -234,6 +234,8 @@ <h3 style="margin-top:16px"><a href="/django-code-examples.html">Django code exa
 <h4 class="bp"><a href="/django-conf-settings-examples.html">django.conf.settings</a></h4>
 <h4 class="bp"><a href="/django-conf-urls-url-examples.html">django.conf.urls.url</a></h4>
 <h4 class="bp"><a href="/django-contrib-admin-examples.html">django.contrib.admin</a></h4>
+<h4 class="bp"><a href="/django-contrib-auth-get-user-model-examples.html">django.contrib.auth get_user_model</a></h4>
+<h4 class="bp"><a href="/django-contrib-auth-decorators-login-required-examples.html">django.contrib.auth.decorators login_required</a></h4>
 <h4 class="bp"><a href="/django-contrib-admin-filters-simplelistfilter-examples.html">django.contrib.admin.filters SimpleListFilter</a></h4>
 <h4 class="bp"><a href="/django-core-mail-send-mail-examples.html">django.core.mail.send_mail</a></h4>
 <h4 class="bp"><a href="/django-core-mail-messages-emailmessage-examples.html">django.core.mail.messages EmailMessage</a></h4>
