TWE-2 - BE - Add division signpost block (#314)

* Add division signpost block (BE)
* Use firstof instead of a StructValue

Author: SharmaineLim

tbx/core/blocks.py

@@ -3,6 +3,7 @@
 from datetime import datetime
 from typing import Optional
 
+from django.conf import settings
 from django.core.exceptions import ValidationError
 from django.db import models
 from django.forms.utils import ErrorList
@@ -297,6 +298,44 @@ class IconChoice(models.TextChoices):
     WAGTAIL = "wagtail", "wagtail icon"
 
 
+class DivisionSignpostCardBlock(blocks.StructBlock):
+    class ColourTheme(models.TextChoices):
+        CORAL = "theme-coral", "Coral"
+        NEBULINE = "theme-nebuline", "Nebuline"
+        LAGOON = "theme-lagoon", "Lagoon"
+
+    card_colour = blocks.ChoiceBlock(
+        choices=ColourTheme.choices, default=ColourTheme.CORAL, max_length=20
+    )
+    heading = blocks.CharBlock(required=False)
+    description = blocks.RichTextBlock(features=settings.NO_HEADING_RICH_TEXT_FEATURES)
+    image = ImageChooserBlock()
+    link_text = blocks.CharBlock(
+        help_text=("This should be descriptive for accessibility."),
+    )
+    page = blocks.PageChooserBlock()
+
+    class Meta:
+        icon = "breadcrumb-expand"
+
+
+class DivisionSignpostBlock(blocks.StructBlock):
+    title = blocks.CharBlock(max_length=255, required=False)
+    intro = blocks.RichTextBlock(
+        features=settings.NO_HEADING_RICH_TEXT_FEATURES, required=False
+    )
+    cards = blocks.ListBlock(
+        DivisionSignpostCardBlock(),
+        max_num=3,
+        min_num=3,
+    )
+
+    class Meta:
+        group = "Custom"
+        icon = "thumbtack"
+        template = "patterns/molecules/streamfield/blocks/division_signpost_block.html"
+
+
 class HomepageShowcaseBlock(blocks.StructBlock):
     """
     This block is similar to the ShowcaseBlock, but is rendered larger
@@ -943,6 +982,7 @@ class StandardPageStoryBlock(StoryBlock):
 
 
 class HomePageStoryBlock(blocks.StreamBlock):
+    division_signpost = DivisionSignpostBlock()
     showcase = ShowcaseBlock(label="Standard showcase")
     homepage_showcase = HomepageShowcaseBlock(label="Large showcase with icons")
     featured_case_study = FeaturedCaseStudyBlock()

tbx/project_styleguide/templates/patterns/molecules/streamfield/blocks/division_signpost_block.html

@@ -0,0 +1,20 @@
+{% load wagtailcore_tags wagtailimages_tags %}
+<div>
+    {# Section heading #}
+    <h2>{{ value.title }}</h2>
+
+    {# Section intro #}
+    <div>{{ value.intro|richtext }}</div>
+
+    {# Signposting cards #}
+    <ul>
+        {% for card in value.cards %}
+            <li class="{{ card.card_colour }}">
+                {% firstof card.heading card.page.title %}
+                {{ card.description|richtext }}
+                {% image card.image fill-100x100 %}
+                <a href="{% pageurl card.page %}">{{ card.link_text }}</a>
+            </li>
+        {% endfor %}
+    </ul>
+</div>

tbx/settings/base.py

@@ -634,21 +634,23 @@
 
 
 # Rich text settings
+DEFAULT_RICH_TEXT_FEATURES = [
+    "h2",
+    "h3",
+    "h4",
+    "bold",
+    "italic",
+    "ul",
+    "ol",
+    "link",
+    "document-link",
+]
+NO_HEADING_RICH_TEXT_FEATURES = ["bold", "italic", "ul", "ol", "link", "document-link"]
 WAGTAILADMIN_RICH_TEXT_EDITORS = {
     "default": {
         "WIDGET": "wagtail.admin.rich_text.DraftailRichTextArea",
         "OPTIONS": {
-            "features": [
-                "h2",
-                "h3",
-                "h4",
-                "bold",
-                "italic",
-                "ul",
-                "ol",
-                "link",
-                "document-link",
-            ]
+            "features": DEFAULT_RICH_TEXT_FEATURES,
         },
     },
 }