Deprecate Template

Author: matthiask

CHANGELOG.rst

@@ -5,6 +5,10 @@ Change log
 Next version
 ============
 
+- Removed mentions of the ``Template`` type from the docs and deprecated the
+  class. django-content-editor never used it, only FeinCMS did; feincms3 ships
+  its own ``TemplateType`` type replacing it.
+
 
 7.2 (2025-01-27)
 ================

content_editor/models.py

@@ -1,3 +1,5 @@
+import warnings
+
 from django.core.exceptions import ImproperlyConfigured
 from django.db import models
 
@@ -43,6 +45,14 @@ def __init__(self, *, key, **kwargs):
 class Template(Type):
     _REQUIRED = {"key", "template_name", "title", "regions"}
 
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        warnings.warn(
+            "Template is deprecated, use feincms3's TemplateType instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
 
 def create_plugin_base(content_base):
     """

docs/index.rst

@@ -381,26 +381,6 @@ You are free to define additional attributes -- simply pass them
 when instantiating a new region.
 
 
-Templates
-~~~~~~~~~
-
-Various classes will expect the main model to have a ``template``
-attribute or property which returns a ``Template`` instance.
-django-content-editor does not use the template class itself, but
-feincms3 includes a mixin which allows content managers to choose from a
-selection of templates per model instance.
-
-Templates have the following attributes:
-
-* ``title``: Something nice.
-* ``key``: The template key. Must contain a valid Python identifier.
-* ``template_name``: A template path.
-* ``regions``: A list of region instances.
-
-As with the regions above, you are free to define additional
-attributes.
-
-
 ``Contents`` class and helpers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~