fix: review/sync bugs [FC-0083] #1905

rpenido · 2025-05-02T18:36:09Z

Description

This PR fixes issues related to component libraries' review/sync flow listed here (#1853).

Inconsistent sync pane title versions (ac05ae3)
Library content shown in preview warning only appears in review changes modal when that modal is opened from the review tab (ac05ae3)
Some new changes only appear within library review tab on scroll at top of list (8fd2ed6)
Vertically misaligned sync icon in review changes message on course outline (c4610ac)
Show available updates whenever content is updated, regardless of number of updates available (c1db2ee + feat: add last_published_at to upstream summary endpoint [FC-0083] edx-platform#36656)

Supporting information

Related to Review/sync experience bugs #1853

Testing instructions

Test this frontend changes with openedx/edx-platform#36656

1. Inconsistent sync pane title versions and 2. Library content shown in preview warning only appears in review changes modal when that modal is opened from the review tab

Add a library HTML component to a unit
Change the title and the content locally (on the unit)
Make changes to the component on the library and publish a new version
Open the sync page clicking on the sync button from the component header.
Confirm that:
- The header shown is the local display name
- An alert is shown explaining the preview
- The Old Version shows the content of the library prior to the change
- The New Version shows the content of the library after the change
Open the sync page from the library and confirms that it shows the same information

3. Some new changes only appear within library review tab on scroll at top of list

I suspect the two chained paginations could have caused the issue since only the last one is sorted.

We open the page, and API call returns [2,3]
We get the meilisearch results for id in [2,3]
We scroll and we get [1,4] from the API call
We refetched meilisearch and got the results from id in [1,2,3,4], which could return values in a different order.

However, I didn't manage to reproduce the issue locally.
So, just check the code from 8fd2ed6 (which removes the double pagination) and check that the results are shown accordingly.

4. Vertically misaligned sync icon in review changes message on course outline

Open a course that have pending sync components and check the alignment

5. Show available updates whenever content is updated, regardless of number of updates available

Add some components from a library to a course
Make changes to the components and check the alert showing the changed component count
Dismiss the banner
Edit one of the components again
The banner should reappear

Private ref: FAL-4144

openedx-webhooks · 2025-05-02T18:36:13Z

Thanks for the pull request, @rpenido!

This repository is currently maintained by @openedx/2u-tnl.

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 · 2025-05-02T21:18:13Z

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 93.81%. Comparing base (cc47616) to head (e25a3d2).
Report is 5 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1905      +/-   ##
==========================================
- Coverage   93.82%   93.81%   -0.01%     
==========================================
  Files        1150     1150              
  Lines       24054    24039      -15     
  Branches     5193     5195       +2     
==========================================
- Hits        22568    22553      -15     
  Misses       1409     1409              
  Partials       77       77

☔ View full report in Codecov by Sentry.
📢 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.

DanielVZ96

I left some comments for fix # 4, and I couldn't replicate the testing steps of # 5. after the first dismiss I couldn't get the banner to appear again. I tried updating multiple library components both in the unit and the library

DanielVZ96 · 2025-05-08T14:24:19Z

src/generic/alert-message/index.scss

+.alert {
+  .alert-message-content {
+    align-self: baseline;
+  }
+}


With this it both the message and icon are not cenetered.

Also I see the icon a few pixels lower

if you instead center the icon, everthing will be aligned correctly

Suggested change

.alert {

.alert-message-content {

align-self: baseline;

}

}

.alert {

.alert-icon {

align-self: center;

}

}

Thanks for the review @DanielVZ96!

With this it both the message and icon are not centered.

I aligned the top of the header and the icon.

if you instead center the icon, everthing will be aligned correctly

This would divert from the Paragon original design (https://paragon-openedx.netlify.app/components/alert/). It doesn't make much difference if the header takes only one line, but will be significantly different with more lines and/or content.

Fixed Current Design Proposed Icon Centered

What do you think?

you are right!

DanielVZ96

👍 LGTM

I tested this
I read through the code
I checked for accessibility issues

ChrisChV

Looks good! Works as expected. I request some tests and changes

src/course-libraries/ReviewTabContent.tsx

src/course-libraries/OutOfSyncAlert.tsx

Fixes issues related to component libraries' review/sync flow * Inconsistent sync pane title versions * Library content shown in preview warning only appears in review changes modal when that modal is opened from the review tab * Some new changes only appear within library review tab on scroll at top of list * Vertically misaligned sync icon in review changes message on course outline * Show available updates whenever content is updated, regardless of number of updates available

* refactor: remove custom order function from course libraries list (openedx#1865) (openedx#1888) (cherry picked from commit bc18fff) * perf: use Library search results to populate container card preview [FC-0083] [TEAK] (openedx#1889) * fix: several library unit page UX bugs (openedx#1868) * fix: rename "Organize" tab to "Manage" * fix: duplicate key warnings * fix: uniform messages while adding to collection * fix: do not allow units be added to a unit (cherry picked from commit 0fdc460) * perf: use Library search results to populate container card preview (openedx#1820) * fix: use Library search results to populate container card preview * feat: show published children when showing only published Unit content * fix: nits (cherry picked from commit 24e4695) --------- Co-authored-by: Rômulo Penido <romulo.penido@gmail.com> * fix: manage access modal on duplicated xblock (openedx#1874) * fix: unit pages ux bugs [FC-0083] (openedx#1884) (openedx#1916) This PR fixes some UX bugs related to the unit pages: * Sort for "recently modified" on unit tab does not update after adding new components to units * Change component delete warning message It's a backport of openedx#1884 * fix: UX issues in unit page (openedx#1913) (openedx#1923) Fixes the following issues: * Selection behavior * Component selection is by header click only * Newly created blocks within a unit should be selected on creation/save, appear selected, and have their sidebar open * Some long text components seem to display at the default height rather than a longer height * Within the full-page unit view, the "add to collection" overflow menu item on components does not seem to work/only opens the sidebar. * Draft status indicator text is not vertically centered with icon * When reordering, dragging a short component past a long component often causes a strange stutter effect. * When dragging to reorder a component, moving quickly or scrolling often causes the drag handle to be lost / causes the block to jump somewhere else * Reordering may not consistently support a keyboard-accessible option to change order, like in course authoring * Tag button on component header opens the old tag side pane (cherry picked from commit 8c3fab3) * fix: invalidate search results when publishing all changes in library (openedx#1925) (openedx#1927) (cherry picked from commit cdb8016) Co-authored-by: Braden MacDonald <braden@opencraft.com> * fix: improve focus/selected style on library authoring (openedx#1918) (openedx#1930) Improves the focus and selected styles from the LibraryPage and UnitPage. * fix: review/sync bugs [FC-0083] (openedx#1905) (openedx#1941) Fixes issues related to component libraries' review/sync flow * Inconsistent sync pane title versions * Library content shown in preview warning only appears in review changes modal when that modal is opened from the review tab * Some new changes only appear within library review tab on scroll at top of list * Vertically misaligned sync icon in review changes message on course outline * Show available updates whenever content is updated, regardless of number of updates available * fix: Issue with read-only units in libraries & published version of units in library units picker (openedx#1940) Fixes the issues from openedx#1633 (comment) * In successfully added units, the "add new component" widget appears sometimes * In the "add existing unit" modal, the preview shows draft versions of units * fix: search modal refresh on typing (openedx#1938) (openedx#1948) * [Teak] backport openedx#1949, openedx#1999 and openedx#2002 (openedx#2006) * feat: select component and show sidebar on edit (openedx#1949) Select component that is being edited in library and show its sidebar. Also fixes issue with children component listing in library unit page (cherry picked from commit 08ac1c0) * fix: search text flickering (openedx#1999) Fix flickering issue in search field. (cherry picked from commit 6f3b7ab) * feat: open collection or unit page on double click only (openedx#2002) Opens collection or unit page only on double click. (cherry picked from commit 503642b) * fix: change InplaceTextEditor style and add optimistic update (openedx#1953) (openedx#2014) * Optimistic update for renaming Components, Collections and Containers * Change the InplaceTextEditor to show the new text until the onSave promise resolves * Change the InplaceTextEditor style to: Always show the rename button * fix: rename library publish button (openedx#2015) * fix: do open editor of new xblock when duplicating (openedx#2017) * feat: display editors as modals (openedx#1838) * fix: do open editor of new xblock when duplicating (openedx#1887) Fixes bug where after duplicating an xblock, the editor modal of the old xblock is being open instead of the new copied xblock. * [Teak] fix: Inconsistent publish status filter menu placement & fix: Remove never published filter from component picker (openedx#2021) * fix: Inconsistent publish status filter menu placement (openedx#1966) * fix: Remove never published filter from component picker (openedx#1947) Removes the never-published filter option from the component picker and unit picker. * fix: refresh xblock inline after accepting/rejecting library sync (openedx#2022) (openedx#2028) Instead of reloading the entire Unit after syncing changes from the library, just reload the xblock that was changed. (cherry picked from commit ac5574d) * fix: set maxHeight on TextEditor TinyMce widget [FC-0090] (openedx#2024) (openedx#2030) Sets a max_height=500px for the TinyMCE editor when editing a Text/Html component. This prevents the autoresize plugin from expanding the editor textarea beyond the bounds of the editor modal. ⚠️ Because the max height can only be a numeric pixel value, we can't use clever settings like vh or %, and so we're forced to limit the height of the editor to a fixed size for all screen sizes in order to address this issue. (cherry picked from commit c5f7d0c) * fix: upstreamInfo is not always provided (openedx#2041) (openedx#2042) (cherry picked from commit 3fc0f27) * fix: selection card wiggle (openedx#2047) * fix: set unit preview readonly on sidebar (openedx#2008) (openedx#2059) Make the unit preview on the sidebar read-only and add `Truncate` to the `InplaceTextEditor` * fix: backport changes for html button in text component markdown editor (openedx#2065) * fix: markdown editor issues in modal (openedx#2076) This PR resolves rendering issues with the Markdown editor inside the modal. The problem began after a PR [1] introduced the use of modals for the editor. The EditorPage [2] component expects a `isMarkdownEditorEnabledForCourse` prop, which was missing in that implementation. [1] openedx#1838 [2] https://github.com/openedx/frontend-app-authoring/pull/1838/files#diff-147218ef88726880178ea895988a5d3feaf2c0c4459086a8de7a4080cbe37de7R226 Backports openedx#2074 * fix: Expand all now expands subsections (openedx#2085) * fix: files & uploads menu was truncated due to overflow-x (openedx#2071) (openedx#2077) * fix: (backport) remove an extra editing xblock modal on unit page (openedx#2111) (openedx#2130) * fix: (backport) enable markdown editor in libraries (openedx#2098) * fix: enable markdown editor for problems in libraries too This fix is also achieved on master via 5991fd3 / openedx#2068 but this is a simpler fix, not a direct backport of that refactor. * fix: remove duplicate markdown_edited save request (openedx#2127) Removes the unnecessary duplicate save request of markdown_edited value to the backend. Part of: openedx#2099 Backports: 62589ae --------- Co-authored-by: Muhammad Anas <88967643+Anas12091101@users.noreply.github.com> * fix: remove icon and empty breadcrumb from libraries (openedx#2129) (openedx#2133) * fix: (backport) text truncate issue in the search modal (openedx#2151) * [Teak] fix: published name in unit sidebar in container picker & Issues on Inplace Editor (openedx#2140) Backport of fix: show unit published name in sidebar on content picker [FC-0090] openedx#2100 Backport of fix: Issue on the Inplace editor [FC-0090] openedx#2101 * feat: add `v2` `CourseAuthoringUnitSidebarSlot` (openedx#2000) * fix: advanced-settings api should not camel-case return value (backport) (openedx#2087) * fix: advanced-settings api should not camel-case return value (openedx#1581) * fix: update advanced module list not working (openedx#2189) Backend was still expecting `{'advanced_modules', {'value': ['poll', 'problem-builder', 'h5pxblock']}}` but without this change, it was receiving `{'advancedModules', ['poll', 'problem-builder', 'h5pxblock']}` Follow up to openedx#1581 --------- Co-authored-by: Muhammad Faraz Maqsood <fmaqsood@2u.com> * fix: clear selection on files & uploads page after deleting (backport) (openedx#2228) * refactor: remove selected rows when deleting or adding elements * refactor: ensure unique asset IDs when adding new ones * refactor: remove unnecessary loading checks in mockStore function * test: add unit tests for TableActions component * fix: loading unit page directly from link after logging in in Teak (openedx#2246) This is a simple version of the fix for Teak; on master it was fixed with openedx#1867 * fix: pages and resources plugins not rendered (openedx#1885) * docs: (backport) adding comprehensive readme documentation for plugin slots (openedx#2340) * fix: publish btn doesn't show after component edit When we edit & save the component, publish button doesn't show up until we refresh the page manualy or open this unit by opening previous unit and coming back to this unit again. In this commit, we are dispatching a storage event whenever we edit the component, it'll refresh the page & show the publish button as expected. --------- Co-authored-by: Navin Karkera <navin@opencraft.com> Co-authored-by: Jillian <jill@opencraft.com> Co-authored-by: Rômulo Penido <romulo.penido@gmail.com> Co-authored-by: Ihor Romaniuk <ihor.romaniuk@raccoongang.com> Co-authored-by: Braden MacDonald <braden@opencraft.com> Co-authored-by: Chris Chávez <xnpiochv@gmail.com> Co-authored-by: Daniel Valenzuela <dsvalenzuela@uc.cl> Co-authored-by: Tony Busa <70979397+tonybusa@users.noreply.github.com> Co-authored-by: Muhammad Anas <88967643+Anas12091101@users.noreply.github.com> Co-authored-by: Victor Navarro <vm.navarro94@gmail.com> Co-authored-by: diana-villalvazo-wgu <diana.villalvazo@wgu.edu> Co-authored-by: bydawen <oleksandr.buhaienko@raccoongang.com> Co-authored-by: Arunmozhi <tecoholic@users.noreply.github.com> Co-authored-by: José Ignacio Palma <jignaciopm13@gmail.com> Co-authored-by: Muhammad Faraz Maqsood <fmaqsood@2u.com> Co-authored-by: Brayan Cerón <86393372+bra-i-am@users.noreply.github.com> Co-authored-by: Jansen Kantor <jkantor@edx.org> Co-authored-by: Jacobo Dominguez <jacobo.dominguez@wgu.edu> Co-authored-by: Muhammad Faraz Maqsood <faraz.maqsood@A006-01130.local>

openedx-webhooks added the open-source-contribution PR author is not from Axim or 2U label May 2, 2025

openedx-webhooks added this to Contributions May 2, 2025

github-project-automation bot moved this to Needs Triage in Contributions May 2, 2025

rpenido added 2 commits May 2, 2025 17:28

fix: preview title and add alert

ac05ae3

fix: typo and typings

8943efd

rpenido force-pushed the rpenido/fal-4144/review-sync-bugs branch from b72bd32 to 42b13a3 Compare May 2, 2025 20:29

rpenido mentioned this pull request May 2, 2025

feat: add last_published_at to upstream summary endpoint [FC-0083] openedx/edx-platform#36656

Merged

rpenido force-pushed the rpenido/fal-4144/review-sync-bugs branch from 42b13a3 to 474c951 Compare May 2, 2025 21:08

fix: use lastPublishedDate on dismissAlert

c1db2ee

rpenido force-pushed the rpenido/fal-4144/review-sync-bugs branch from 474c951 to c1db2ee Compare May 2, 2025 22:40

rpenido added 2 commits May 5, 2025 10:42

fix: temp alert header alignment fix

c4610ac

fix: remove paginated getEntityLinks

8fd2ed6

rpenido force-pushed the rpenido/fal-4144/review-sync-bugs branch from 04fad0f to 8fd2ed6 Compare May 5, 2025 18:25

mphilbrick211 moved this from Needs Triage to Blocked in Contributions May 6, 2025

mphilbrick211 moved this from Blocked to Waiting on Author in Contributions May 6, 2025

rpenido changed the title ~~fix: review/sync bugs~~ fix: review/sync bugs [FC-0083] May 7, 2025

rpenido marked this pull request as ready for review May 7, 2025 13:57

DanielVZ96 suggested changes May 8, 2025

View reviewed changes

DanielVZ96 approved these changes May 9, 2025

View reviewed changes

ChrisChV requested changes May 9, 2025

View reviewed changes

src/course-libraries/ReviewTabContent.tsx Outdated Show resolved Hide resolved

src/course-libraries/OutOfSyncAlert.tsx Show resolved Hide resolved

fix: remove duplicated useLoadOnScroll

3dbfdd4

rpenido force-pushed the rpenido/fal-4144/review-sync-bugs branch from 2ffcaed to 0cd56f1 Compare May 9, 2025 21:11

test: add tests for dimiss date

897f3f8

rpenido force-pushed the rpenido/fal-4144/review-sync-bugs branch from 0cd56f1 to 897f3f8 Compare May 9, 2025 21:20

Merge branch 'master' into rpenido/fal-4144/review-sync-bugs

e25a3d2

ChrisChV approved these changes May 12, 2025

View reviewed changes

ChrisChV merged commit d5dc8b5 into openedx:master May 12, 2025
7 checks passed

github-project-automation bot moved this from Waiting on Author to Done in Contributions May 12, 2025

rpenido deleted the rpenido/fal-4144/review-sync-bugs branch May 12, 2025 15:35

rpenido mentioned this pull request May 12, 2025

fix: review/sync bugs [teak] #1941

Merged

mphilbrick211 added the FC Relates to an Axim Funded Contribution project label May 12, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix: review/sync bugs [FC-0083] #1905

fix: review/sync bugs [FC-0083] #1905

Uh oh!

rpenido commented May 2, 2025 •

edited

Loading

Uh oh!

openedx-webhooks commented May 2, 2025 •

edited

Loading

Uh oh!

codecov bot commented May 2, 2025 •

edited

Loading

Uh oh!

DanielVZ96 left a comment

Uh oh!

DanielVZ96 May 8, 2025

Uh oh!

rpenido May 8, 2025

Uh oh!

DanielVZ96 May 9, 2025

Uh oh!

DanielVZ96 left a comment

Uh oh!

ChrisChV left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

fix: review/sync bugs [FC-0083] #1905

fix: review/sync bugs [FC-0083] #1905

Uh oh!

Conversation

rpenido commented May 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Supporting information

Testing instructions

1. Inconsistent sync pane title versions and 2. Library content shown in preview warning only appears in review changes modal when that modal is opened from the review tab

3. Some new changes only appear within library review tab on scroll at top of list

4. Vertically misaligned sync icon in review changes message on course outline

5. Show available updates whenever content is updated, regardless of number of updates available

Uh oh!

openedx-webhooks commented May 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented May 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

DanielVZ96 left a comment

Choose a reason for hiding this comment

Uh oh!

DanielVZ96 May 8, 2025

Choose a reason for hiding this comment

Uh oh!

rpenido May 8, 2025

Choose a reason for hiding this comment

Uh oh!

DanielVZ96 May 9, 2025

Choose a reason for hiding this comment

Uh oh!

DanielVZ96 left a comment

Choose a reason for hiding this comment

Uh oh!

ChrisChV left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

rpenido commented May 2, 2025 •

edited

Loading

openedx-webhooks commented May 2, 2025 •

edited

Loading

codecov bot commented May 2, 2025 •

edited

Loading