Django-админка одного экземпляра

Иногда в Django-админке требуется создать и редактировать только один экземпляр модели. Соответственно, когда объект уже создан, то выводить форму добавления не нужно. Заодно следует запретить создание нового экземпляра, если пользователь все-же попадет на страницу с формой добавления.

Сперва, кажется, что все слишком просто. Проблема решается добавлением метода has_add_permission

from django.contrib import admin from helpers.models import Config class ConfigAdmin(admin.ModelAdmin): def has_add_permission(self, request): return not Config.objects.exists() admin.site.register(Config, ConfigAdmin)

Но теперь, чтобы добраться до формы изменения объекта, нужно будет перейти сначала в список, содержащий всего один экземпляр, что довольно-таки бессмысленное занятие. Хорошо бы избавится от этого новообразовавшегося микротаймкиллера. Тут еще и название модели во множественном числе никуда не годится, что за кривой русский: «Выберите Настройка сайта для изменения»? Это тоже поправимо, но сейчас задача состоит в том, чтобы совсем не попадать на эту страницу.

Для этого придется создать свой класс AdminSite и нагородить в нем методов. Пример, опять же только для модели Config. Только для нее прописываем ссылку на редактирование, а не на вывод списка, остальные модели останутся как есть - со списком.

from django.contrib.admin import AdminSite from django.urls import reverse from django.utils.functional import cached_property from helpers.models import Config class CustomAdminSite(AdminSite): ONE_INSTANCE_MODELS = (Config, ) @cached_property def one_instance_edit_links(self): links = dict() for model, admin in self._registry.items(): if model in self.ONE_INSTANCE_MODELS: instance = model._default_manager.first() app_label, model_name = model._meta.app_label, model._meta.model_name if instance: link = reverse( 'admin:%s_%s_change' % (app_label, model_name), args=[instance.id], ) else: link = reverse('admin:%s_%s_add' % (app_label, model_name)) links[model.__name__] = link return links def _change_app(self, app, app_label): for model in (app.get('models') or []): admin_edit_link = self.one_instance_edit_links.get(model.get('object_name')) if admin_edit_link: model['admin_url'] = admin_edit_link def _build_app_dict(self, request, label=None): app_dict = super()._build_app_dict(request, label=label) if not app_dict: return app_dict if label: self._change_app(app_dict, app_label=label) else: for app_label, app in app_dict.items(): self._change_app(app, app_label) return app_dict admin_site = CustomAdminSite()

Теперь нужно не забыть прописать в urls.py экземпляр новой админки вместо стандартного. И, конечно, в admin.py прописать тоже свой admin_site.

from django.urls import path from app.admin_site import admin_site from app.views import HomeView urlpatterns = [ path('admin/', admin_site.urls), path('', HomeView.as_view(), name='home'), ]

Дополнительный штрих - скрываем кнопку "Сохранить и продолжить редактирование" и всегда при сохранении возвращаемся обратно на форму.

from django.contrib import admin from django.http import HttpResponseRedirect from django.urls import reverse from app.admin_site import admin_site from helpers.models import Config class ConfigAdmin(admin.ModelAdmin): def has_add_permission(self, request): return not Config.objects.exists() def change_view(self, request, object_id, form_url='', extra_context=None): extra_context = extra_context or {} extra_context['show_save_and_continue'] = False return super().change_view(request, object_id, form_url, extra_context) def _response_post_save(self, request, obj): opts = self.model._meta next_url = reverse( 'admin:%s_%s_change' % (opts.app_label, opts.model_name), args=(obj.id, ), current_app=self.admin_site.name) return HttpResponseRedirect(next_url) admin_site.register(Config, ConfigAdmin)

Что может пойти не так?
Когда есть админка одного экземпляра модели, есть некоторая вероятность, что может произойти появление еще одного экземпляра и тогда ссылка в админке может вести совсем не на тот экземпляр, что ожидается.
Подстраховаться от этого можно просто добавив сортировку по умолчанию в модели, например, по идентификатору. В этом случает запрос .first() будет вести всегда на одну и ту же запись.

Также, с момента создания своего AdminSite надо будет всегда явно добавлять админки из сторонних пакетов, что в принципе, неплохо. Порой совсем не ждешь появление свежедобавленного раздела на главной странице админки при установке очередного пакета. Поэтому, если будет нужно - всегда можно добавить, а если даже не заметил, что для какой-то модели админки нет, то она и не нужна.