django-admin-index-modules 1.0.1

Django admin index modules is a Django app that gives you the ability to add widgets modules to the django admin dashboard (admin index)

Django admin index modules

Django admin index modules is a Django app that gives you the ability to add widgets modules to the django admin dashboard (admin index).

Quick start

1. comment "django.contrib.admin" and add "django_admin_index_modules.apps.CustomAdminConfig" to your INSTALLED_APPS setting like this:

    INSTALLED_APPS = [
        ...
        #'django.contrib.admin',
        'django_admin_index_modules.apps.CustomAdminConfig',
        ...

        'django.contrib.staticfiles',
        ...

        'django_admin_index_modules.apps.ModulesDashboardsConfig',
        ...
    ]

2. In admin.py file of any other app create ypur widget module like this:

    class VisitorsAdminModuleView(AdminModuleView):

        template_name = 'visitors.html'
        json_method_names = ['post']
        http_method_names = ['get','post']
        permissions = ['is_superuser']
        css = []
        js = []

        def get(self, request, **kwargs):
            context = {
                'stats': "visitors"
            }
            return context

3. register your widget module using one of those methods:

4. 1. using register_module(AdminModuleView, position="middle_top") methods:

    site.register_module(VisitorsAdminModuleView, position="middle_top")

3. 2. using @register_module(position="middle_top") decorator:

    @register_module(position="middle_top")
    class VisitorsAdminModuleView(AdminModuleView):
        ...

3. 3. position keyword can take one of those values: top, middle_top, middle_bottom and bottom

4. Visit http://127.0.0.1:8000/admin/ to see your widget module.