ultimate-jekyll-manager 1.9.8 → 1.9.9

package/CLAUDE.md

@@ -193,6 +193,7 @@ All `npm install` calls in CLI commands (`npx mgr i`, `npx mgr setup`) route thr
 - **No backwards compatibility** unless explicitly requested.
 - **Don't add `?.` paranoia.** Framework internals (`manager.config`, `manager.webManager`) deref directly. `?.` belongs only on user-supplied config sub-fields, optional return values from regex matches, caught exceptions, and pre-init state.
 - **Use `process.cwd()` (not hardcoded paths) for consumer-project resolution** in gulp tasks + commands. UJM runs inside the consumer's working directory.
+- **All `<img src>` tags MUST have a cachebreaker** — append `?cb={{ site.uj.cache_breaker }}` to image `src` attributes in includes and layouts. This applies to logos, brandmarks, rating images, and any other image rendered via Liquid variables. External third-party URLs (YouTube embeds, analytics pixels, placeholder services) are exempt. `data-lazy="@src"` is handled at the JS layer, not here. See [docs/common-mistakes.md](docs/common-mistakes.md).
 
 ## Doc-update parity
 

package/dist/defaults/dist/_includes/themes/classy/backend/sections/sidebar.html

@@ -10,7 +10,7 @@
     <a href="{{ logo_href }}" class="d-flex align-items-center text-decoration-none text-body">
       {% iftruthy logo_src %}
         <div class="avatar avatar-md me-2 {{ logo_class }}">
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+          <img src="{{ logo_src }}?cb={{ site.uj.cache_breaker }}" alt="{{ logo_text }} Logo"/>
         </div>
       {% endiftruthy %}
       {% iftruthy logo_text %}
@@ -186,7 +186,7 @@
     <h5 class="offcanvas-title d-flex align-items-center" id="mobileSidebarLabel">
       {% iftruthy logo_src %}
         <div class="avatar avatar-md me-2">
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+          <img src="{{ logo_src }}?cb={{ site.uj.cache_breaker }}" alt="{{ logo_text }} Logo"/>
         </div>
       {% endiftruthy %}
       {% iftruthy logo_text %}

package/dist/defaults/dist/_includes/themes/classy/frontend/sections/nav.html

@@ -9,10 +9,10 @@
     <a class="navbar-brand d-inline-flex align-items-center py-0" href="{{ logo_href }}">
       {% iftruthy logo_src %}
         {% if data.logo.type == 'wordmark' %}
-          <img src="{{ logo_src }}" alt="{{ logo_text }} Logo" class="{{ logo_class }}" style="height: 2rem; width: auto;"/>
+          <img src="{{ logo_src }}?cb={{ site.uj.cache_breaker }}" alt="{{ logo_text }} Logo" class="{{ logo_class }}" style="height: 2rem; width: auto;"/>
         {% else %}
           <div class="avatar avatar-md me-2 {{ logo_class }}">
-            <img src="{{ logo_src }}" alt="{{ logo_text }} Logo"/>
+            <img src="{{ logo_src }}?cb={{ site.uj.cache_breaker }}" alt="{{ logo_text }} Logo"/>
           </div>
         {% endif %}
       {% endiftruthy %}

package/dist/defaults/dist/_layouts/themes/classy/frontend/pages/feedback.html

@@ -92,7 +92,7 @@ prerender_icons:
                   {% for rating in page.resolved.feedback_form.ratings %}
                     <div class="col-6 col-sm-3">
                       <button type="button" class="feedback-rating-btn w-100 border rounded-3 bg-body text-center" data-rating="{{ rating.id }}">
-                        <img src="{{ rating.image }}" alt="{{ rating.label }}" class="feedback-rating-img mb-2" width="64" height="64" loading="eager">
+                        <img src="{{ rating.image }}?cb={{ site.uj.cache_breaker }}" alt="{{ rating.label }}" class="feedback-rating-img mb-2" width="64" height="64" loading="eager">
                         <span class="d-block small fw-semibold text-muted">{{ rating.label }}</span>
                       </button>
                     </div>

package/docs/common-mistakes.md

@@ -13,3 +13,4 @@
 11. **Using native fetch** — always use `wonderful-fetch` or `authorized-fetch`.
 12. **XSS — unescaped dynamic data in innerHTML** — Use `webManager.utilities().escapeHTML()`. Dynamic URLs in `href`/`src`/`action`/`window.location`/`window.open` ALSO need `webManager.utilities().sanitizeURL()` — `escapeHTML` alone lets `javascript:` execute. See [xss-prevention.md](xss-prevention.md).
 13. **Leaving Liquid `{{ }}` or `{% %}` inside moved JS modules** — Jekyll does NOT process `src/assets/js/**/*.js`. Use `data-*` attribute bridges or `<template>` cloning.
+14. **🚫 `<img src>` without cachebreakers** — every `<img src>` in includes/layouts MUST append `?cb={{ site.uj.cache_breaker }}` to the URL. This applies to logos, brandmarks, rating images — any image rendered via a Liquid variable. Without it, browsers serve stale cached versions indefinitely when the image file changes on the CDN. External third-party URLs are exempt. `data-lazy="@src"` is handled at the JS layer, not in the HTML.

package/docs/jekyll-plugin.md

@@ -6,7 +6,7 @@ Ultimate Jekyll uses the `jekyll-uj-powertools` gem for custom Liquid functional
 
 ## Available Features
 
-- **Filters:** `uj_strip_ads`, `uj_json_escape`, `uj_title_case`, `uj_content_format`, `uj_hash`
+- **Filters:** `uj_strip_ads`, `uj_json_escape`, `uj_title_case`, `uj_content_format`, `uj_hash`, `uj_append_param`, `uj_cachebreak`
 - **Tags:** `iftruthy`, `iffalsy`, `uj_icon`, `uj_logo`, `uj_image`, `uj_member`, `uj_post`, `uj_readtime`, `uj_social`, `uj_translation_url`, `uj_fake_comments`, `uj_language`
 - **Global Variables:** `site.uj.cache_breaker`
 - **Page Variables:** `page.random_id`, `page.extension`, `page.layout_data`, `page.resolved`
@@ -67,3 +67,5 @@ asset_path: blog/post
 ```
 
 Uses `/assets/css/pages/{{ asset_path }}.bundle.css` instead of deriving from `page.canonical.path`. Useful when multiple pages share assets (e.g., all blog posts). See also [docs/layouts-and-pages.md](layouts-and-pages.md).
+
+**⚠️ Only set `asset_path` when sharing a module between pages.** Without it, the loader resolves `<pagePath>/index.js` automatically — that's the correct default for pages whose JS lives at `src/assets/js/pages/<pagePath>/index.js`. Setting `asset_path` overrides this to look for an **exact file** (`<asset_path>.js`), NOT a directory's `index.js`. A wrong `asset_path` fails **silently** — the page renders but the module never loads.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-jekyll-manager",
-  "version": "1.9.8",
+  "version": "1.9.9",
   "description": "Ultimate Jekyll dependency manager",
   "main": "dist/index.js",
   "files": [