feat: Course outline restructure with new plugin slots by xitij2000 · Pull Request #1920 · openedx/frontend-app-learning

xitij2000 · 2026-05-27T10:17:11Z

Splits useCourseOutlineSidebar into useCourseOutlineData + useCourseOutlineSidebar, adds CourseOutlineSidebarHeadingSlot, CourseOutlineSidebarSectionCompletionIconSlot, and CourseOutlineSidebarSequenceCompletionIconSlot, and introduces CSS variables for theming the sidebar.

openedx-webhooks · 2026-05-27T10:17:18Z

Thanks for the pull request, @xitij2000!

This repository is currently maintained by @openedx/committers-frontend-app-learning.

Once you've gone through the following steps feel free to tag them in a comment and let them know that your changes are ready for engineering review.

🔘 Get product approval

If you haven't already, check this list to see if your contribution needs to go through the product review process.

If it does, you'll need to submit a product proposal for your contribution, and have it reviewed by the Product Working Group.
- This process (including the steps you'll need to take) is documented here.
If it doesn't, simply proceed with the next step.

🔘 Provide context

To help your reviewers and other members of the community understand the purpose and larger context of your changes, feel free to add as much of the following information to the PR description as you can:

Dependencies

This PR must be merged before / after / at the same time as ...
Blockers

This PR is waiting for OEP-1234 to be accepted.
Timeline information

This PR must be merged by XX date because ...
Partner information

This is for a course on edx.org.
Supporting documentation
Relevant Open edX discussion forum threads

🔘 Get a green build

If one or more checks are failing, continue working on your changes until this is no longer the case and your build turns green.

Details

Where can I find more information?

If you'd like to get more details on all aspects of the review process for open source pull requests (OSPRs), check out the following resources:

When can I expect my changes to be merged?

Our goal is to get community contributions seen and reviewed as efficiently as possible.

However, the amount of time that it takes to review and merge a PR can vary significantly based on factors such as:

The size and impact of the changes that it introduces
The need for product review
Maintenance status of the parent repository

💡 As a result it may take up to several weeks or months to complete a review and merge your PR.

codecov · 2026-05-27T10:28:26Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.47%. Comparing base (8eb7cca) to head (614ced5).
⚠️ Report is 3 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1920      +/-   ##
==========================================
+ Coverage   91.46%   91.47%   +0.01%     
==========================================
  Files         351      351              
  Lines        5820     5831      +11     
  Branches     1390     1393       +3     
==========================================
+ Hits         5323     5334      +11     
  Misses        478      478              
  Partials       19       19

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

xitij2000 · 2026-06-12T11:24:15Z

@brian-smith-tcril Did you get a chance to look at this PR?

brian-smith-tcril · 2026-06-12T13:52:41Z

@brian-smith-tcril Did you get a chance to look at this PR?

Not quite yet. I've been focused on a release testing bug fix. I definitely haven't forgotten about it and it's still high on my todo list.

brian-smith-tcril

Overall these extension points seem like good ones to add. Looking forward to continuing to discuss these changes and finding a good path for them to land!

brian-smith-tcril · 2026-06-16T10:13:42Z


  return (
-    <li className={classNames({ 'bg-info-100': isActive, 'border-top border-light': !isFirst })}>
+    <li className={classNames({ 'active-unit bg-info-100': isActive, 'border-top border-light': !isFirst })}>


active-unit doesn't appear to exist.

xitij2000 · 2026-06-17T13:50:41Z

@brian-smith-tcril

Just giving context on some of the issues:

I removed some of the padding, and colors classes so that themes can more easily override those. Unfortunately I had move them to the CSS file but those changes are lost. I can reimplement it, or revert to the original classes if what I'm planning is unacceptable.
I've added active-unit and active-section to allow themes to override these styles even if the default theme doesn't do it or does it by simply applying a class.

I tried splitting this PR into two parts, however there were quite a few dependencies between the commits so it wasn't as easy a split as I hoped. I'll apply the other fixes first.

brian-smith-tcril · 2026-06-18T13:40:54Z

I removed some of the padding, and colors classes so that themes can more easily override those. Unfortunately I had move them to the CSS file but those changes are lost. I can reimplement it, or revert to the original classes if what I'm planning is unacceptable.

I'm open to discussing those changes, but I'd like to keep this PR focused on adding the plugin slots. By keeping the PR focused we won't have changes blocking each other from landing.

I've added active-unit and active-section to allow themes to override these styles even if the default theme doesn't do it or does it by simply applying a class.

That's probably fine, but I'd still prefer to have this as a "just adding slots" PR.

I tried splitting this PR into two parts, however there were quite a few dependencies between the commits so it wasn't as easy a split as I hoped. I'll apply the other fixes first.

I'm sorry about that. I know it can be frustrating to split things up, but I think the benefits of focused PRs are very real.

xitij2000 · 2026-06-20T06:28:40Z

@brian-smith-tcril I've split out the slots into this PR: #1933

A test is failing locally so I still have work to do, but I'll rebase this PR once that one is merged.

xitij2000 · 2026-07-22T14:59:16Z

        variant="tertiary"
-        className={classNames(
-          'd-flex align-items-center w-100 px-4 py-3.5 rounded-0 justify-content-start',
-          { 'bg-info-100': isActiveSection },


This is now applied via SCSS

Splits useCourseOutlineSidebar into useCourseOutlineData and useCourseOutlineSidebar for improved separation of responsibilities. Updates components to reflect this change. This allows the course outline to be used outside of a sidebar context.

- Replace hardcoded border color (#d7d3d1) with var(--pgn-color-light-700) in CourseOutlineTray.scss for theme compatibility. - Move active-section highlight to a dedicated .active-section class on SidebarSection and add an .active-unit class on SidebarUnit.

xitij2000 · 2026-07-23T09:08:18Z

@brian-smith-tcril I've updated this PR.

FYI: the update to the ARCHITECTURE.md file was made using claude.

itsjeyd · 2026-08-12T07:49:36Z

Hi @brian-smith-tcril, would you have time to take another look at this PR?

brian-smith-tcril · 2026-08-13T12:37:08Z

+  const handleClick = React.useCallback(() => {
+    // Hide the sidebar after selecting a unit on a mobile device.
+    if (shouldDisplayFullScreen) {
+      handleToggleCollapse();
+    }
+    handleUnitClick({ sequenceId, activeUnitId, id });
+  }, [handleUnitClick, sequenceId, activeUnitId, id, shouldDisplayFullScreen, handleToggleCollapse]);


In #1920 (comment) I mentioned

This might not be needed after #1923 lands, worth double checking once that's in.

#1923 has landed now, I haven't looked to deeply into if that would change what needs to happen here or not. Anything stand out to you as no longer needed or as something that should change now that it has landed?

brian-smith-tcril · 2026-08-13T12:39:59Z

@itsjeyd I took another look and resolved a lot of my old comments.

@xitij2000 this PR has a conflict in SidebarUnit.jsx, knowing how that gets resolved would make the next review pass much smoother, so if you could rebase this that would be perfect!

openedx-webhooks added open-source-contribution PR author is not from Axim or 2U core contributor PR author is a Core Contributor (who may or may not have write access to this repo). labels May 27, 2026

openedx-webhooks added this to Contributions May 27, 2026

github-project-automation Bot moved this to Needs Triage in Contributions May 27, 2026

xitij2000 force-pushed the kshitij/course-outline-refactor-and-slots branch from 44ec042 to cd853d0 Compare May 27, 2026 10:22

xitij2000 changed the title ~~refactor: Course outline restructure with new plugin slots and CSS variables~~ refactor: Course outline restructure with new plugin slots May 27, 2026

xitij2000 changed the title ~~refactor: Course outline restructure with new plugin slots~~ feat: Course outline restructure with new plugin slots May 27, 2026

xitij2000 mentioned this pull request May 27, 2026

feat: more customisability for course outline sidebar, course tabs #1908

Draft

itsjeyd moved this from Needs Triage to Ready for Review in Contributions Jun 3, 2026

itsjeyd added the waiting for eng review PR is ready for review. Review and merge it, or suggest changes. label Jun 3, 2026

itsjeyd requested review from a team and brian-smith-tcril June 9, 2026 13:49

brian-smith-tcril reviewed Jun 16, 2026

View reviewed changes

xitij2000 force-pushed the kshitij/course-outline-refactor-and-slots branch from dc917eb to d627014 Compare June 17, 2026 13:53

itsjeyd moved this from Ready for Review to In Eng Review in Contributions Jun 24, 2026

itsjeyd added blocked by other work PR cannot be finished until other work is complete and removed waiting for eng review PR is ready for review. Review and merge it, or suggest changes. labels Jun 24, 2026

xitij2000 force-pushed the kshitij/course-outline-refactor-and-slots branch 2 times, most recently from c3daaa0 to f59ca84 Compare July 22, 2026 14:51

xitij2000 commented Jul 22, 2026

View reviewed changes

xitij2000 added 2 commits July 23, 2026 13:13

xitij2000 force-pushed the kshitij/course-outline-refactor-and-slots branch from f59ca84 to cc980c5 Compare July 23, 2026 07:46

xitij2000 force-pushed the kshitij/course-outline-refactor-and-slots branch from cc980c5 to 614ced5 Compare July 23, 2026 09:06

itsjeyd added waiting for eng review PR is ready for review. Review and merge it, or suggest changes. and removed blocked by other work PR cannot be finished until other work is complete labels Jul 28, 2026

itsjeyd requested a review from brian-smith-tcril July 28, 2026 13:55

brian-smith-tcril reviewed Aug 13, 2026

View reviewed changes

Uh oh!

Conversation

xitij2000 commented May 27, 2026

Uh oh!

openedx-webhooks commented May 27, 2026

Uh oh!

codecov Bot commented May 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

xitij2000 commented Jun 12, 2026

Uh oh!

brian-smith-tcril commented Jun 12, 2026

Uh oh!

brian-smith-tcril left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

brian-smith-tcril Jun 16, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

xitij2000 commented Jun 17, 2026

Uh oh!

brian-smith-tcril commented Jun 18, 2026

Uh oh!

xitij2000 commented Jun 20, 2026

Uh oh!

xitij2000 Jul 22, 2026

Choose a reason for hiding this comment

Uh oh!

xitij2000 commented Jul 23, 2026

Uh oh!

itsjeyd commented Aug 12, 2026

Uh oh!

brian-smith-tcril Aug 13, 2026

Choose a reason for hiding this comment

Uh oh!

brian-smith-tcril commented Aug 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

codecov Bot commented May 27, 2026 •

edited

Loading