feat: add legacy libraries deprecation warnings

Author: rpenido

cms/djangoapps/contentstore/utils.py

@@ -547,6 +547,20 @@ def get_taxonomy_list_url() -> str | None:
     return f'{mfe_base_url}/taxonomies'
 
 
+def get_libraries_list_url() -> str:
+    """
+    Gets course authoring microfrontend URL for libraries list view.
+    """
+    mfe_base_url = settings.COURSE_AUTHORING_MICROFRONTEND_URL
+    if mfe_base_url:
+        return f'{mfe_base_url}/libraries'
+
+    raise ImproperlyConfigured(
+        "The COURSE_AUTHORING_MICROFRONTEND_URL must be configured. "
+        "Please set it to the base url for your authoring MFE."
+    )
+
+
 def get_taxonomy_tags_widget_url(course_locator=None) -> str | None:
     """
     Gets course authoring microfrontend URL for taxonomy tags drawer widget view.

cms/static/sass/elements/_modal-window.scss

@@ -28,7 +28,7 @@
       padding: 5%;
     }
 
-    .title {
+    .title:not(.deprecated-title) {
       @extend %t-title5;
       @extend %t-demi-strong;
 

cms/templates/library.html

@@ -5,6 +5,7 @@
 </%def>
 <%!
 from cms.djangoapps.contentstore.helpers import xblock_studio_url, xblock_type_display_name
+from cms.djangoapps.contentstore.utils import get_libraries_list_url
 from django.utils.translation import gettext as _
 from openedx.core.djangolib.js_utils import dump_js_escaped_json
 from openedx.core.djangolib.markup import HTML, Text
@@ -77,6 +78,25 @@ <h3 class="sr">${_("Page Actions")}</h3>
         <div class="content-area">
 
             <div class="content-primary">
+                <div class="wrapper wrapper-alert wrapper-alert-warning is-shown" role="alert">
+                    <div class="alert announcement">
+                        <span class="feedback-symbol fa fa-warning" aria-hidden="true"></span>
+                        <span class="sr">${_("Warning")}</span>
+                        <div class="copy">
+                            <h2 class="title title-3 warning-heading-text">
+                                ${_("You are creating content in a deprecated format.")}
+                            </h2>
+                            <p>
+                                ${_(
+                                    "Legacy libraries will be unsupported in Willow. Any content you create in a"
+                                    " legacy library will soon need to be migrated. Consider using the "
+                                )}
+                                <a href="${get_libraries_list_url()}" target="_blank">${_("Libraries feature")}</a>
+                                ${_(" instead.")}
+                          </p>
+                        </div>
+                    </div>
+                </div>
                 <div class="container-message wrapper-message"></div>
                 <div class="wrapper-xblock level-page is-hidden studio-xblock-wrapper" data-locator="${context_library.location}" data-course-key="${context_library.location.library_key}">
                 </div>

cms/templates/widgets/metadata-edit.html

@@ -36,4 +36,28 @@
     <%include file="source-edit.html" />
 % endif
 
+## It is used to display a warning if a block (i.e. a LibraryContentBlock) uses the deprecated
+## legacy libraries feature.
+% if show_deprecated_warning:
+    <div class="wrapper wrapper-alert wrapper-alert-warning is-shown" role="alert">
+      <div class="alert announcement">
+        <span class="feedback-symbol fa fa-warning" aria-hidden="true"></span>
+        <span class="sr">${_("Warning")}</span>
+        <div class="copy">
+          <h2 class="title deprecated-title title-3 warning-heading-text">
+            ${_("You are creating content in a deprecated format.")}
+          </h2>
+          <p>
+            ${_(
+              "Legacy libraries will be unsupported in Willow. Any content you create in a"
+              " legacy library will soon need to be migrated. Consider using the "
+            )}
+            <a href="${library_url}" target="_blank">${_("Libraries feature")}</a>
+            ${_(" instead.")}
+          </p>
+        </div>
+      </div>
+    </div>
+% endif
+
 <div class="wrapper-comp-settings metadata_edit" id="settings-tab" data-metadata='${json.dumps(metadata_field_copy, cls=EdxJSONEncoder) | h}'></div>

xmodule/library_content_block.py

@@ -142,6 +142,20 @@ def is_ready_to_migrate_to_v2(self) -> bool:
         """
         return self.is_source_lib_migrated_to_v2 and not self.is_migrated_to_v2
 
+    def get_context(self):
+        """
+        Extend context adding `show_deprecated_warning` flag
+        """
+        from cms.djangoapps.contentstore.utils import get_libraries_list_url
+
+        library_url = get_libraries_list_url()
+
+        context = super().get_context()
+        context["show_deprecated_warning"] = True
+        context["library_url"] = library_url
+
+        return context
+
     def author_view(self, context):
         """
         Renders the Studio views.