Add Information Page

cms/core/tests/test_context_processors.py

@@ -7,6 +7,7 @@
 
 class ContextProcessorTestCase(TestCase):
     """Tests for context processors."""
+
     def setUp(self):
         request_factory = RequestFactory()
 

cms/core/tests/test_views.py

@@ -5,6 +5,7 @@
 
 class CSRFTestCase(TestCase):
     """Tests for CSRF enforcement."""
+
     def setUp(self):
         # Client is created with each test to avoid mutation side-effects
         self.client = Client(enforce_csrf_checks=True)

cms/jinja2/templates/pages/information_page.html

@@ -0,0 +1,27 @@
+{% extends "templates/base_page.html" %}
+{% from "components/related-content/_macro.njk" import onsRelatedContent %}
+
+{% block main %}
+    <p>{{ page.summary }}</p>
+
+    {% if page.last_updated %}
+        <h5>Last Updated: {{ page.last_updated }}</h5>
+    {% endif %}
+
+    {% include_block page.content %}
+
+    {% if related_pages %}
+        {# fmt:off #}
+        {{- 
+            onsRelatedContent({
+                "ariaLabel": _('Related content'),
+                "rows": [{
+                    "id": 'related-content',
+                    "title": _('Related content'),
+                    "itemsList": related_pages
+                }]
+            }) 
+        -}}
+        {# fmt:on #}
+    {% endif %}
+{% endblock %}

cms/release_calendar/models.py

@@ -44,18 +44,26 @@ class ReleaseCalendarPage(BasePage):  # type: ignore[django-manager-missing]
     subpage_types: ClassVar[list[str]] = []
 
     # Fields
-    status = models.CharField(choices=ReleaseStatus.choices, default=ReleaseStatus.PROVISIONAL, max_length=32)
+    status = models.CharField(
+        choices=ReleaseStatus.choices, default=ReleaseStatus.PROVISIONAL, max_length=32
+    )
     summary = RichTextField(features=settings.RICH_TEXT_BASIC)
 
     release_date = models.DateTimeField(
-        blank=True, null=True, help_text=_("Required once the release has been confirmed.")
+        blank=True,
+        null=True,
+        help_text=_("Required once the release has been confirmed."),
     )
     release_date_text = models.CharField(
-        max_length=50, blank=True, help_text=_("Format: 'Month YYYY', or 'Month YYYY to Month YYYY'.")
+        max_length=50,
+        blank=True,
+        help_text=_("Format: 'Month YYYY', or 'Month YYYY to Month YYYY'."),
     )
     next_release_date = models.DateTimeField(blank=True, null=True)
     next_release_text = models.CharField(
-        max_length=255, blank=True, help_text=_("Formats: 'DD Month YYYY Time' or 'To be confirmed'.")
+        max_length=255,
+        blank=True,
+        help_text=_("Formats: 'DD Month YYYY Time' or 'To be confirmed'."),
     )
 
     notice = RichTextField(
@@ -88,15 +96,19 @@ class ReleaseCalendarPage(BasePage):  # type: ignore[django-manager-missing]
     is_census = models.BooleanField(
         _("Census"),
         default=False,
-        help_text=_("If ticked, will display an information block about the data being related to the Census."),
+        help_text=_(
+            "If ticked, will display an information block about the data being related to the Census."
+        ),
     )
 
     changes_to_release_date = StreamField(
         ReleaseCalendarChangesStoryBlock(),
         blank=True,
         help_text=_("Required if making changes to confirmed release dates."),
     )
-    pre_release_access = StreamField(ReleaseCalendarPreReleaseAccessStoryBlock(), blank=True)
+    pre_release_access = StreamField(
+        ReleaseCalendarPreReleaseAccessStoryBlock(), blank=True
+    )
     related_links = StreamField(ReleaseCalendarRelatedLinksStoryBlock(), blank=True)
 
     content_panels: ClassVar[list[FieldPanel]] = [
@@ -107,14 +119,18 @@ class ReleaseCalendarPage(BasePage):  # type: ignore[django-manager-missing]
                 FieldRowPanel(
                     [
                         FieldPanel("release_date"),
-                        FieldPanel("release_date_text", heading=_("Or, release date text")),
+                        FieldPanel(
+                            "release_date_text", heading=_("Or, release date text")
+                        ),
                     ],
                     heading="",
                 ),
                 FieldRowPanel(
                     [
                         FieldPanel("next_release_date"),
-                        FieldPanel("next_release_text", heading=_("Or, next release text")),
+                        FieldPanel(
+                            "next_release_text", heading=_("Or, next release text")
+                        ),
                     ],
                     heading="",
                 ),
@@ -169,7 +185,12 @@ def table_of_contents(self) -> list[dict[str, str | object]]:
                 items += block.block.to_table_of_contents_items(block.value)
 
         if self.status in NON_PROVISIONAL_STATUSES and self.changes_to_release_date:
-            items += [{"url": "#changes-to-release-date", "text": _("Changes to this release date")}]
+            items += [
+                {
+                    "url": "#changes-to-release-date",
+                    "text": _("Changes to this release date"),
+                }
+            ]
 
         if self.status == ReleaseStatus.PUBLISHED and self.contact_details_id:
             text = _("Contact details")
@@ -185,6 +206,8 @@ def table_of_contents(self) -> list[dict[str, str | object]]:
                 items += [{"url": f"#{slugify(text)}", "text": text}]
 
             if self.related_links:
-                items += [{"url": "#links", "text": _("You might also be interested in")}]
+                items += [
+                    {"url": "#links", "text": _("You might also be interested in")}
+                ]
 
         return items

cms/settings/base.py

@@ -60,6 +60,7 @@
     "cms.images",
     "cms.release_calendar",
     "cms.users",
+    "cms.standard_pages",
     "wagtail.embeds",
     "wagtail.sites",
     "wagtail.users",

cms/standard_pages/apps.py

@@ -0,0 +1,8 @@
+from django.apps import AppConfig
+
+
+class StandardPagesConfig(AppConfig):
+    """The standard_pages app config."""
+
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "cms.standard_pages"

cms/standard_pages/migrations/0001_initial.py

@@ -0,0 +1,64 @@
+# Generated by Django 5.1.2 on 2024-11-08 15:48
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+import cms.core.fields
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+        ("images", "0001_initial"),
+        ("wagtailcore", "0094_alter_page_locale"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="InformationPage",
+            fields=[
+                (
+                    "page_ptr",
+                    models.OneToOneField(
+                        auto_created=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        parent_link=True,
+                        primary_key=True,
+                        serialize=False,
+                        to="wagtailcore.page",
+                    ),
+                ),
+                ("listing_title", models.CharField(blank=True, max_length=255)),
+                ("listing_summary", models.CharField(blank=True, max_length=255)),
+                ("social_text", models.CharField(blank=True, max_length=255)),
+                ("summary", models.TextField(max_length=255)),
+                ("last_updated", models.DateField(blank=True, null=True)),
+                ("content", cms.core.fields.StreamField(block_lookup={})),
+                (
+                    "listing_image",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to="images.customimage",
+                    ),
+                ),
+                (
+                    "social_image",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to="images.customimage",
+                    ),
+                ),
+            ],
+            options={
+                "abstract": False,
+            },
+            bases=("wagtailcore.page", models.Model),
+        ),
+    ]

cms/standard_pages/models.py

@@ -0,0 +1,39 @@
+from typing import ClassVar
+
+from django.db import models
+from wagtail.admin.panels import FieldPanel
+from wagtail.search import index
+
+from cms.core.blocks.stream_blocks import CoreStoryBlock
+from cms.core.fields import StreamField
+from cms.core.models import BasePage
+
+
+class InformationPage(BasePage):  # type: ignore[django-manager-missing]
+    """A generic information page model."""
+
+    template = "templates/pages/information_page.html"
+
+    parent_page_types: ClassVar[list[str]] = [
+        # Ensures that the information page can only be created under the home page
+        "home.HomePage",
+        # Ensures that the information page can be created under another information page
+        "standard_pages.InformationPage",
+    ]
+
+    summary = models.TextField(max_length=255)
+    last_updated = models.DateField(blank=True, null=True)
+    content = StreamField(CoreStoryBlock())
+
+    content_panels: ClassVar[list[FieldPanel]] = [
+        *BasePage.content_panels,
+        FieldPanel("summary"),
+        FieldPanel("last_updated"),
+        FieldPanel("content"),
+    ]
+
+    search_fields: ClassVar[list[index.SearchField | index.AutocompleteField]] = [
+        *BasePage.search_fields,
+        index.SearchField("summary"),
+        index.SearchField("content"),
+    ]

cms/static_src/sass/main.scss

@@ -2,3 +2,18 @@
 body {
     display: block;
 }
+
+// Custom CSS from Wagtail doc to enable responsive video embeds
+.responsive-object {
+    position: relative;
+}
+
+.responsive-object iframe,
+.responsive-object object,
+.responsive-object embed {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+}