Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.3.5
Name Modified Size InfoDownloads / Week
Parent folder
5.3.5_ Ignore Theme Toggle _ Master Theme Restoration Engine source code.tar.gz 2026-10-06 22.4 MB
5.3.5_ Ignore Theme Toggle _ Master Theme Restoration Engine source code.zip 2026-10-06 22.7 MB
README.md 2026-10-06 11.3 kB
OpenPublisher-5-x86_64.AppImage 2026-10-06 166.4 MB
openpublisher5_amd64-windows-portable.exe 2026-10-06 183.2 MB
openpublisher5_amd64-windows.exe 2026-10-06 165.2 MB
openpublisher5_amd64-macos.dmg 2026-10-06 233.1 MB
openpublisher5_amd64-linux.run 2026-10-06 193.4 MB
openpublisher5_amd64-linux.rpm 2026-10-06 215.4 MB
openpublisher5_amd64-linux.flatpak 2026-10-06 153.6 MB
openpublisher5_amd64-linux.deb 2026-10-06 156.2 MB
openpublisher5_amd64-freebsd.pkg 2026-10-06 185.5 MB
Totals: 12 Items   1.7 GB 0

🚀 Summary

Version 5.3.5 delivers a dedicated usability overhaul to the Page Design ribbon tab and Theme Studio Engine, converting the one-way "Ignore Theme" action into a fully reactive, bidirectional toggle button with real-time visual feedback, automatic theme de-selection resets, instantaneous master theme restoration, and per-page synchronization across multi-page documents.

In earlier versions, invoking "Ignore Theme" was an irreversible one-way operation. Once clicked, the current page was permanently flagged with ignoreBackground = true, preventing users from ever setting or changing a theme again on that page. Any subsequent attempt to select a gradient, texture, or palette swatch was instantly purged by the self-healing background engine within 500ms.

With this release, "Ignore Theme" functions as a true bidirectional toggle: clicking it overrides the master theme with a blank canvas and highlights the button with active ribbon styling. Clicking it a second time turns the override off and immediately restores the document master theme. Furthermore, selecting any theme or color swatch automatically clears the ignore override, disengages the active button state, and applies the selected theme without ribbon tab disruption or data loss.


🔍 Context & Problem Analysis

An exhaustive audit of user feedback identified three major friction points with the Page Design ribbon tab:

  1. Irreversible One-Way Lockout:
  2. The legacy clearPageBackground() routine in ui/themes.js permanently assigned ignoreBackground = true to the active page without providing any toggling mechanism to disengage it.
  3. Once a user tested or used "Ignore Theme", there was no user-facing way to un-ignore themes on that page.

  4. Self-Healing Watchdog Purged New Themes:

  5. The theme watchdog loop in extensions/legacy-fixes.js checked if (state.pages[state.currentPageIndex]?.ignoreBackground) theme.remove();.
  6. Because applyThemeToCanvas did not clear the ignoreBackground flag when swatches were clicked, the watchdog immediately removed any newly applied theme from the canvas, giving the illusion that the theme picker was broken.

  7. Absence of Visual Toggle Feedback:

  8. The #no-bg-btn ribbon button remained visually inert regardless of whether the page was ignoring themes or displaying one.
  9. Users had no visual cues indicating why themes were not applying or which pages had overrides enabled.

  10. Ribbon Tab Jump During Theme Restoration:

  11. Rebuilding theme DOM wrappers routed through createWrapper(), which selected the new element and jumped the active ribbon tab away from Page Design to contextual formatting tabs.

🛠️ Architectural Solution & Implementation

1. Bidirectional toggleIgnoreTheme() in ui/themes.js

  • Re-architected clearPageBackground() into window.toggleIgnoreTheme(), maintaining window.clearPageBackground as an alias for complete backward compatibility.
  • Seamlessly flips curPage.ignoreBackground = !curPage.ignoreBackground:
  • When Toggled ON: Caches any existing background color (curPage._previousBg), clears existing theme DOM elements, sets paper background to clean #ffffff, and updates ribbon button styling.
  • When Toggled OFF: Restores the document's saved master theme immediately via window.restoreThemeFromSave(), or recovers the cached background color.

