Merge pull request #17735 from edx/pwnage101/maintenance-banner

maintenance banner for 1.11 migration

common/djangoapps/student/views/dashboard.py

@@ -38,6 +38,7 @@ from openedx.core.djangoapps.credit.email_utils import get_credit_provider_displ
 from openedx.core.djangoapps.programs.models import ProgramsApiConfig
 from openedx.core.djangoapps.programs.utils import ProgramDataExtender, ProgramProgressMeter
 from openedx.core.djangoapps.site_configuration import helpers as configuration_helpers
+from openedx.core.djangoapps.util.maintenance_banner import add_maintenance_banner
 from openedx.core.djangoapps.waffle_utils import WaffleFlag, WaffleFlagNamespace
 from openedx.features.enterprise_support.api import get_dashboard_consent_notification
 from shoppingcart.api import order_history
@@ -527,6 +528,7 @@ def _get_urls_for_resume_buttons(user, enrollments):
 
 @login_required
 @ensure_csrf_cookie
+@add_maintenance_banner
 def student_dashboard(request):
     """
     Provides the LMS dashboard view

openedx/core/djangoapps/util/maintenance_banner.py

@@ -0,0 +1,43 @@
+"""
+View decorator to add a maintenance banner configured in settings.
+"""
+from __future__ import absolute_import
+
+from functools import wraps
+
+from django.conf import settings
+
+from openedx.core.djangoapps.util.user_messages import PageLevelMessages
+from openedx.core.djangoapps.util.waffle import DISPLAY_MAINTENANCE_WARNING, waffle
+
+
+def add_maintenance_banner(func):
+    """
+    View decorator to select where exactly the banner will appear
+
+    Add to function-based views like this:
+
+        from openedx.core.djangoapps.util.maintenance_banner import add_maintenance_banner
+
+        @add_maintenance_banner
+        def my_view(request):
+            ...
+
+    Add to class-based views using method_decorator:
+
+        from openedx.core.djangoapps.util.maintenance_banner import add_maintenance_banner
+        from django.utils.decorators import method_decorator
+
+        @method_decorator(add_maintenance_banner, name='dispatch')
+        class MyView(View):
+            ...
+    """
+    @wraps(func)
+    def _decorated(request, *args, **kwargs):  # pylint: disable=missing-docstring
+        if waffle().is_enabled(DISPLAY_MAINTENANCE_WARNING):
+            if hasattr(settings, 'EDXAPP_MAINTENANCE_BANNER_TEXT') and settings.EDXAPP_MAINTENANCE_BANNER_TEXT:
+                # The waffle switch is enabled and the banner text is defined
+                # and non-empty.  We can now register the message:
+                PageLevelMessages.register_warning_message(request, settings.EDXAPP_MAINTENANCE_BANNER_TEXT)
+        return func(request, *args, **kwargs)
+    return _decorated

openedx/core/djangoapps/util/waffle.py

@@ -0,0 +1,18 @@
+"""
+Waffle flags and switches
+"""
+from __future__ import absolute_import
+
+from openedx.core.djangoapps.waffle_utils import WaffleSwitchNamespace
+
+WAFFLE_NAMESPACE = u'open_edx_util'
+
+# Switches
+DISPLAY_MAINTENANCE_WARNING = u'display_maintenance_warning'
+
+
+def waffle():
+    """
+    Returns the namespaced, cached, audited Waffle class for open_edx_util.
+    """
+    return WaffleSwitchNamespace(name=WAFFLE_NAMESPACE, log_prefix=u'OpenEdX Util: ')

openedx/features/course_experience/views/course_home.py

@@ -24,6 +24,7 @@ from lms.djangoapps.course_goals.api import (
 from lms.djangoapps.courseware.exceptions import CourseAccessRedirect
 from lms.djangoapps.courseware.views.views import CourseTabView
 from openedx.core.djangoapps.plugin_api.views import EdxFragmentView
+from openedx.core.djangoapps.util.maintenance_banner import add_maintenance_banner
 from openedx.features.course_experience.course_tools import CourseToolsPluginManager
 from student.models import CourseEnrollment
 from util.views import ensure_valid_course_key
@@ -48,6 +49,7 @@ class CourseHomeView(CourseTabView):
     @method_decorator(ensure_csrf_cookie)
     @method_decorator(cache_control(no_cache=True, no_store=True, must_revalidate=True))
     @method_decorator(ensure_valid_course_key)
+    @method_decorator(add_maintenance_banner)
     def get(self, request, course_id, **kwargs):
         """
         Displays the home page for the specified course.