Add third title to SignatoryPage (#2954)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: annagav

cms/factories.py

@@ -130,6 +130,7 @@ class SignatoryPageFactory(wagtail_factories.PageFactory):
     name = factory.fuzzy.FuzzyText(prefix="Name")
     title_1 = factory.fuzzy.FuzzyText(prefix="Title_1")
     title_2 = factory.fuzzy.FuzzyText(prefix="Title_2")
+    title_3 = factory.fuzzy.FuzzyText(prefix="Title_3")
     organization = factory.fuzzy.FuzzyText(prefix="Organization")
     signature_image = factory.SubFactory(wagtail_factories.ImageFactory)
 

cms/migrations/0052_signatorypage_title_3.py

@@ -0,0 +1,22 @@
+# Generated by Django 4.2.24 on 2025-09-26 15:01
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("cms", "0051_alter_formfield_field_type"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="signatorypage",
+            name="title_3",
+            field=models.CharField(
+                blank=True,
+                help_text="Specify signatory third title in organization.",
+                max_length=250,
+                null=True,
+            ),
+        ),
+    ]

cms/models.py

@@ -430,6 +430,7 @@ def signatory_items(self):
                 "name": page.name,
                 "title_1": page.title_1,
                 "title_2": page.title_2,
+                "title_3": page.title_3,
                 "organization": page.organization,
                 "signature_image": page.signature_image.file.url,
             }
@@ -1890,6 +1891,12 @@ class SignatoryPage(Page):
         blank=True,
         help_text="Specify signatory second title in organization.",
     )
+    title_3 = models.CharField(  # noqa: DJ001
+        max_length=250,
+        null=True,
+        blank=True,
+        help_text="Specify signatory third title in organization.",
+    )
     organization = models.CharField(  # noqa: DJ001
         max_length=250,
         null=True,
@@ -1913,13 +1920,15 @@ class Meta:
         FieldPanel("name"),
         FieldPanel("title_1"),
         FieldPanel("title_2"),
+        FieldPanel("title_3"),
         FieldPanel("organization"),
         FieldPanel("signature_image"),
     ]
     api_fields = [
         APIField("name"),
         APIField("title_1"),
         APIField("title_2"),
+        APIField("title_3"),
         APIField("organization"),
         APIField("signature_image", serializer=ImageSerializer()),
     ]

cms/models_test.py

@@ -562,6 +562,7 @@ def test_certificate_for_course_page():
         signatories__0__signatory__page__name="Name",
         signatories__0__signatory__page__title_1="Title_1",
         signatories__0__signatory__page__title_2="Title_2",
+        signatories__0__signatory__page__title_3="Title_3",
         signatories__0__signatory__page__organization="Organization",
         signatories__0__signatory__page__signature_image__title="Image",
     )
@@ -572,6 +573,7 @@ def test_certificate_for_course_page():
         assert signatory.value.name == "Name"
         assert signatory.value.title_1 == "Title_1"
         assert signatory.value.title_2 == "Title_2"
+        assert signatory.value.title_3 == "Title_3"
         assert signatory.value.organization == "Organization"
         assert signatory.value.signature_image.title == "Image"
 
@@ -591,6 +593,7 @@ def test_certificate_for_program_page():
         signatories__0__signatory__page__name="Name",
         signatories__0__signatory__page__title_1="Title_1",
         signatories__0__signatory__page__title_2="Title_2",
+        signatories__0__signatory__page__title_3="Title_3",
         signatories__0__signatory__page__organization="Organization",
         signatories__0__signatory__page__signature_image__title="Image",
     )
@@ -602,6 +605,7 @@ def test_certificate_for_program_page():
         assert signatory.value.name == "Name"
         assert signatory.value.title_1 == "Title_1"
         assert signatory.value.title_2 == "Title_2"
+        assert signatory.value.title_3 == "Title_3"
         assert signatory.value.organization == "Organization"
         assert signatory.value.signature_image.title == "Image"
 

cms/templates/certificate_page.html

@@ -88,6 +88,9 @@ <h2>Congratulations, {{ learner_name }}!</h2>
                                 {% if signatory.title_2 %}
                                     <p>{{ signatory.title_2 }}</p>
                                 {% endif %}
+                                {% if signatory.title_3 %}
+                                    <p>{{ signatory.title_3 }}</p>
+                                {% endif %}
                                 {% if signatory.organization %}
                                     <p>{{ signatory.organization }}</p>
                                 {% endif %}

cms/wagtail_api/schema/serializers.py

@@ -17,6 +17,7 @@ class SignatoryItemSerializer(serializers.Serializer):
     name = serializers.CharField()
     title_1 = serializers.CharField()
     title_2 = serializers.CharField()
+    title_3 = serializers.CharField()
     organization = serializers.CharField()
     signature_image = serializers.CharField()  # or serializers.URLField() if full URLs
 

courses/models_test.py

@@ -967,6 +967,7 @@ def test_certificate_choice_limits():
         signatories__0__signatory__page__name="Name",
         signatories__0__signatory__page__title_1="Title_1",
         signatories__0__signatory__page__title_2="Title_2",
+        signatories__0__signatory__page__title_3="Title_3",
         signatories__0__signatory__page__organization="Organization",
         signatories__0__signatory__page__signature_image__title="Image",
     )
@@ -978,6 +979,7 @@ def test_certificate_choice_limits():
         signatories__0__signatory__page__name="Name",
         signatories__0__signatory__page__title_1="Title_1",
         signatories__0__signatory__page__title_2="Title_2",
+        signatories__0__signatory__page__title_3="Title_3",
         signatories__0__signatory__page__organization="Organization",
         signatories__0__signatory__page__signature_image__title="Image",
     )

openapi/specs/v0.yaml

@@ -3459,6 +3459,8 @@ components:
           type: string
         title_2:
           type: string
+        title_3:
+          type: string
         organization:
           type: string
         signature_image:
@@ -3469,6 +3471,7 @@ components:
       - signature_image
       - title_1
       - title_2
+      - title_3
     StaffDashboardUser:
       type: object
       description: Serializer for data we care about in the staff dashboard

openapi/specs/v1.yaml

@@ -3459,6 +3459,8 @@ components:
           type: string
         title_2:
           type: string
+        title_3:
+          type: string
         organization:
           type: string
         signature_image:
@@ -3469,6 +3471,7 @@ components:
       - signature_image
       - title_1
       - title_2
+      - title_3
     StaffDashboardUser:
       type: object
       description: Serializer for data we care about in the staff dashboard

openapi/specs/v2.yaml

@@ -3459,6 +3459,8 @@ components:
           type: string
         title_2:
           type: string
+        title_3:
+          type: string
         organization:
           type: string
         signature_image:
@@ -3469,6 +3471,7 @@ components:
       - signature_image
       - title_1
       - title_2
+      - title_3
     StaffDashboardUser:
       type: object
       description: Serializer for data we care about in the staff dashboard