From b006cdf9d9ca7d180fcf1614ea399b54d5b11dcd Mon Sep 17 00:00:00 2001 From: Ozohu Adejumo Date: Mon, 24 Nov 2025 20:21:01 +0000 Subject: [PATCH 1/3] docs: Document toggle for maximum courses on homepage Added toggle documentation for HOMEPAGE_COURSE_MAX. --- lms/envs/common.py | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/lms/envs/common.py b/lms/envs/common.py index 0419633f583e..3ca1266b2622 100644 --- a/lms/envs/common.py +++ b/lms/envs/common.py @@ -2472,7 +2472,14 @@ # require student context. MODULESTORE_FIELD_OVERRIDE_PROVIDERS = ('openedx.features.content_type_gating.' 'field_override.ContentTypeGatingFieldOverride',) - +# .. toggle_name: HOMEPAGE_COURSE_MAX +# .. toggle_implementation: DjangoSetting +# .. toggle_default: None +# .. toggle_description: Controls the maximum number of courses displayed on the LMS homepage. +# If set to None, all available courses will be shown. Useful for operators who want to limit the homepage length. +# .. toggle_use_cases: open_edx +# .. toggle_creation_date: 2025-11-24 +# .. toggle_tickets: https://github.com/openedx/edx-platform/issues/37585 # Sets the maximum number of courses listed on the homepage # If set to None, all courses will be listed on the homepage HOMEPAGE_COURSE_MAX = None From 920caa724023e350e828b7fe36808f11e44ed913 Mon Sep 17 00:00:00 2001 From: ozohu1 Date: Tue, 28 Jul 2026 19:01:22 +0100 Subject: [PATCH 2/3] docs: Remove redundant homepage comments --- lms/envs/common.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/lms/envs/common.py b/lms/envs/common.py index 3ca1266b2622..d94cf78c3c81 100644 --- a/lms/envs/common.py +++ b/lms/envs/common.py @@ -2480,8 +2480,7 @@ # .. toggle_use_cases: open_edx # .. toggle_creation_date: 2025-11-24 # .. toggle_tickets: https://github.com/openedx/edx-platform/issues/37585 -# Sets the maximum number of courses listed on the homepage -# If set to None, all courses will be listed on the homepage + HOMEPAGE_COURSE_MAX = None # .. setting_name: COURSE_MEMBER_API_ENROLLMENT_LIMIT From 4928f73417947c48f030876d974fe013ada2a903 Mon Sep 17 00:00:00 2001 From: ozohu1 Date: Tue, 28 Jul 2026 22:35:21 +0100 Subject: [PATCH 3/3] docs: Document HOMEPAGE_COURSE_MAX as a setting --- lms/envs/common.py | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/lms/envs/common.py b/lms/envs/common.py index 0a3e52705ee4..9a2443d0da83 100644 --- a/lms/envs/common.py +++ b/lms/envs/common.py @@ -2557,14 +2557,10 @@ # require student context. MODULESTORE_FIELD_OVERRIDE_PROVIDERS = ('openedx.features.content_type_gating.' 'field_override.ContentTypeGatingFieldOverride',) -# .. toggle_name: HOMEPAGE_COURSE_MAX -# .. toggle_implementation: DjangoSetting -# .. toggle_default: None -# .. toggle_description: Controls the maximum number of courses displayed on the LMS homepage. -# If set to None, all available courses will be shown. Useful for operators who want to limit the homepage length. -# .. toggle_use_cases: open_edx -# .. toggle_creation_date: 2025-11-24 -# .. toggle_tickets: https://github.com/openedx/edx-platform/issues/37585 +# .. setting_name: HOMEPAGE_COURSE_MAX +# .. setting_default: None +# .. setting_description: Controls the maximum number of courses displayed on the LMS homepage. +# If set to None, all available courses will be shown. HOMEPAGE_COURSE_MAX = None