jekyll-uj-powertools 1.7.11 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b58316def5bdf1f88a2feb03a14b4c2857e5530eead4f39d246068fbf474cf94
-  data.tar.gz: 0ef67cae823576783e197c3557d798420dc341784d3199d7ad8ec8a285f3cf29
+  metadata.gz: 9b1097837273bf9312cb1843a4ab7d21c2f39e77cb46fe17278e537187169ac8
+  data.tar.gz: b8cb6c1887db39036e2bbfda9a8202ae84a3757b274f2d15816f49c2f4876586
 SHA512:
-  metadata.gz: 0e7beb32662dc8dadb479c3f06a17b3c48f930dc09c1bf16a7bf56c826f41fdd1f96ab091b8a849a50aa0706eebeced5b11e91ebe139fd105f517a951eff6d3c
-  data.tar.gz: 0b16685b292e37358bfa76721a71778a7b1a629ee6d03a94083aa0db5fae6b48044e89620c48741f2bea17073ccb3e6228b545084e944f908ab509bd391040e4
+  metadata.gz: 4c1331d50ce020eae288af9f6b44f660c12a993896a23feaf07759a2b5e9a651ad0dd05978fc87822e80451a7b3c26b998b4c206518726ff39532d3cb28513f2
+  data.tar.gz: 0e5d3c60d82d22ca51d99c05174a8518c0fd84864a14f279376e629d4a757a9fd4386f646b9d1ffce0dd4828672459ab800a93a17fad338817c9f499aee9154c

data/README.md

@@ -106,6 +106,28 @@ Format numbers with commas for better readability (e.g., 10000 becomes 10,000).
 <!-- Output: 1,234.56 -->
 ```
 
+### `uj_append_param` Filter
+Intelligently append a query parameter to a URL, using `?` or `&` depending on whether the URL already has a query string.
+
+```liquid
+{{ "https://example.com/img.png" | uj_append_param: "cb", "123" }}
+<!-- Output: https://example.com/img.png?cb=123 -->
+
+{{ "https://example.com/img.png?w=200" | uj_append_param: "cb", "123" }}
+<!-- Output: https://example.com/img.png?w=200&cb=123 -->
+```
+
+### `uj_cachebreak` Filter
+Append a cache-busting query parameter (`cb=<timestamp>`) to any URL. Uses the same consistent timestamp as `site.uj.cache_breaker`. Handles URLs with or without existing query strings.
+
+```liquid
+{{ site.brand.images.brandmark | uj_cachebreak }}
+<!-- Output: https://cdn.example.com/logo.svg?cb=1234567890 -->
+
+{{ "/assets/css/main.bundle.css" | uj_cachebreak }}
+<!-- Output: /assets/css/main.bundle.css?cb=1234567890 -->
+```
+
 ### `uj_content_format` Filter
 Process content with Liquid templating and Markdown conversion, automatically transforming markdown and liquid into HTML intelligently based on the file type.
 

data/jekyll-uj-powertools.gemspec

@@ -5,7 +5,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 Gem::Specification.new do |spec|
   # Gem info
   spec.name = "jekyll-uj-powertools"
-  spec.version = "1.7.11"
+  spec.version = "1.8.0"
 
   # Author info
   spec.authors = ["ITW Creative Works"]

data/lib/filters/main.rb

@@ -149,6 +149,25 @@ module Jekyll
       JSON.pretty_generate(input, indent: indent_string)
     end
 
+    # Append a query parameter to a URL, handling existing query strings
+    # Usage: {{ "https://example.com/img.png" | uj_append_param: "cb", "123" }}
+    #   => "https://example.com/img.png?cb=123"
+    # Usage: {{ "https://example.com/img.png?w=200" | uj_append_param: "cb", "123" }}
+    #   => "https://example.com/img.png?w=200&cb=123"
+    def uj_append_param(input, key, value)
+      return input if input.nil? || input.to_s.strip.empty?
+      url = input.to_s.strip
+      sep = url.include?('?') ? '&' : '?'
+      "#{url}#{sep}#{key}=#{value}"
+    end
+
+    # Append a cache-busting query parameter to a URL
+    # Usage: {{ "https://example.com/img.png" | uj_cachebreak }}
+    #   => "https://example.com/img.png?cb=1234567890"
+    def uj_cachebreak(input)
+      uj_append_param(input, 'cb', UJPowertools.cache_timestamp)
+    end
+
     # Pluralize a word based on a count
     # Usage: {{ count | uj_pluralize: 'singular', 'plural' }}
     # Example: {{ 5 | uj_pluralize: 'post', 'posts' }} => 'posts'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-uj-powertools
 version: !ruby/object:Gem::Version
-  version: 1.7.11
+  version: 1.8.0
 platform: ruby
 authors:
 - ITW Creative Works
@@ -226,7 +226,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 4.0.3
 specification_version: 4
 summary: A powerful set of utilities for Jekyll
 test_files: []