Update the HYL fields to compress them down into a single field

Author: jkachel

cms/constants.py

@@ -12,3 +12,43 @@
 ONE_MINUTE = 60
 
 FEATURED_ITEMS_CACHE_KEY = "CMS_homepage_featured_courses"
+
+HYL_CHOICE_REALWORLD_LEARNING = {
+    "icon": "IconConnectedPeople",
+    "title": "Real-World Learning",
+    "text": "Learn from MIT faculty and experts who ground their teaching in real-world cases rather than mathematical models, making the material approachable for all.",
+}
+HYL_CHOICE_LEARN_BY_DOING = {
+    "icon": "IconBrains",
+    "title": "Practical Application",
+    "text": "Apply your new knowledge with hands-on, practical exercises drawn from healthcare, sports, finance, sustainability, and more.",
+}
+HYL_CHOICE_LEARN_FROM_OTHERS = {
+    "icon": "IconBrains",
+    "title": "Learn From Others",
+    "text": "Connect with an international community of professionals working on real-world projects.",
+}
+HYL_CHOICE_LEARN_ON_DEMAND = {
+    "icon": "IconBrains",
+    "title": "Learn On Demand",
+    "text": "Access all course content online with complete flexibility to study at your own pace.",
+}
+HYL_CHOICE_AI_ENABLED_SUPPORT = {
+    "icon": "IconComputerBulb",
+    "title": "AI-Enabled Support",
+    "text": "Deepen your understanding of the course material and get help on assignments from AskTIM, the AI assistant built by MIT researchers.",
+}
+HYL_CHOICE_STACKABLE_CREDENTIALS = {
+    "icon": "IconCertificate",
+    "title": "Stackable Credentials",
+    "text": "Earn an MIT Open Learning certificate at each milestone—module, course, and program—demonstrating your AI expertise. Available in paid courses only.",
+}
+
+HYL_CHOICES = {
+    "realworld_learning": HYL_CHOICE_REALWORLD_LEARNING,
+    "learn_by_doing": HYL_CHOICE_LEARN_BY_DOING,
+    "learn_from_others": HYL_CHOICE_LEARN_FROM_OTHERS,
+    "learn_on_demand": HYL_CHOICE_LEARN_ON_DEMAND,
+    "ai_enabled_support": HYL_CHOICE_AI_ENABLED_SUPPORT,
+    "stackable_credentials": HYL_CHOICE_STACKABLE_CREDENTIALS,
+}

cms/models.py

@@ -58,6 +58,7 @@
 from cms.constants import (
     CERTIFICATE_INDEX_SLUG,
     COURSE_INDEX_SLUG,
+    HYL_CHOICES,
     INSTRUCTOR_INDEX_SLUG,
     PROGRAM_COLLECTION_INDEX_SLUG,
     PROGRAM_INDEX_SLUG,
@@ -1295,12 +1296,7 @@ class Meta:
         APIField("faculty_section_title"),
         APIField("faculty"),
         APIField("certificate_page", serializer=ProductChildPageSerializer()),
-        APIField("hyl_choice_realworld_learning"),
-        APIField("hyl_choice_learn_by_doing"),
-        APIField("hyl_choice_learn_from_others"),
-        APIField("hyl_choice_learn_on_demand"),
-        APIField("hyl_choice_ai_enabled_support"),
-        APIField("hyl_choice_stackable_credentials"),
+        APIField("how_youll_learn"),
     ]
 
     subpage_types = ["FlexiblePricingRequestForm", "CertificatePage"]
@@ -1361,6 +1357,16 @@ def product(self):
         """Returns the courseware object (Course, Program) associated with this page"""
         raise NotImplementedError
 
