feat: Add RESTRenderer

djangocms_rest/apps.py

@@ -0,0 +1,19 @@
+from django.apps import AppConfig
+
+
+class DjangocmsRestConfig(AppConfig):
+    """
+    AppConfig for the djangocms_rest application.
+    This application provides RESTful APIs for Django CMS.
+    """
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "djangocms_rest"
+    verbose_name = "Django CMS REST API"
+
+    def ready(self):
+        try:
+            from djangocms_text import settings
+
+            settings.TEXT_INLINE_EDITING = False
+        except (ImportError, ModuleNotFoundError):
+            pass

djangocms_rest/cms_config.py

@@ -0,0 +1,66 @@
+from functools import cached_property
+
+from django.urls import NoReverseMatch, reverse
+
+from cms.app_base import CMSAppConfig
+from cms.models import Page
+from cms.utils.i18n import force_language, get_current_language
+
+
+try:
+    from filer.models import File
+except (ImportError, ModuleNotFoundError):
+    File = None
+
+
+def get_page_api_endpoint(page, language=None, fallback=True):
+    """Get the API endpoint for a given page in a specific language.
+    If the page is a home page, return the root endpoint.
+    """
+    if not language:
+        language = get_current_language()
+
+    with force_language(language):
+        try:
+            if page.is_home:
+                return reverse("page-root", kwargs={"language": language})
+            path = page.get_path(language, fallback)
+            return (
+                reverse("page-detail", kwargs={"language": language, "path": path})
+                if path
+                else None
+            )
+        except NoReverseMatch:
+            return None
+
+
+def get_file_api_endpoint(file):
+    """For a file reference, return the URL of the file if it is public."""
+    if not file:
+        return None
+    if file.is_public:
+        return file.url
+    return None
+
+
+class RESTToolbarMixin:
+    """
+    Mixin to add REST rendering capabilities to the CMS toolbar.
+    """
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    @cached_property
+    def content_renderer(self):
+        from .plugin_rendering import RESTRenderer
+
+        return RESTRenderer(request=self.request)
+
+
+class RESTCMSConfig(CMSAppConfig):
+    cms_enabled = True
+    cms_toolbar_mixin = RESTToolbarMixin
+
+    Page.add_to_class("get_api_endpoint", get_page_api_endpoint)
+    File.add_to_class("get_api_endpoint", get_file_api_endpoint) if File else None

djangocms_rest/cms_toolbars.py

@@ -0,0 +1,8 @@
+from cms.toolbar_base import CMSToolbar
+from cms.toolbar_pool import toolbar_pool
+
+
+@toolbar_pool.register
+class RestToolbar(CMSToolbar):
+    class Media:
+        css = {"all": ("djangocms_rest/highlight.css",)}

djangocms_rest/permissions.py

@@ -1,6 +1,7 @@
 from cms.models import Page, PageContent
 from cms.utils.i18n import get_language_tuple, get_languages
 from cms.utils.page_permissions import user_can_view_page
+
 from rest_framework.exceptions import NotFound
 from rest_framework.permissions import BasePermission
 from rest_framework.request import Request