From cd63f7e802060ccc0cf55cc266abf3363fa549b5 Mon Sep 17 00:00:00 2001
From: Yannick Warnier <ywarnier@beeznest.org>
Date: Tue, 23 Aug 2022 12:55:25 +0200
Subject: [PATCH] Display: Add feature to add CSS class to HTML main <section>
 element for specific enabled features that are used more globally through
 global variable $htmlContentExtraClass - refs BT#13334

---
 main/inc/lib/template.lib.php                 | 25 +++++++++++++++++++
 .../default/gradebook/skill_rel_user.tpl      |  4 ++-
 main/template/default/layout/page.tpl         |  2 +-
 main/template/default/layout/show_header.tpl  |  2 +-
 4 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/main/inc/lib/template.lib.php b/main/inc/lib/template.lib.php
index 1efa91b2e8..72b91b5494 100755
--- a/main/inc/lib/template.lib.php
+++ b/main/inc/lib/template.lib.php
@@ -223,6 +223,10 @@ class Template
         $this->set_footer($show_footer);
         $this->set_header($show_header);
 
+        // Extra class for the main cm-content div
+        global $htmlContentExtraClass;
+        $this->setExtraContentClass($htmlContentExtraClass);
+
         $this->set_header_parameters($sendHeaders);
         $this->set_footer_parameters();
 
@@ -462,6 +466,27 @@ class Template
         $this->assign('show_course_shortcut', $courseToolBar);
         $this->assign('show_course_navigation_menu', $show_course_navigation_menu);
     }
+    /**
+     * Sets an extra class for the main cm-content div.
+     * To use, give a new row to $htmlContentExtraClass like so: `$htmlContentExtraClass[] = 'feature-item-user-skill-on';`
+     * before any Display::display_header() call.
+     */
+    public function setExtraContentClass($htmlContentExtraClass): void
+    {
+        if (empty($htmlContentExtraClass)) {
+            $extraClass = '';
+        } else {
+            if (is_array($htmlContentExtraClass)) {
+                $extraClass = implode(' ', $htmlContentExtraClass);
+            } else {
+                $extraClass = $htmlContentExtraClass;
+            }
+            $extraClass = Security::remove_XSS($extraClass);
+            $extraClass = trim($extraClass);
+            $extraClass = ' class="'.$extraClass.'"';
+        }
+        $this->assign('html_content_extra_class', $extraClass);
+    }
 
     /**
      * Returns the sub-folder and filename for the given tpl file.
diff --git a/main/template/default/gradebook/skill_rel_user.tpl b/main/template/default/gradebook/skill_rel_user.tpl
index 105ea51e39..db05e26b2f 100644
--- a/main/template/default/gradebook/skill_rel_user.tpl
+++ b/main/template/default/gradebook/skill_rel_user.tpl
@@ -1,3 +1,4 @@
+<div {{ html_content_extra_class }}>
 <h3>{{ user.complete_name_with_username }}</h3>
 <br />
 <script>
@@ -64,4 +65,5 @@
         </td>
     </tr>
     {% endfor %}
-</table>
\ No newline at end of file
+</table>
+</div>
\ No newline at end of file
diff --git a/main/template/default/layout/page.tpl b/main/template/default/layout/page.tpl
index 7ef1361a6d..5be9382027 100644
--- a/main/template/default/layout/page.tpl
+++ b/main/template/default/layout/page.tpl
@@ -45,7 +45,7 @@
             {% endif %}
 
             <!-- START CONTENT -->
-            <section id="cm-content">
+            <section id="cm-content"{{ html_content_extra_class }}>
                 <div class="container">
                     {% if show_course_shortcut is not null %}
                         <!-- TOOLS SHOW COURSE -->
diff --git a/main/template/default/layout/show_header.tpl b/main/template/default/layout/show_header.tpl
index 63e658cb90..a91838ea20 100755
--- a/main/template/default/layout/show_header.tpl
+++ b/main/template/default/layout/show_header.tpl
@@ -45,7 +45,7 @@
     {% endif %}
 
     <!-- START CONTENT -->
-    <section id="cm-content">
+    <section id="cm-content"{{ html_content_extra_class }}>
         <div class="container">
             {% if show_header == true %}
                 {% if show_course_shortcut is not null %}