Extend urlname getter to substitute wildcard params

The urlname getter is resolving the urlname attribute as before, but it has now the ability to substitute wildcard parameter if the urlname has those.

Author: kulturbande

app/models/alchemy/page/page_naming.rb

@@ -49,6 +49,19 @@ def slug
         wildcard_url&.pattern.presence || urlname.to_s.split("/").last
       end
 
+      # Returns the urlname of the page.
+      # If the page has a wildcard_url, you can pass params to substitute
+      # the wildcards in the urlname: page.urlname(id: 42) # => "products/42"
+      def urlname(**params)
+        value = self[:urlname]
+        return value if params.empty? || !has_wildcard_url?
+
+        params.each do |key, val|
+          value = value.gsub(":#{key}", val.to_s)
+        end
+        value
+      end
+
       def has_wildcard_url?
         wildcard_url&.present?
       end

spec/models/alchemy/page_spec.rb

@@ -1895,6 +1895,25 @@ module Alchemy
             expect(child.urlname).to eq("products/:id/comments")
           end
         end
+
+        it "substitutes wildcards when called with params" do
+          expect(pattern_page.urlname(id: 42)).to eq("products/42")
+        end
+      end
+
+      context "with a multi-segment wildcard_url" do
+        let(:parent) { create(:alchemy_page, name: "Blog") }
+        let(:blog_page) { create(:alchemy_page, parent: parent, name: "Blog Post", page_layout: "blog_post") }
+
+        it "substitutes multiple wildcards when called with params" do
+          expect(blog_page.urlname(year: 2026, slug: "hello-world")).to eq("blog/2026/hello-world")
+        end
+      end
+
+      context "without a wildcard_url" do
+        it "returns the raw urlname even when called with params" do
+          expect(page.urlname(id: 42)).to eq(page.urlname)
+        end
       end
 
       context "if new urlname exists as a legacy url" do