+    @property
+    def how_youll_learn(self):
+        """Returns the selected choices for the How You'll Learn section."""
+
+        return [
+            {"key": key, **HYL_CHOICES[key]}
+            for key in HYL_CHOICES
+            if getattr(self, f"hyl_choice_{key}", False)
+        ]
+
     def get_url_parts(self, request=None):
         """
         Overrides base method for returning the parts of the URL for pages of this class

cms/wagtail_api/schema/serializers.py

@@ -86,6 +86,15 @@ class OverrideSerializer(serializers.Serializer):
     id = serializers.CharField()
 
 
+class HowYoullLearnSerializer(serializers.Serializer):
+    """Serializer for the How You'll Learn generated property"""
+
+    key = serializers.CharField()
+    icon = serializers.CharField()
+    title = serializers.CharField()
+    text = serializers.CharField()
+
+
 class PageMetaSerializer(serializers.Serializer):
     """
     Serializer for page metadata used in various Wagtail pages.
@@ -189,12 +198,7 @@ class Meta:
             "topic_list",
             "include_in_learn_catalog",
             "ingest_content_files_for_ai",
-            "hyl_choice_realworld_learning",
-            "hyl_choice_learn_by_doing",
-            "hyl_choice_learn_from_others",
-            "hyl_choice_learn_on_demand",
-            "hyl_choice_ai_enabled_support",
-            "hyl_choice_stackable_credentials",
+            "how_youll_learn",
         ]
 
         # NOTE: We use this serializer for schema generation only,
@@ -208,6 +212,7 @@ class Meta:
     certificate_page = CertificatePageSerializer(allow_null=True)
     course_details = CourseSerializer()
     topic_list = TopicSerializer(many=True)
+    how_youll_learn = HowYoullLearnSerializer(many=True)
 
 
 class CoursePageListSerializer(serializers.Serializer):
@@ -252,12 +257,7 @@ class Meta:
             "faculty",
             "certificate_page",
             "program_details",
-            "hyl_choice_realworld_learning",
-            "hyl_choice_learn_by_doing",
-            "hyl_choice_learn_from_others",
-            "hyl_choice_learn_on_demand",
-            "hyl_choice_ai_enabled_support",
-            "hyl_choice_stackable_credentials",
+            "how_youll_learn",
         ]
 
         # NOTE: We use this serializer for schema generation only,
@@ -277,6 +277,7 @@ def get_description(self, instance):
     faculty = FacultySerializer(many=True)
     certificate_page = CertificatePageSerializer()
     program_details = ProgramSerializer()
+    how_youll_learn = HowYoullLearnSerializer(many=True)
 
 
 class ProgramPageListSerializer(serializers.Serializer):

openapi/specs/v0.yaml

@@ -4192,36 +4192,10 @@ components:
           nullable: true
           description: If true, allow the AI chatbots to ingest the course's content
             files.
-        hyl_choice_realworld_learning:
-          type: boolean
-          nullable: true
-          description: Learn from faculty experts who emphasize practical application
-            over theory.
-        hyl_choice_learn_by_doing:
-          type: boolean
-          nullable: true
-          description: Practice core competencies through case studies, simulations,
-            and hands-on tools.
-        hyl_choice_learn_from_others:
-          type: boolean
-          nullable: true
-          description: Connect with an international community of professionals working
-            on real-world projects.
-        hyl_choice_learn_on_demand:
-          type: boolean
-          nullable: true
-          description: Access all course content online with complete flexibility
-            to study at your own pace.
-        hyl_choice_ai_enabled_support:
-          type: boolean
-          nullable: true
-          description: Get personalized help on assignments from AskTIM, powered by
-            advanced AI.
-        hyl_choice_stackable_credentials:
-          type: boolean
-          nullable: true
-          description: Earn certificates at key milestones—module, course, and program—building
-            a portfolio of expertise.
+        how_youll_learn:
+          type: array
+          items:
+            $ref: '#/components/schemas/HowYoullLearn'
       required:
       - about
       - certificate_page
@@ -4232,12 +4206,7 @@ components:
       - faculty_section_title
       - faq_url
       - feature_image
-      - hyl_choice_ai_enabled_support
-      - hyl_choice_learn_by_doing
-      - hyl_choice_learn_from_others
-      - hyl_choice_learn_on_demand
-      - hyl_choice_realworld_learning
-      - hyl_choice_stackable_credentials
+      - how_youll_learn
       - id
       - include_in_learn_catalog
       - ingest_content_files_for_ai
@@ -5477,6 +5446,23 @@ components:
       - Elementary/primary school
       - No formal education
       - Other education
+    HowYoullLearn:
+      type: object
+      description: Serializer for the How You'll Learn generated property
+      properties:
+        key:
+          type: string
+        icon:
+          type: string
+        title:
+          type: string
+        text:
+          type: string
+      required:
+      - icon
+      - key
+      - text
+      - title
     IntegrationTypeEnum:
       enum:
       - sso
@@ -7025,36 +7011,10 @@ components:
           $ref: '#/components/schemas/CertificatePage'
         program_details:
           $ref: '#/components/schemas/V2Program'
-        hyl_choice_realworld_learning:
-          type: boolean
-          nullable: true
-          description: Learn from faculty experts who emphasize practical application
-            over theory.
-        hyl_choice_learn_by_doing:
-          type: boolean
-          nullable: true
-          description: Practice core competencies through case studies, simulations,
-            and hands-on tools.
-        hyl_choice_learn_from_others:
-          type: boolean
-          nullable: true
-          description: Connect with an international community of professionals working
-            on real-world projects.
-        hyl_choice_learn_on_demand:
-          type: boolean
-          nullable: true
-          description: Access all course content online with complete flexibility
-            to study at your own pace.
-        hyl_choice_ai_enabled_support:
-          type: boolean
-          nullable: true
-          description: Get personalized help on assignments from AskTIM, powered by
-            advanced AI.
-        hyl_choice_stackable_credentials:
-          type: boolean
-          nullable: true
-          description: Earn certificates at key milestones—module, course, and program—building
-            a portfolio of expertise.
+        how_youll_learn:
+          type: array
+          items:
+            $ref: '#/components/schemas/HowYoullLearn'
       required:
       - about
       - certificate_page
@@ -7064,12 +7024,7 @@ components:
       - faculty_section_title
       - faq_url
       - feature_image
-      - hyl_choice_ai_enabled_support
-      - hyl_choice_learn_by_doing
-      - hyl_choice_learn_from_others
-      - hyl_choice_learn_on_demand
-      - hyl_choice_realworld_learning
-      - hyl_choice_stackable_credentials
+      - how_youll_learn
       - id
       - length
       - max_price