Merge pull request #3006 from UKHSA-Internal/task/new-cms-page-type/cdd-3129

Task/new cms page type/cdd 3129

Author: phill-stanley

cms/dashboard/templates/cms_starting_pages/health_topics_page.json

@@ -0,0 +1,31 @@
+{
+  "id": 83,
+  "meta": {
+    "seo_title": "Health topics",
+    "search_description": "",
+    "type": "topics_list.TopicsListPage",
+    "detail_url": "https://http:/api/pages/83/",
+    "html_url": "https://http://localhost:3000/health-topics/",
+    "slug": "health-topics",
+    "show_in_menus": false,
+    "first_published_at": "2026-02-16T16:00:23.483810Z",
+    "alias_of": null,
+    "parent": {
+      "id": 3,
+      "meta": {
+        "type": "home.UKHSARootPage",
+        "detail_url": "https://http:/api/pages/3/",
+        "html_url": null
+      },
+      "title": "UKHSA Dashboard Root"
+    }
+  },
+  "title": "health topics",
+  "body": "",
+  "seo_change_frequency": 5,
+  "seo_priority": "0.5",
+  "last_updated_at": "2026-02-16T16:00:23.483810Z",
+  "last_published_at": "2026-02-16T16:00:23.483810Z",
+  "active_announcements": [],
+  "page_description": "<p data-block-key=\"onu6j\">The UKHSA data dashboard shares public health data in a simple, inclusive and accessible way.</p>"
+}

cms/topics_list/__init__.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class TopicsListConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "cms.topics_list"

cms/topics_list/apps.py

@@ -0,0 +1,42 @@
+"""
+This file contains the custom QuerySet and Manager classes associated with the `TopicsList` model.
+
+Note that the application layer should only call into the `Manager` class.
+The application should not interact directly with the `QuerySet` class.
+"""
+
+from django.db import models
+from wagtail.models import PageManager
+from wagtail.query import PageQuerySet
+
+EXPECTED_TOPICS_LIST_PAGE_SLUG = "health-topics"
+
+
+class TopicsListPageQuerySet(PageQuerySet):
+    """Custom queryset for which can be used by the `TopicsListPageManager`."""
+
+    def get_topics_list_page(self) -> models.QuerySet:
+        """Gets the designated health-topics page.
+
+        Returns:
+            QuerySet: A queryset of the individual topics_list page.
+                Examples:
+                    `<TopicsListPageQuerySet [<TopicsListPage: Health Topics>, ... ]`
+        """
+        return self.filter(slug=EXPECTED_TOPICS_LIST_PAGE_SLUG)
+
+
+class TopicsListPageManager(PageManager):
+    """Custom model manager class for the `TopicsListPageManager`."""
+
+    def get_queryset(self) -> TopicsListPageQuerySet:
+        return TopicsListPageQuerySet(self.model, using=self._db)
+
+    def get_topics_list_page(self):
+        """Gets the designated health topics page.
+
+        Returns:
+            The designated topics list page object
+            which has the slug of `health-topics`
+        """
+        return self.get_queryset().get_topics_list_page().last()

cms/topics_list/managers.py

@@ -0,0 +1,67 @@
+from django.db import models
+from modelcluster.fields import ParentalKey
+from wagtail.admin.panels import FieldPanel, ObjectList, TabbedInterface
+from wagtail.api import APIField
+from wagtail.fields import RichTextField
+from wagtail.search import index
+
+from cms.dashboard.models import AVAILABLE_RICH_TEXT_FEATURES, UKHSAPage
+from cms.dynamic_content import help_texts
+from cms.dynamic_content.access import ALLOWABLE_BODY_CONTENT_SECTION_LINK
+from cms.dynamic_content.announcements import Announcement
+from cms.topics_list.managers import TopicsListPageManager
+
+
+class TopicsListPage(UKHSAPage):
+    max_count = 1
+    page_description = RichTextField(
+        features=AVAILABLE_RICH_TEXT_FEATURES,
+        blank=True,
+        null=True,
+        help_text=help_texts.PAGE_DESCRIPTION_FIELD,
+    )
+    body = ALLOWABLE_BODY_CONTENT_SECTION_LINK
+
+    objects = TopicsListPageManager()
+
+    # Search index configuration
+    search_fields = UKHSAPage.search_fields + [
+        index.SearchField("title"),
+    ]
+
+    # Editor panels
+    content_panels = UKHSAPage.content_panels + [
+        FieldPanel("page_description"),
+        FieldPanel("body"),
+    ]
+
+    # Sets which fields to expose on the API
+    api_fields = UKHSAPage.api_fields + [
+        APIField("title"),
+        APIField("page_description"),
+        APIField("body"),
+        APIField("last_published_at"),
+        APIField("search_description"),
+    ]
+
+    edit_handler = TabbedInterface(
+        [
+            ObjectList(content_panels, heading="Content"),
+            ObjectList(UKHSAPage.announcement_content_panels, heading="Announcements"),
+            ObjectList(UKHSAPage.promote_panels, heading="Promote"),
+        ]
+    )
+
+    @classmethod
+    def is_previewable(cls):
+        """Returns False. This is a headline CMS, preview panel is not supported ."""
+        return False
+
+
+class TopicsListPageAnnouncements(Announcement):
+    page = ParentalKey(
+        TopicsListPage,
+        on_delete=models.SET_NULL,
+        null=True,
+        related_name="announcements",
+    )

cms/topics_list/migrations/0001_initial.py

@@ -52,6 +52,7 @@
         "metrics.api",
         "cms.home",
         "cms.topic",
+        "cms.topics_list",
         "cms.dashboard",
         "cms.common",
         "cms.composite",

cms/topics_list/migrations/__init__.py

@@ -0,0 +1,19 @@
+import factory
+
+from cms.dashboard.management.commands.build_cms_site_helpers.pages import (
+    open_example_page_response,
+)
+from tests.fakes.models.cms.topics_list import FakeTopicsListPage
+
+
+class FakeTopicsListPageFactory(factory.Factory):
+    """
+    Factory for creating `FakeTopicListPage` instance for tests
+    """
+
+    class Meta:
+        model = FakeTopicsListPage
+
+    @classmethod
+    def build_blank_page(cls, **kwargs):
+        return cls.build(**kwargs)

cms/topics_list/models.py

@@ -0,0 +1,17 @@
+from cms.topics_list.models import TopicsListPage
+from tests.fakes.models.fake_model_meta import FakeMeta
+
+
+class FakeTopicsListPage(TopicsListPage):
+    """
+    A fake version of the Django model `TopicsListPage`
+    which has had its dependencies altered so that it does not interact with the database
+    """
+
+    Meta = FakeMeta
+
+    def __init__(self, **kwargs):
+        """
+        Constructor takes the same arguments as a normal `TopicsListPage` model.
+        """
+        super().__init__(content_type_id=1, **kwargs)