add new admin django code example

mattmakai · mattmakai · commit 9b96ead6b5b5 · 2019-06-30T09:26:00.000-04:00
diff --git a/content/pages/examples/django/django-contrib-admin.markdown b/content/pages/examples/django/django-contrib-admin.markdown
@@ -271,3 +271,171 @@ from viewflow.models import Process, Task
 ~~admin.site.register(Process, ProcessAdmin)
 ~~admin.site.register(Task, TaskAdmin)
 ```
+
+
+## Example 4 from django-filer
+[django-filer](https://github.com/divio/django-filer)
+([project documentation](https://django-filer.readthedocs.io/en/latest/))
+is a file management library for uploading and organizing files and 
+images in Django's admin interface. 
+
+The project's code is available under the 
+[BSD 3-Clause "New" or "Revised" open source license](https://github.com/divio/django-filer/blob/develop/LICENSE.txt).
+
+[**django-filer / filer / admin / fileadmin.py**](https://github.com/divio/django-filer/blob/develop/filer/admin/fileadmin.py)
+
+```python
+# -*- coding: utf-8 -*-
+from __future__ import absolute_import
+
+from django import forms
+from django.contrib.admin.utils import unquote
+from django.http import HttpResponseRedirect
+from django.urls import reverse
+from django.utils.safestring import mark_safe
+from django.utils.translation import ugettext as _
+
+from .. import settings
+from ..models import File
+~~from .permissions import PrimitivePermissionAwareModelAdmin
+~~from .tools import AdminContext, admin_url_params_encoded, popup_status
+
+
+~~class FileAdminChangeFrom(forms.ModelForm):
+    class Meta(object):
+        model = File
+        exclude = ()
+
+
+~~class FileAdmin(PrimitivePermissionAwareModelAdmin):
+    list_display = ('label',)
+    list_per_page = 10
+    search_fields = ['name', 'original_filename', 'sha1', 'description']
+    raw_id_fields = ('owner',)
+    readonly_fields = ('sha1', 'display_canonical')
+
+    form = FileAdminChangeFrom
+
+    @classmethod
+    def build_fieldsets(cls, extra_main_fields=(), extra_advanced_fields=(),
+                        extra_fieldsets=()):
+        fieldsets = (
+            (None, {
+                'fields': (
+                    'name',
+                    'owner',
+                    'description',
+                ) + extra_main_fields,
+            }),
+            (_('Advanced'), {
+                'fields': (
+                    'file',
+                    'sha1',
+                    'display_canonical',
+                ) + extra_advanced_fields,
+                'classes': ('collapse',),
+            }),
+        ) + extra_fieldsets
+        if settings.FILER_ENABLE_PERMISSIONS:
+            fieldsets = fieldsets + (
+                (None, {
+                    'fields': ('is_public',)
+                }),
+            )
+        return fieldsets
+
+    def response_change(self, request, obj):
+        """
+        Overrides the default to be able to forward to the directory listing
+        instead of the default change_list_view
+        """
+        if (
+            request.POST
+            and '_continue' not in request.POST
+            and '_saveasnew' not in request.POST
+            and '_addanother' not in request.POST
+        ):
+            # Popup in pick mode or normal mode. In both cases we want to go
+            # back to the folder list view after save. And not the useless file
+            # list view.
+            if obj.folder:
+                url = reverse('admin:filer-directory_listing',
+                              kwargs={'folder_id': obj.folder.id})
+            else:
+                url = reverse(
+                    'admin:filer-directory_listing-unfiled_images')
+            url = "{0}{1}".format(
+                url,
+                admin_url_params_encoded(request),
+            )
+            return HttpResponseRedirect(url)
+        return super(FileAdmin, self).response_change(request, obj)
+
+    def render_change_form(self, request, context, add=False, change=False,
+                           form_url='', obj=None):
+        info = self.model._meta.app_label, self.model._meta.model_name
+        extra_context = {'show_delete': True,
+                         'history_url': 'admin:%s_%s_history' % info,
+                         'is_popup': popup_status(request),
+                         'filer_admin_context': AdminContext(request)}
+        context.update(extra_context)
+        return super(FileAdmin, self).render_change_form(
+            request=request, context=context, add=add, change=change,
+            form_url=form_url, obj=obj)
+
+    def delete_view(self, request, object_id, extra_context=None):
+        """
+        Overrides the default to enable redirecting to the directory view after
+        deletion of a image.
+        we need to fetch the object and find out who the parent is
+        before super, because super will delete the object and make it
+        impossible to find out the parent folder to redirect to.
+        """
+        try:
+            obj = self.get_queryset(request).get(pk=unquote(object_id))
+            parent_folder = obj.folder
+        except self.model.DoesNotExist:
+            parent_folder = None
+
+        if request.POST:
+            # Return to folder listing, since there is no usable file listing.
+            super(FileAdmin, self).delete_view(
+                request=request, object_id=object_id,
+                extra_context=extra_context)
+            if parent_folder:
+                url = reverse('admin:filer-directory_listing',
+                              kwargs={'folder_id': parent_folder.id})
+            else:
+                url = reverse('admin:filer-directory_listing-unfiled_images')
+            url = "{0}{1}".format(
+                url,
+                admin_url_params_encoded(request)
+            )
+            return HttpResponseRedirect(url)
+
+        return super(FileAdmin, self).delete_view(
+            request=request, object_id=object_id,
+            extra_context=extra_context)
+
+    def get_model_perms(self, request):
+        """
+        It seems this is only used for the list view. NICE :-)
+        """
+        return {
+            'add': False,
+            'change': False,
+            'delete': False,
+        }
+
+    def display_canonical(self, instance):
+        canonical = instance.canonical_url
+        if canonical:
+            return mark_safe('<a href="%s">%s</a>' % (canonical, canonical))
+        else:
+            return '-'
+    display_canonical.allow_tags = True
+    display_canonical.short_description = _('canonical URL')
+
+
+~~FileAdmin.fieldsets = FileAdmin.build_fieldsets()
+```
diff --git a/content/pages/examples/django/django-core-management-base-basecommand.markdown b/content/pages/examples/django/django-core-management-base-basecommand.markdown
@@ -25,7 +25,8 @@ by Vitor Freitas.
 is a file management library for uploading and organizing files and 
 images in Django's admin interface. The project also installs a few
 Django `manage.py` commands to make it easier to work with the files
-and images that you upload.
+and images that you upload. The project's code is available under the 
+[BSD 3-Clause "New" or "Revised" open source license](https://github.com/divio/django-filer/blob/develop/LICENSE.txt).
 
 [**django-filer / filer / management / commands / generate_thumbnails.py**](https://github.com/divio/django-filer/blob/develop/filer/management/commands/generate_thumbnails.py)
 
