Introduce a RefinedModelAdmin class which includes some of the tweaks I want to use elsewhere

Author: matthiask

CHANGELOG.rst

@@ -5,6 +5,11 @@ Change log
 Next version
 ============
 
+- Introduced ``RefinedModelAdmin`` as a lightweight base class providing common
+  admin enhancements (currently save shortcuts). The ``ContentEditor`` now
+  inherits from this base class, and ``RefinedModelAdmin`` can be used
+  independently for regular model admins that want these tweaks.
+
 
 7.3 (2025-06-23)
 ================

content_editor/admin.py

@@ -122,7 +122,12 @@ def auto_icon_colors(content_editor):
     return content_editor
 
 
-class ContentEditor(ModelAdmin):
+class RefinedModelAdmin(ModelAdmin):
+    class Media:
+        js = ["content_editor/save_shortcut.js"]
+
+
+class ContentEditor(RefinedModelAdmin):
     """
     The ``ContentEditor`` is a drop-in replacement for ``ModelAdmin`` with the
     speciality of knowing how to work with content editor plugins (that is,
@@ -215,7 +220,6 @@ def _content_editor_media(self, request, context):
             },
             js=[
                 "admin/js/jquery.init.js",
-                "content_editor/save_shortcut.js",
                 "content_editor/tabbed_fieldsets.js",
                 JSON(
                     self._content_editor_context(request, context),

docs/index.rst

@@ -544,6 +544,36 @@ content blocks are Django models, you can do anything you want
 inside them.
 
 
+RefinedModelAdmin
+=================
+
+The ``RefinedModelAdmin`` class provides a lightweight base class that extends
+Django's ``ModelAdmin`` with commonly useful tweaks. It serves as the foundation
+for the ``ContentEditor`` class, but can also be used independently for regular
+Django admin classes that want to benefit from these enhancements.
+
+Currently, ``RefinedModelAdmin`` includes:
+
+- **Save shortcuts**: Keyboard shortcuts (Ctrl+S / Cmd+S) for quickly saving forms
+- **Deletion safety check**: Shows a confirmation dialog when attempting to delete
+  the whole object instead of saving changes (including marked inline deletions)
+
+To use ``RefinedModelAdmin`` for your own admin classes:
+
+.. code-block:: python
+
+    from content_editor.admin import RefinedModelAdmin
+
+    @admin.register(MyModel)
+    class MyModelAdmin(RefinedModelAdmin):
+        # Your admin configuration here
+        pass
+
+This gives you the save shortcut functionality without the full content editor
+interface, making it useful for any Django model admin where you want these
+convenience features.
+
+
 Glossary
 ========