feat: Add V2 of header actions slot

src/learning-header/LearningHeader.jsx

@@ -37,12 +37,14 @@ const LearningHeader = ({
         <div className="flex-grow-1 course-title-lockup d-flex" style={{ lineHeight: 1 }}>
           <CourseInfoSlot courseOrg={courseOrg} courseNumber={courseNumber} courseTitle={courseTitle} />
         </div>
-        {showUserDropdown && authenticatedUser && (
+        {authenticatedUser && (
         <>
-          <LearningHeaderActionsSlot />
-          <AuthenticatedUserDropdown
-            username={authenticatedUser.username}
-          />
+          <LearningHeaderActionsSlot showUserDropdown={showUserDropdown} />
+          {showUserDropdown && (
+            <AuthenticatedUserDropdown
+              username={authenticatedUser.username}
+            />
+          )}
         </>
         )}
         {showUserDropdown && !authenticatedUser && (

src/learning-header/LearningHeader.test.jsx

@@ -26,4 +26,11 @@ describe('Header', () => {
     expect(screen.getByText(`${courseData.courseOrg} ${courseData.courseNumber}`)).toBeInTheDocument();
     expect(screen.getByText(courseData.courseTitle)).toBeInTheDocument();
   });
+
+  it('hides the user dropdown and the header actions when showUserDropdown is false', () => {
+    render(<Header showUserDropdown={false} />);
+
+    expect(screen.queryByText(authenticatedUser.username)).not.toBeInTheDocument();
+    expect(screen.queryByText('Help')).not.toBeInTheDocument();
+  });
 });

src/plugin-slots/HeaderNotificationsSlot/README.md

@@ -12,7 +12,7 @@ This slot renders the notifications tray (bell icon + notification popover) from
 1. **Desktop Header** — via `org.openedx.frontend.layout.header_desktop_secondary_menu.v2`
    Notifications appear before secondary menu items (e.g., "New", "Help")
 
-2. **Learning Header** — via `org.openedx.frontend.layout.learning_header_actions.v1`
+2. **Learning Header** — via `org.openedx.frontend.layout.learning_header_actions.v2` (nests `.v1` — see [LearningHeaderActionsSlot](../LearningHeaderActionsSlot/v2/))
    Notifications appear before the help link
 
 3. **Studio Header** — via `org.openedx.frontend.layout.studio_header_actions.v1`
@@ -27,9 +27,10 @@ Desktop Header
     └── org.openedx.frontend.layout.header_desktop_secondary_menu.v1 (menu items only)
 
 Learning Header
-└── org.openedx.frontend.layout.learning_header_actions.v1
-    ├── org.openedx.frontend.layout.header_notifications_tray.v1 ← This slot
-    └── org.openedx.frontend.layout.header_learning_help.v1
+└── org.openedx.frontend.layout.learning_header_actions.v2
+    └── org.openedx.frontend.layout.learning_header_actions.v1 (only when showUserDropdown is true)
+        ├── org.openedx.frontend.layout.header_notifications_tray.v1 ← This slot
+        └── org.openedx.frontend.layout.header_learning_help.v1
 
 Studio Header
 └── org.openedx.frontend.layout.studio_header_actions.v1

src/plugin-slots/LearningHeaderActionsSlot/README.md

@@ -1,115 +1,6 @@
 # Learning Header Actions Slot
 
-### Slot ID: `org.openedx.frontend.layout.learning_header_actions.v1`
-
-**Default Content:**
-- **Notification Tray** (via `HeaderNotificationsSlot`) — Rendered before the help link
-- **Help Link** (via `LearningHelpSlot`)
-
----
-
-### Add Custom Components before and after Learning Header Actions
-
-The following `env.config.jsx` inserts a custom component before the notification tray (`priority: 10`) and another after the help link (`priority: 90`).
-
-![Screenshot of custom components before and after learning header actions](./images/custom_components_before_and_after_learning_actions.png)
-
-```jsx
-import React from 'react';
-import { DIRECT_PLUGIN, PLUGIN_OPERATIONS } from '@openedx/frontend-plugin-framework';
-
-const config = {
-  pluginSlots: {
-    'org.openedx.frontend.layout.learning_header_actions.v1': {
-      keepDefault: true,
-      plugins: [
-        {
-          op: PLUGIN_OPERATIONS.Insert,
-          widget: {
-            id: 'custom_before_learning_actions',
-            type: DIRECT_PLUGIN,
-            priority: 10,
-            RenderWidget: () => (
-              <h1 style={{ textAlign: 'center' }}>🌜</h1>
-            ),
-          },
-        },
-        {
-          op: PLUGIN_OPERATIONS.Insert,
-          widget: {
-            id: 'custom_after_learning_actions',
-            type: DIRECT_PLUGIN,
-            priority: 90,
-            RenderWidget: () => (
-              <h1 style={{ textAlign: 'center' }}>🌛</h1>
-            ),
-          },
-        },
-      ],
-    },
-  },
-};
-
-export default config;
-```
-
-### Hide the Entire Learning Header Actions Area
-
-The following `env.config.jsx` removes both the notification tray and the help link from the learning header.
-
-![Screenshot of hiding learning header actions area](./images/hide_learning_actions.png)
-
-```jsx
-import { PLUGIN_OPERATIONS } from '@openedx/frontend-plugin-framework';
-
-const config = {
-  pluginSlots: {
-    'org.openedx.frontend.layout.learning_header_actions.v1': {
-      keepDefault: true,
-      plugins: [
-        {
-          op: PLUGIN_OPERATIONS.Hide,
-          widgetId: 'default_contents',
-        },
-      ],
-    },
-  },
-};
-
-export default config;
-```
-
-### Replace the Entire Learning Header Actions Area with a Custom Component
-
-The following `env.config.jsx` replaces the notification tray and help link with a single custom component.
-
-![Screenshot of replacing learning header actions area with custom component](./images/replace_learning_actions_with_custom_component.png)
-
-```jsx
-import React from 'react';
-import { DIRECT_PLUGIN, PLUGIN_OPERATIONS } from '@openedx/frontend-plugin-framework';
-
-const config = {
-  pluginSlots: {
-    'org.openedx.frontend.layout.learning_header_actions.v1': {
-      keepDefault: false,
-      plugins: [
-        {
-          op: PLUGIN_OPERATIONS.Insert,
-          widget: {
-            id: 'custom_learning_actions',
-            type: DIRECT_PLUGIN,
-            priority: 50,
-            RenderWidget: () => (
-              <span>My Custom Learning Actions</span>
-            ),
-          },
-        },
-      ],
-    },
-  },
-};
-
-export default config;
-```
-
+| Slot ID | Description | Docs |
+|---------|-------------|------|
+| `org.openedx.frontend.layout.learning_header_actions.v2` | Always rendered, regardless of `showUserDropdown` (Default slot) | [v2 docs](./v2/) |
+| `org.openedx.frontend.layout.learning_header_actions.v1` | Notification tray + help link, only rendered when `showUserDropdown` is `true` | [v1 docs](./v1/) |

src/plugin-slots/LearningHeaderActionsSlot/index.jsx

@@ -1,15 +1,4 @@
-import React from 'react';
-import { PluginSlot } from '@openedx/frontend-plugin-framework';
-import HeaderNotificationsSlot from '../HeaderNotificationsSlot';
-import LearningHelpSlot from '../LearningHelpSlot';
-
-const LearningHeaderActionsSlot = () => (
-  <PluginSlot
-    id="org.openedx.frontend.layout.learning_header_actions.v1"
-  >
-    <HeaderNotificationsSlot />
-    <LearningHelpSlot />
-  </PluginSlot>
-);
+import LearningHeaderActionsSlot from './v2';
 
+export { default as LearningHeaderActionsSlotV1 } from './v1';
 export default LearningHeaderActionsSlot;

src/plugin-slots/LearningHeaderActionsSlot/v1/README.md

@@ -0,0 +1,118 @@
+# Learning Header Actions Slot — v1 (Notification Tray + Help Link)
+
+### Slot ID: `org.openedx.frontend.layout.learning_header_actions.v1`
+
+**Default Content:**
+- **Notification Tray** (via `HeaderNotificationsSlot`) — Rendered before the help link
+- **Help Link** (via `LearningHelpSlot`)
+
+> **Note:** This slot is only rendered when `showUserDropdown` is `true`. To render content regardless of `showUserDropdown`, use the parent [`v2` slot](../v2/).
+
+---
+
+## Examples
+
+### Add Custom Components before and after Learning Header Actions
+
+The following `env.config.jsx` inserts a custom component before the notification tray (`priority: 10`) and another after the help link (`priority: 90`).
+
+![Screenshot of custom components before and after learning header actions](../images/custom_components_before_and_after_learning_actions.png)
+
+```jsx
+import React from 'react';
+import { DIRECT_PLUGIN, PLUGIN_OPERATIONS } from '@openedx/frontend-plugin-framework';
+
+const config = {
+  pluginSlots: {
+    'org.openedx.frontend.layout.learning_header_actions.v1': {
+      keepDefault: true,
+      plugins: [
+        {
+          op: PLUGIN_OPERATIONS.Insert,
+          widget: {
+            id: 'custom_before_learning_actions',
+            type: DIRECT_PLUGIN,
+            priority: 10,
+            RenderWidget: () => (
+              <h1 style={{ textAlign: 'center' }}>🌜</h1>
+            ),
+          },
+        },
+        {
+          op: PLUGIN_OPERATIONS.Insert,
+          widget: {
+            id: 'custom_after_learning_actions',
+            type: DIRECT_PLUGIN,
+            priority: 90,
+            RenderWidget: () => (
+              <h1 style={{ textAlign: 'center' }}>🌛</h1>
+            ),
+          },
+        },
+      ],
+    },
+  },
+};
+
+export default config;
+```
+
+### Hide the Entire Learning Header Actions Area
+
+The following `env.config.jsx` removes both the notification tray and the help link from the learning header.
+
+![Screenshot of hiding learning header actions area](../images/hide_learning_actions.png)
+
+```jsx
+import { PLUGIN_OPERATIONS } from '@openedx/frontend-plugin-framework';
+
+const config = {
+  pluginSlots: {
+    'org.openedx.frontend.layout.learning_header_actions.v1': {
+      keepDefault: true,
+      plugins: [
+        {
+          op: PLUGIN_OPERATIONS.Hide,
+          widgetId: 'default_contents',
+        },
+      ],
+    },
+  },
+};
+
+export default config;
+```
+
+### Replace the Entire Learning Header Actions Area with a Custom Component
+
+The following `env.config.jsx` replaces the notification tray and help link with a single custom component.
+
+![Screenshot of replacing learning header actions area with custom component](../images/replace_learning_actions_with_custom_component.png)
+
+```jsx
+import React from 'react';
+import { DIRECT_PLUGIN, PLUGIN_OPERATIONS } from '@openedx/frontend-plugin-framework';
+
+const config = {
+  pluginSlots: {
+    'org.openedx.frontend.layout.learning_header_actions.v1': {
+      keepDefault: false,
+      plugins: [
+        {
+          op: PLUGIN_OPERATIONS.Insert,
+          widget: {
+            id: 'custom_learning_actions',
+            type: DIRECT_PLUGIN,
+            priority: 50,
+            RenderWidget: () => (
+              <span>My Custom Learning Actions</span>
+            ),
+          },
+        },
+      ],
+    },
+  },
+};
+
+export default config;
+```

src/plugin-slots/LearningHeaderActionsSlot/v1/index.jsx

@@ -0,0 +1,15 @@
+import React from 'react';
+import { PluginSlot } from '@openedx/frontend-plugin-framework';
+import HeaderNotificationsSlot from '../../HeaderNotificationsSlot';
+import LearningHelpSlot from '../../LearningHelpSlot';
+
+const LearningHeaderActionsSlotV1 = () => (
+  <PluginSlot
+    id="org.openedx.frontend.layout.learning_header_actions.v1"
+  >
+    <HeaderNotificationsSlot />
+    <LearningHelpSlot />
+  </PluginSlot>
+);
+
+export default LearningHeaderActionsSlotV1;