| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| 5.22.0_ Fun Ribbon Tab _ Word Search Studio source code.tar.gz | 2026-11-16 | 123.2 MB | |
| 5.22.0_ Fun Ribbon Tab _ Word Search Studio source code.zip | 2026-11-16 | 123.7 MB | |
| README.md | 2026-11-16 | 11.6 kB | |
| OpenPublisher5-i386-windowsXP.exe | 2026-11-16 | 56.5 MB | |
| openpublisher5g_amd64-windows.exe | 2026-11-16 | 81.1 MB | |
| openpublisher5_amd64-windows-portable.exe | 2026-11-16 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-11-16 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-11-16 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-11-16 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-11-16 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-11-16 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-11-16 | 156.2 MB | |
| openpublisher5_amd64-linux.AppImage | 2026-11-16 | 166.4 MB | |
| openpublisher5_amd64-freebsd.pkg | 2026-11-16 | 185.5 MB | |
| Totals: 14 Items | 2.0 GB | 0 | |
📋 Summary
Version 5.22.0 introduces a dedicated Fun tab on the Ribbon Bar alongside its flagship inaugural feature: Word Search Studio, enabling users to generate custom-shaped, print-ready word search puzzles and stylized answer keys directly onto their publication pages.
- New Fun Ribbon Tab (
index.html,ui/modals/options-modal.js): Added the Fun tab and#ribbon-funtoolbar (Puzzles & Gamesgroup) to the Ribbon Bar with full Customize Ribbon & tab visibility integration. - Word Search Studio (
ui/modals/word-search-modal.js): Full interactive puzzle builder supporting pasted word lists, configurable grid dimensions (5x5to28x28), vector shape masks (Grid, Star, Heart, Circle, and Custom Polygon), toggleable diagonal and backward placement, custom filler-letter alphabets & sequential hidden secret messages in unused cells, stylized vector loop highlights, and live Puzzle Preview / Answer Key Loops inspection. - Automatic Page 2 Answer Key (
#ws-answer-page2, checked by default): Inserts an editable Title, crisp vector Puzzle Grid SVG, and multi-column Word Bank on the current page, and automatically creates and populates Page 2 with the matching Answer Key featuring stylized loop highlights (and decoded secret-message legend when active).
🛠️ Key Improvements
1. Fun Tab & Customize Ribbon Support (index.html, ui/modals/options-modal.js)
- Ribbon Integration (
index.html): Added<div class="tab" onclick="switchTab('fun')">Fun</div>and<div class="ribbon-toolbar" id="ribbon-fun">featuring the Word Search Studio launcher (#btn-fun-wordsearch). - Options & Customization (
ui/modals/options-modal.js): Registered'fun'acrossapplyRibbonTabVisibility(),_initDefaultRibbonOrder(),saveRibbonCustomOrder(),resetRibbonToDefaults(), the Customize Ribbon tab selector (#opt-ribbon-tab-select), and tab visibility checkboxes (#opt-ribbon-fun).
2. Word Search Studio (ui/modals/word-search-modal.js)
- Shaped Grid Masks & Custom Vector Polygon Editor (
isPointInPolygon,buildCellMask): - Choose Rectangle (Grid), Star, Heart, Circle, or Polygon (Custom) masks.
- Custom Polygon mode includes an interactive SVG click-to-draw canvas (
#ws-poly-svg), quick vector presets (Triangle, Hexagon, Diamond, Arrow), Undo/Clear point controls, and live normalized coordinate text editing (0-100coordinate space). - Direction & Placement Engine (
generateWordSearchPuzzle): - Toggleable Allow Diagonal Words (
#ws-allow-diag) and Allow Backward Words (#ws-allow-back) with intersection-scoring placement and live status reporting (Placed X/Y wordsplus skipped-word notifications when a grid/mask is too small). - Custom Filler Alphabets & Secret Message Mode:
- Supports Random Custom Alphabet (
#ws-filler-alphabet) or Hide Secret Message (#ws-secret-message), laying out secret letters sequentially left-to-right across unused active cells with real-time capacity feedback (#ws-secret-hint). - Stylized Vector Answer Key Loop Highlights (
buildWordSearchSvg): - Renders true angle-matched vector stadium/capsule loops behind placed words across five selectable styles: Multi-Color Translucent Capsules, Multi-Color Outlined Loops (Ink-Saver), Custom Loop Color Capsules, Custom Loop Color Outlined (Ink-Saver), and Bold Highlighter Swipes.
- Color Customization & Presets (
COLOR_PRESETS&CustomColorPicker): - Includes one-click color theme presets (Classic Teal, Ocean Blue, Warm Berry, Forest Mint, Sunny Gold, and Chalkboard) alongside six clickable color chips (Accent, Letters, Cell Fill, Gridlines, Outline, and Loop) wired directly to Open Publisher's shared
CustomColorPickerpopup across live SVG previews, Title, Grid, and Word Bank elements. - Clear Backdrop, XP-Style
[?][X]Titlebar & Windows XP Help Window: - Drag the Word Search Studio window (
#ws-modal-header) freely across the workspace (makeModalDraggable) over a light, unblurred overlay so the publication behind stays sharp and readable. - Replaced native
<select>controls with app-themed dropdowns (.ws-modern-selectwith dark-teal.arrow-boxchevron buttons and viewport-aware floating menus) matching Font and UI Theme pickers across Open Publisher. - Paired a matching Help (
?) button (#ws-help-btn) directly beside the Close (X) button in Windows XP titlebar fashion to open a separate draggable Word Search Studio Help window styled in Open Publisher's normal teal theme (--ui-theme-color/--ui-theme-dark) with a classic Windows XP two-pane Contents tree, Back/Forward navigation toolbar, and reading pane. - 2-Page Publication Output (
insertWordSearchIntoDocument): - Generate Answer Key on Page 2 (
#ws-answer-page2) is enabled by default, automatically creating Page 2 (or filling an empty Page 2) with"Title - Answer Key", the loop-highlighted Answer Key grid SVG, and Solution Words legend while keeping the puzzle editable, scalable, selectable, and print/PDF compatible.
📖 Built-In Help Guide Topics (Word Search Studio Help)
All usage guidance built into the draggable two-pane Word Search Studio Help dialog (#ws-help-btn) is included below:
1. Overview & Quick Start
Word Search Studio builds crisp vector word search puzzles and printable Answer Keys directly on your Open Publisher pages:
- Enter Words: Paste or type words one per line or separated by commas.
- Shape & Grid: Pick Grid, Star, Heart, Circle, or a Custom Polygon mask, then tune Rows and Columns (
5to28). - Preview Live: Toggle between Puzzle Preview and Answer Key Loops, or click Shuffle Grid for a fresh layout.
- Insert: Click Insert Word Search to place the Title, Vector Puzzle Grid, Word Bank, and (by default) Page 2 Answer Key.
2. Words & Grid Sizing
Control puzzle difficulty and layout density using word directions and grid dimensions:
- Grid Rows & Columns (
5-28): Increase grid size if long words or shaped masks report skipped words in the status bar. - Allow Diagonal Words: Enables 45-degree word placement across cells.
- Allow Backward Words: Allows words to read right-to-left or bottom-to-top for extra challenge.
- Show Cell Gridlines / Outline: Toggle internal grid cell borders or the outer shape mask silhouette outline independently.
3. Shaped & Polygon Masks
Mask puzzles into thematic silhouettes while keeping text and grid spacing aligned:
- Built-in Shapes: Choose Grid (full rectangle), Star, Heart, or Circle.
- Custom Vector Polygon: Click inside the 100x100 drawing pad to plot polygon corners in order, use quick presets (Triangle, Hexagon, Diamond, Arrow), or edit normalized
x,ycoordinates directly. - Undo Pt / Clear: Step back individual points or start a fresh polygon silhouette anytime.
4. Filler & Secret Messages
Customize the decoy letters that fill unused cells inside your puzzle mask:
- Random Custom Alphabet: Uses only letters you specify (default
A-Z). Limiting the pool to letters from your word list creates trickier near-miss decoys. - Hide Secret Message: Switches filler generation to spell out a secret phrase reading sequentially left-to-right, top-to-bottom through unused cells, with a live cell-capacity counter showing how many unused filler cells are filled.
5. Colors & Font Styling
Match your publication theme using presets or Open Publisher's Custom Color Picker:
- Color Presets: Apply curated schemes such as Classic Teal, Ocean Blue, Warm Berry, Forest Mint, Sunny Gold, or Chalkboard in one click.
- Individual Swatches: Click any color swatch (Accent, Letters, Cell Fill, Gridlines, Outline, Loop) to open Open Publisher's custom color picker with Theme Colors, Standard Colors, Spectrum, and RGB/Hex controls.
- Letter Font: Choose clean sans-serif, monospace, serif, or playful lettering (Segoe UI, Courier New, Arial, Georgia, Trebuchet MS, Playful Comic) for both the puzzle grid and Word Bank.
6. Answer Key & Page 2
Automatically produce a matching solution sheet ready for teachers, books, and handouts:
- Generate Answer Key on Page 2: Checked by default. Automatically populates Page 2 (inserting one if needed) with
Title - Answer Key, solution loops, and the Word Bank (plus the hidden secret message summary when secret message mode is active). - Loop Highlight Styles: Choose Multi-Color Translucent Capsules, Multi-Color Outlined Loops (Ink-Saver), Custom Loop Color Capsules, Custom Loop Color Outlined (Ink-Saver) (driven by the Loop swatch), or Bold Highlighter Swipes.
- Editable Output: Once inserted, Titles and Word Banks are normal editable text boxes and grids are crisp vector SVGs.
🔄 Version Synchronization (v5.22.0)
| Component | Target Version | Updated Reference |
|---|---|---|
| Word Search Studio Module | v5.22.0 |
ui/modals/word-search-modal.js |
| Application Assets & Cache Busting | v5.22.0 |
index.html |
| Service Worker & Cache Store | open-publisher-v5-22-0-1 |
sw.js |
| Watermark & Print Engines | v5.22.0 |
extensions/watermark-engine.js, extensions/print-engine.js |
| AI Assistant & UI Interactions | v5.22.0 |
extensions/ai-assistant.js, extensions/ui-interactions.js |
| PWA Registration & Templates | v5.22.0 |
extensions/pwa-install.js, elements/templates/templates.js |
| Dashboard, 404 Router, & Badges | v5.22.0 |
ui/dashboard.js, 404.html, README.md |
✅ Checklist Completed
- [x] Add Fun tab &
#ribbon-funtoolbar to the Ribbon Bar and wire into Options Customize Ribbon (index.html,ui/modals/options-modal.js) - [x] Build Word Search Studio (
ui/modals/word-search-modal.js) with Grid, Star, Heart, Circle, and Custom Vector Polygon masks (interactive draw pad, presets, and coordinate input) - [x] Implement toggleable diagonal/backward word placement, custom filler-letter alphabets, sequential secret message hiding, 5 stylized vector loop highlight modes, and 6 color presets + individual swatches
- [x] Make Word Search Studio and teal-green Help dialog draggable, and style all Studio dropdowns to match app-wide
.modern-selectcontrols - [x] Include Generate Answer Key on Page 2 checked by default and populate Page 1 (Puzzle + Word Bank) and Page 2 (Answer Key + Loops) cleanly
- [x] Live browser E2E verified (Heart mask, Custom Polygon vertex draw + preset, Star mask, horizontal/vertical-only toggle verification, secret message hiding, draggable Studio + Help dialogs,
.ws-modern-selectdropdowns, Chalkboard preset +#db2777loop highlight, Page 1 + Page 2 insertion, and zero OpenPublisher JS errors) - [x] Synchronize version strings from
5.21.8to5.22.0across core HTML/JS/SW files and README badges
🚀 Version 5.22.0 - Open Publisher