Installation

Dependencies

Django==4.2.7
django-filter==23.3
djangorestframework==3.14.0

Optional:

django-import-export==4.1.0 - for import/export
django-modeltranslation==0.18.11 - for translations
django-ordered-model==3.7.4 - for ordered models

DCA installation:

pip install django-customvueadmin

Django settings:

INSTALLED_APPS

settings.py

INSTALLED_APPS = [
    ...
    'rest_framework.authtoken',
    'custom_admin',
]

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'rest_framework.authentication.TokenAuthentication',
    ]
}

Adding urls:

from django.urls import include, path, re_path
from custom_admin.views import CustomAdminView

urlpatterns = [
    re_path(r'^admin/.*$', CustomAdminView.as_view()),
    path('custom_admin/', include('custom_admin.api.urls')),
]

Make sure the static files are available:

from django.conf import settings
from django.conf.urls.static import static
from django.contrib.staticfiles.urls import staticfiles_urlpatterns

urlpatterns += staticfiles_urlpatterns() + static(
    settings.MEDIA_URL, document_root=settings.MEDIA_ROOT
)

Settings:

The ability to customize the admin panel is provided via CUSTOM_ADMIN:

CUSTOM_ADMIN = {
    'title': env.str('CUSTOM_ADMIN_TITLE', SITE_TITLE),
}

Available settings:

title
Admin tab header title.
Used to call an api from the interface side.
admin_prefix
Path where admin page will be accessable, where CustomAdminView is located.
Default: /admin/
backend_prefix
The endpoint by which the admin API will be accessed from front-end, where custom_admin.api.urls is located.
Default: /custom_admin/

If you have not specified this setting explicitly with domain and you are using https, you need this setting:

# Setting in case of https:
USE_X_FORWARDED_HOST = True
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')

logo_image
Path for the admin logo.
Default: None
favicon_image
Path for the favicon image.
Default: /static/custom_admin/favicon.ico

Languages

The LANGUAGES default setting is used to configure the languages that will be available for selection.

LANGUAGES = [
    ('ru', 'Russian'),
    ('en', 'English'),
]

Phrases available for translation

from django.utils.translation import gettext_lazy as _

_('Create')
_('Edit')
_('Action')
_('Admin')
_('Section')
_('Title')
_('Action type')
_('Log content')
_('Admin action log')
_('Admin action logs')
_('Delete')
_('Are you sure you want to delete the selected records?')
_('The records have been successfully deleted!')
_('It is not possible to delete some model instances because they are referenced via protected foreign keys: %(objects)s')
_('Records have been successfully deleted!')
_('The option ‘%(title)s’ is not among the available options.')

# Permissions:
_('View')
_('Create')
_('Change')
_('Destroy')
_('Send action')

Django Custom Admin