add new admin examples

mattmakai · mattmakai · commit e63bcb9a9af7 · 2019-06-22T10:58:28.000-04:00
diff --git a/content/pages/examples/django/django-contrib-admin.markdown b/content/pages/examples/django/django-contrib-admin.markdown
@@ -22,7 +22,7 @@ is a framework for building e-commerce sites on top of
 source under a 
 [custom license written by Tangent Communications PLC](https://github.com/django-oscar/django-oscar/blob/master/LICENSE).
 
-[**django-oscar/src/oscar/apps/address/admin.py**](https://github.com/django-oscar/django-oscar/blob/master/src/oscar/apps/address/admin.py)
+[**django-oscar / src / oscar / apps / address / admin.py**](https://github.com/django-oscar/django-oscar/blob/master/src/oscar/apps/address/admin.py)
 
 ```python
 # admin.py
@@ -64,7 +64,7 @@ backend that displays
 code is open source under the 
 [MIT license](https://github.com/Michael-Cantley/heritagesites/blob/master/LICENSE).
 
-[**heritagesites/heritagesites/admin.py**](https://github.com/Michael-Cantley/heritagesites/blob/master/heritagesites/admin.py)
+[**heritagesites / heritagesites / admin.py**](https://github.com/Michael-Cantley/heritagesites/blob/master/heritagesites/admin.py)
 
 ```python
 # admin.py
@@ -209,3 +209,90 @@ class Location(admin.ModelAdmin):
     list_display = ['planet', 'region', 'sub_region', 'intermediate_region']
     ordering = ['planet', 'region', 'sub_region', 'intermediate_region']
 ```
+
+
+## Example 3 from viewflow
+[viewflow](https://github.com/viewflow/viewflow) 
+([project website](http://viewflow.io/)) is a reusable workflow
+code library for organizing business logic in complex web applications.
+The code for the project is available under the 
+[GNU Alfredo license](https://github.com/viewflow/viewflow/blob/master/LICENSE).
+
+[**viewflow / viewflow / admin.py**](https://github.com/viewflow/viewflow/blob/master/viewflow/admin.py)
+
+```python
+# admin.py
+~~from django.contrib import admin, auth
+from viewflow.models import Process, Task
+
+
+~~class TaskInline(admin.TabularInline):
+    """Task inline."""
+
+    model = Task
+    fields = ['flow_task', 'flow_task_type', 'status',
+              'token', 'owner']
+    readonly_fields = ['flow_task', 'flow_task_type', 'status', 
+                       'token']
+
+    def has_add_permission(self, request):
+        """Disable manually task creation."""
+        return False
+
+    def has_delete_permission(self, request, obj=None):
+        """Disable task deletion in the process inline."""
+        return False
+
+
+~~class ProcessAdmin(admin.ModelAdmin):
+    """List all of viewflow process."""
+
+    icon = '<i class="material-icons">assignment</i>'
+
+    actions = None
+    date_hierarchy = 'created'
+    list_display = ['pk', 'created', 'flow_class', 'status', 
+                    'participants']
+    list_display_links = ['pk', 'created', 'flow_class']
+    list_filter = ['status']
+    readonly_fields = ['flow_class', 'status', 'finished']
+    inlines = [TaskInline]
+
+    def has_add_permission(self, request):
+        """Disable manually process creation."""
+        return False
+
+    def participants(self, obj):
+        """List of users performed tasks on the process."""
+        user_ids = obj.task_set.exclude(owner__isnull=True).\
+                   values('owner')
+        USER_MODEL = auth.get_user_model()
+        username_field = USER_MODEL.USERNAME_FIELD
+        users = USER_MODEL._default_manager.filter(pk__in=user_ids).\
+                values_list(username_field)
+        return ', '.join(user[0] for user in users)
+
+
+~~class TaskAdmin(admin.ModelAdmin):
+    """List all of viewflow tasks."""
+
+    icon = '<i class="material-icons">assignment_turned_in</i>'
+
+    actions = None
+    date_hierarchy = 'created'
+    list_display = ['pk', 'created', 'process', 'status',
+                    'owner', 'owner_permission', 'token',
+                    'started', 'finished']
+    list_display_links = ['pk', 'created', 'process']
+    list_filter = ['status']
+    readonly_fields = ['process', 'status', 'flow_task', 'started', 
+                       'finished', 'previous', 'token']
+
+    def has_add_permission(self, request):
+        """Disable manually task creation."""
+        return False
+
+
+~~admin.site.register(Process, ProcessAdmin)
+~~admin.site.register(Task, TaskAdmin)
+```