2. Reactive Toggle Button Styling & Accessibility (#no-bg-btn)

  • Created window.updateIgnoreThemeButtonUI() to synchronize the DOM button state with state.pages[state.currentPageIndex]?.ignoreBackground.
  • Integrated native Office ribbon active toggle styling in style.css:
  • Applies .active class with color-mix(in srgb, var(--ui-theme-color) 20%, transparent) background tint and 1.5px solid var(--ui-theme-color) accent border.
  • Updates aria-pressed="true" when enabled and "false" when disabled.
  • Sets intuitive tooltips: "Theme Ignored on this page (Click to re-enable themes)" vs "Ignore Theme (Blank Page)".

3. Smart Auto-Reset upon Theme Selection

  • Updated applyThemeToCanvas in extensions/legacy-fixes.js to automatically set curPage.ignoreBackground = false and invoke updateIgnoreThemeButtonUI() whenever a user clicks any Theme Studio gradient or texture swatch.
  • Updated color palette swatch clicks in ui/themes.js to clear ignoreBackground and update the toggle button state.
  • Completely prevents the background self-healer from discarding newly chosen themes.

4. Non-Destructive Theme Reconstruction (restoreThemeFromSave)

  • Extracted theme restoration logic from the background interval into a reusable window.restoreThemeFromSave() engine.
  • Added active ribbon tab preservation (activeTabId) and temporary window.switchTab muting during wrapper instantiation.
  • Eliminates ribbon tab jumps, keeping the user smoothly anchored on the Page Design tab.

5. Multi-Page Synchronization & History Serialization

  • Hooked window.updateIgnoreThemeButtonUI() directly into renderPage() in core/pages.js.
  • Navigating between pages via thumbnails, page counter, or keyboard shortcuts dynamically updates #no-bg-btn to reflect the active page's specific override state.
  • Preserved full state serialization in core/history.js (ignoreBackground: existingPage.ignoreBackground || false), ensuring undo/redo actions accurately update the toggle button and canvas.

🛠️ Files Modified

  • ui/themes.js: Replaced one-way background clearing with window.toggleIgnoreTheme(), added window.updateIgnoreThemeButtonUI(), updated color swatch clicks to auto-reset ignore state, and maintained window.clearPageBackground alias.
  • extensions/legacy-fixes.js: Bound #no-bg-btn to toggleIgnoreTheme(), configured applyThemeToCanvas to reset ignoreBackground = false, extracted window.restoreThemeFromSave(), and added active tab preservation during element creation.
  • core/pages.js: Integrated window.updateIgnoreThemeButtonUI() into renderPage() to synchronize ribbon toggle state on page switch and document deserialization.
  • style.css: Added native ribbon .active styling for #no-bg-btn with theme color mix, inset shadow, scaled icon, and high-contrast hover states.
  • index.html: Bumped all script, stylesheet, and asset cachebusters from ?v=5.3.4 to ?v=5.3.5.
  • sw.js: Updated Service Worker cache name to open-publisher-v5-3-5 and version headers.
  • extensions/pwa-install.js: Bumped version header and SW registration to sw.js?v=5.3.5.
  • extensions/geo-defense.js: Bumped version header to (v5.3.5).
  • ui/dashboard.js: Bumped template index and file fetch queries to ?v=5.3.5.
  • elements/templates/templates.js: Bumped template index queries to ?v=5.3.5.
  • elements/arrow/arrow.js: Bumped version comments to v5.3.5.

🧪 Verification & Automated Testing

All features and interactions were validated through an automated Playwright end-to-end test suite:

Test Scenario Verification Metric Result Output Details
Initial Page State #no-bg-btn inactive state and page flag Passed Class contains no .active; state.pages[0].ignoreBackground is falsy
Theme Studio Selection Applying gradient swatch from Theme Studio Passed Theme container rendered inside paper; #no-bg-btn remains inactive
Ignore Theme Toggle ON Clicking #no-bg-btn to engage override Passed Button gains .active class; ignoreBackground set to true; theme removed from canvas
Ignore Theme Toggle OFF Clicking #no-bg-btn to disengage override Passed Button loses .active class; ignoreBackground set to false; theme instantly restored
Auto-Reset on New Theme Selecting second theme while ignore is active Passed Button resets to inactive; new gradient applied and persists without watchdog deletion
Multi-Page Synchronization Switching between Page 1 (theme) and Page 2 (ignored) Passed Page 1 button is inactive; Page 2 button is active; state accurately tracks page changes
Ribbon Tab Preservation Applying themes does not switch ribbon tabs Passed Active tab remains Page Design; no unwanted jumping to Format or Home tabs
Visual Artifact Generation Verified screenshot capture and inspection Passed Saved verified visual screenshots in artifacts directory

✅ Checklist Completed

  • [x] Converted Ignore Theme to a Bidirectional Toggle: Replaced one-way flag assignment with window.toggleIgnoreTheme(), allowing users to turn the theme override on and off at will.
  • [x] Added Native Ribbon Active Styling: Designed responsive .active toggle state in style.css featuring themed accent background tints, high-contrast borders, and interactive hover feedback.
  • [x] Implemented Instant Master Theme Restoration: Created window.restoreThemeFromSave() to immediately reconstruct document themes when the override is toggled off.
  • [x] Fixed Theme Selection Blocking: Updated applyThemeToCanvas and color palette swatches to automatically clear ignoreBackground and deactivate the toggle button upon selecting a theme.
  • [x] Eliminated Ribbon Tab Jumping: Preserved the active tab identifier during theme wrapper instantiation, keeping the user anchored on the Page Design tab.
  • [x] Integrated Per-Page Synchronization: Hooked button state updates into renderPage(), ensuring the toggle button accurately reflects the active page across navigation.
  • [x] Preserved Undo and Redo History: Ensured ignoreBackground is cleanly serialized in core/history.js and restored on state navigation.
  • [x] Full Version 5.3.5 Synchronization: Updated Service Worker cache (open-publisher-v5-3-5), PWA installer, module headers, template fetchers, and all 79 cachebusters in index.html.
  • [x] 100% Automated Verification Pass Rate: Executed comprehensive Playwright end-to-end tests validating all toggle transitions, swatch selections, and multi-page workflows.
  • [x] Strict Adherence to Project Rules: Stored notes strictly in the artifacts directory; strictly zero em dashes used; no remote git push.

🎉 Version 5.3.5 - Open Publisher

Source: README.md, updated 2026-10-06