ruby_cms 0.2.0.5 → 0.2.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 747105700c925ba3d9140a015fa477116795644d8a99c52b3aee53c4e786678d
-  data.tar.gz: 8a7bf4cea26c24f7f73f5c6800c6a8dcfb784031a8f313bf2fb7e421fb8bbf31
+  metadata.gz: b2871a67fff389ef55e7c894100dcfbe9b7eeb4ccbec079986d64f6c768c9f87
+  data.tar.gz: 7658b768eed4dbc05b88312e3b25d85ccee84180441d55f91023af3c797be32c
 SHA512:
-  metadata.gz: 78ebfe96b5853ad7ab9698bdc0fca3eaa568f6a02ae691d7ba007c804e4076afe5bde33380d966875f2e24eb72f554d6918408f8fbe04ab80b3644808c11f9ae
-  data.tar.gz: e410f195decbe969b4a873624e440b9331a47081a305bd504eea5a44c0ae90b63e6fe4d0b734fd72a01ea09c471cff7ee7c733eca971525fa9ff0c094b5e0e2c
+  metadata.gz: 25b55ee8d4aa7f9a9ef0b3d861cc1238c1c97b1550703e06336c11df8ac7aa0552bcddf93c90af3dca456ee9149647501c9a37ea71c858181d70f992dd19b33d
+  data.tar.gz: 2d9aa367ab09809bde3781a654b88fa3d7b9c7eed9bf37899977c18ab57d69e7e5695f60db91c0358365a978c228129525055a1653828007178051ab22404760

data/CHANGELOG.md

@@ -1,6 +1,27 @@
 ## [Unreleased]
 
-## [0.2.0.3] - 2026-04-02
+## [0.2.0.8] - 2026-04-09
+
+- Analytics performance: migration adds `ahoy_events (name, time)`, `ahoy_events (visit_id, time)`, `ahoy_visits (started_at)`, `ahoy_visits (visitor_token)` indexes
+- Analytics performance: `compute_new_visitor_percentage` uses subquery instead of plucking all historical visitor tokens into Ruby memory
+- Analytics performance: `exit_pages_data` uses a single DB join-subquery instead of loading all page view rows into Ruby
+
+## [0.2.0.7] - 2026-04-09
+
+- Analytics: add `EVENT_PAGE_VIEW` / `EVENT_CONVERSION` constants for consistent ahoy.track usage
+- Analytics: conversion tracking — `Report` queries `conversion` events and surfaces totals + goal breakdown in dashboard
+- Analytics: exit pages — last `page_view` per visit in selected range, displayed as new dashboard section
+- Analytics: period-over-period comparison — KPI deltas (↑/↓ %) shown on page views, unique visitors, and sessions stat cards
+- Analytics: expanded bot-filtering documentation in install template (`analytics_visit_scope` examples)
+- Analytics: register `analytics_max_exit_pages`, `analytics_max_conversions`, `analytics_max_referrers`, `analytics_max_landing_pages`, `analytics_max_utm_sources` in SettingsRegistry
+- PageTracking: document conversion tracking convention in concern comments
+- Locales: add analytics i18n keys for exit pages, conversions, and period comparison (en + nl)
+
+## [0.2.0.6] - 2026-04-09
+
+- Analytics improvements
+
+## [0.2.0.5] - 2026-04-08
 
 - The host app no longer needs to scan de gem for tailwind
 

data/app/components/ruby_cms/admin/bulk_action_table/bulk_action_table.rb

@@ -128,7 +128,15 @@ module RubyCms
             data: {
               controller: @controller_name,
               "#{@controller_name}-csrf-token-value": csrf_token,
-              "#{@controller_name}-item-name-value": @item_name
+              "#{@controller_name}-item-name-value": @item_name,
+              "#{@controller_name}-processing-label-value": t("ruby_cms.admin.bulk_action_table.processing", default: "Processing..."),
+              "#{@controller_name}-confirm-label-value": t("ruby_cms.admin.bulk_action_table.confirm", default: "Confirm"),
+              "#{@controller_name}-select-at-least-one-message-value": t("ruby_cms.admin.bulk_action_table.select_at_least_one", default: "Please select at least one item."),
+              "#{@controller_name}-item-id-not-found-message-value": t("ruby_cms.admin.bulk_action_table.item_id_not_found", default: "Item ID not found for deletion."),
+              "#{@controller_name}-delete-path-not-found-message-value": t("ruby_cms.admin.bulk_action_table.delete_path_not_found", default: "Delete path not found."),
+              "#{@controller_name}-action-url-not-configured-message-value": t("ruby_cms.admin.bulk_action_table.action_url_not_configured", default: "Action URL not configured. Please configure an action URL for this page."),
+              "#{@controller_name}-default-confirm-message-value": t("ruby_cms.admin.bulk_action_table.default_confirm", default: "Are you sure you want to proceed?"),
+              "#{@controller_name}-generic-action-error-message-value": t("ruby_cms.admin.bulk_action_table.generic_action_error", default: "An error occurred while performing %{action}.")
             }
           }
 

data/app/components/ruby_cms/admin/bulk_action_table/bulk_action_table_actions.rb

@@ -45,8 +45,8 @@ module RubyCms
         def render_edit_button
           link_options = {
             href: @edit_path,
-            class: "inline-flex size-8 items-center justify-center rounded-md text-muted-foreground " \
-                   "hover:bg-muted hover:text-foreground transition-colors"
+            class: "inline-flex size-8 items-center justify-center rounded-md text-blue-600 " \
+                   "hover:bg-blue-50 hover:text-blue-700 transition-colors"
           }
           link_options[:data] = { turbo_frame: @turbo_frame } if @turbo_frame
 
@@ -71,7 +71,7 @@ module RubyCms
           item_id = @item_id || extract_item_id_from_path
           button(
             type: "button",
-            class: "inline-flex size-8 items-center justify-center rounded-md text-muted-foreground " \
+            class: "inline-flex size-8 items-center justify-center rounded-md text-destructive " \
                    "hover:bg-destructive/10 hover:text-destructive transition-colors",
             data: {
               action: "click->#{@controller_name}#showIndividualDeleteDialog",

data/app/components/ruby_cms/admin/bulk_action_table/bulk_action_table_delete_modal.rb

@@ -79,10 +79,10 @@ module RubyCms
             data: {
               action: "click->#{@controller_name}#closeDialog"
             },
-            aria_label: "Close"
+            aria_label: t("ruby_cms.admin.bulk_action_table.close", default: "Close")
           ) do
             render_close_icon
-            span(class: "sr-only") { "Close" }
+            span(class: "sr-only") { t("ruby_cms.admin.bulk_action_table.close", default: "Close") }
           end
         end
 
@@ -123,7 +123,7 @@ module RubyCms
             data: {
               "#{@controller_name}-target": "dialogTitle"
             }
-          ) { "Delete Selected Items" }
+          ) { t("ruby_cms.admin.bulk_action_table.delete_selected_items", default: "Delete Selected Items") }
         end
 
         def render_message
@@ -133,8 +133,8 @@ module RubyCms
               "#{@controller_name}-target": "dialogMessage"
             }
           ) do
-            p { "Are you sure you want to delete the selected items?" }
-            p { "This action cannot be undone." }
+            p { t("ruby_cms.admin.bulk_action_table.are_you_sure_you_want_to_delete_the_selected_items", default: "Are you sure you want to delete the selected items?") }
+            p { t("ruby_cms.admin.bulk_action_table.this_action_cannot_be_undone", default: "This action cannot be undone.") }
           end
         end
 
@@ -154,19 +154,19 @@ module RubyCms
             data: {
               action: "click->#{@controller_name}#closeDialog"
             }
-          ) { "Cancel" }
+          ) { t("ruby_cms.admin.bulk_action_table.cancel", default: "Cancel") }
         end
 
         def render_confirm_button
           button(
             type: "button",
             class: "inline-flex h-9 items-center justify-center rounded-md bg-destructive px-4 " \
-                   "text-sm font-medium text-destructive-foreground shadow-sm hover:bg-destructive/90 transition-colors",
+                   "text-sm font-medium text-white font-bold shadow-sm hover:bg-destructive/90 transition-colors",
             data: {
               "#{@controller_name}-target": "dialogConfirmButton",
               action: "click->#{@controller_name}#confirmAction"
             }
-          ) { "Delete Selected" }
+          ) { t("ruby_cms.admin.bulk_action_table.delete_selected", default: "Delete Selected") }
         end
       end
     end

data/app/components/ruby_cms/admin/bulk_action_table/bulk_action_table_header_bar.rb

@@ -32,9 +32,9 @@ module RubyCms
 
         def view_template
           div(class: "px-5 py-3 border-b border-border/60 bg-white") do
-            div(class: "flex flex-wrap items-center justify-between gap-4") do
+            div(class: "flex items-center justify-between gap-3") do
               render_title_group if @title.present?
-              div(class: "flex items-center gap-2 flex-wrap") do
+              div(class: "ml-auto flex items-center gap-2 overflow-x-auto whitespace-nowrap") do
                 render_header_filter if @header_filter.present?
                 render_action_icons
                 render_search_form
@@ -75,9 +75,15 @@ module RubyCms
           form_options = {
             url: @search_url,
             method: :get,
-            class: "w-full sm:w-auto"
+            class: "w-full sm:w-auto",
+            data: { "#{default_controller_name}-target": "searchForm" }
           }
           form_options[:data] = { turbo_frame: @turbo_frame } if @turbo_frame.present?
+          if @turbo_frame.present?
+            form_options[:data] = form_options[:data].merge(
+              "#{default_controller_name}-target": "searchForm"
+            )
+          end
 
           form_with(**form_options) do
             div(class: "relative flex items-center") do
@@ -106,10 +112,10 @@ module RubyCms
             type: "search",
             name: @search_param,
             placeholder: "Search",
-            class: "h-9 w-full sm:w-72 rounded-md border border-border bg-white pl-9 " \
+            class: "h-9 w-64 sm:w-72 rounded-md border border-border bg-white pl-9 " \
                    "pr-3 text-sm shadow-sm focus:outline-none focus:ring-2 focus:ring-primary/20",
             value: search_value,
-            data: { action: "input->turbo-frame#submit" }
+            data: { action: "input->#{default_controller_name}#autoSearch" }
           )
         end
 
@@ -153,6 +159,10 @@ module RubyCms
                    d: icon_path)
           end
         end
+
+        def default_controller_name
+          "ruby-cms--bulk-action-table"
+        end
       end
     end
   end

data/app/components/ruby_cms/admin/bulk_action_table/bulk_actions.rb

@@ -51,7 +51,9 @@ module RubyCms
         def render_selection_left
           div(class: "flex items-center gap-2") do
             render_selected_count_badge
-            span(class: "text-sm font-medium text-foreground") { "selected" }
+            span(class: "text-sm font-medium text-foreground") do
+              t("ruby_cms.admin.bulk_action_table.selected", default: "selected")
+            end
           end
         end
 
@@ -74,7 +76,7 @@ module RubyCms
               "#{@controller_name}-target": "selectAllButton",
               action: "click->#{@controller_name}#selectAll"
             }
-          ) { "Select all" }
+          ) { t("ruby_cms.admin.bulk_action_table.select_all", default: "Select all") }
 
           button(
             type: "button",
@@ -82,7 +84,7 @@ module RubyCms
             data: {
               action: "click->#{@controller_name}#clearSelection"
             }
-          ) { "Clear" }
+          ) { t("ruby_cms.admin.bulk_action_table.clear", default: "Clear") }
         end
 
         def render_action_buttons
@@ -98,19 +100,24 @@ module RubyCms
         def render_custom_action_button(config)
           label = config[:label] || config[:text] || config[:name]&.humanize || "Button"
           action_name = config[:name] || config[:action_name]
+          icon_path = resolve_icon_path(config, action_name)
 
           button(
             type: "button",
             class: build_button_class(config),
             data: build_button_data_attrs(config, label, action_name)
-          ) { label }
+          ) do
+            render_button_icon(icon_path)
+            span { label }
+          end
         end
 
         def build_button_class(config)
-          base = "inline-flex items-center justify-center rounded-md border border-border " \
-                 "bg-white px-3 py-1.5 text-sm font-medium text-foreground shadow-sm " \
+          color_class = resolve_button_color_class(config)
+          base = "inline-flex items-center justify-center gap-1.5 rounded-md border border-border " \
+                 "bg-white px-3 py-1.5 text-sm font-medium shadow-sm " \
                  "hover:bg-muted transition-colors"
-          config[:class].present? ? "#{base} #{config[:class]}" : base
+          [base, color_class, config[:class]].compact.join(" ")
         end
 
         def build_button_data_attrs(config, label, action_name)
@@ -132,18 +139,56 @@ module RubyCms
         def render_delete_button
           button(
             type: "button",
-            class: "inline-flex items-center justify-center rounded-md border border-destructive/30 " \
+            class: "inline-flex items-center justify-center gap-1.5 rounded-md border border-destructive/30 " \
                    "bg-white px-3 py-1.5 text-sm font-medium text-destructive shadow-sm " \
                    "hover:bg-destructive/10 transition-colors",
             data: {
               action: "click->#{@controller_name}#showActionDialog",
               action_name: "delete",
-              action_label: "Delete Selected",
-              action_confirm: "Are you sure you want to delete the selected \
-               items? This action cannot be undone.",
+              action_label: t("ruby_cms.admin.bulk_action_table.delete_selected", default: "Delete Selected"),
+              action_confirm: t("ruby_cms.admin.bulk_action_table.delete_selected_confirm", default: "Are you sure you want to delete the selected items? This action cannot be undone."),
               action_url: @bulk_actions_url&.to_s
             }
-          ) { "Delete Selected" }
+          ) do
+            render_button_icon("M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16")
+            span { t("ruby_cms.admin.bulk_action_table.delete_selected", default: "Delete Selected") }
+          end
+        end
+
+        def render_button_icon(path_d)
+          svg(class: "h-3.5 w-3.5", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24") do |s|
+            s.path(stroke_linecap: "round", stroke_linejoin: "round", stroke_width: "2", d: path_d)
+          end
+        end
+
+        def resolve_button_color_class(config)
+          color = (config[:color] || config[:tone] || config[:variant]).to_s
+          return "text-foreground" if color.blank?
+
+          {
+            "blue" => "text-blue-700 border-blue-200 hover:bg-blue-50",
+            "green" => "text-emerald-700 border-emerald-200 hover:bg-emerald-50",
+            "emerald" => "text-emerald-700 border-emerald-200 hover:bg-emerald-50",
+            "orange" => "text-amber-700 border-amber-200 hover:bg-amber-50",
+            "amber" => "text-amber-700 border-amber-200 hover:bg-amber-50",
+            "red" => "text-destructive border-destructive/30 hover:bg-destructive/10",
+            "purple" => "text-violet-700 border-violet-200 hover:bg-violet-50"
+          }.fetch(color, "text-foreground")
+        end
+
+        def resolve_icon_path(config, action_name)
+          return config[:icon] if config[:icon].present?
+
+          case action_name.to_s
+          when "publish"
+            "M5 13l4 4L19 7"
+          when "unpublish"
+            "M6 18L18 6M6 6l12 12"
+          when "archive"
+            "M20 7l-1 12H5L4 7m16 0H4m3-3h10l1 3H6l1-3z"
+          else
+            "M12 4v16m8-8H4"
+          end
         end
       end
     end

data/app/controllers/concerns/ruby_cms/page_tracking.rb

@@ -12,6 +12,21 @@ module RubyCms
   # Sets @page_name to controller_name by default. Override in actions:
   #   @page_name = "custom_page_name"
   #
+  # Event naming conventions (keep property keys consistent across the app):
+  #   Page views (tracked automatically):
+  #     ahoy.track RubyCms::Analytics::Report::EVENT_PAGE_VIEW,
+  #                page_name: "home", request_path: request.path
+  #
+  #   Conversions (tracked by host app controllers/forms):
+  #     ahoy.track RubyCms::Analytics::Report::EVENT_CONVERSION,
+  #                goal: "contact_form", path: request.path
+  #     ahoy.track RubyCms::Analytics::Report::EVENT_CONVERSION,
+  #                goal: "newsletter_signup", path: request.path
+  #
+  # Convention for property keys:
+  #   page_view:  page_name (String), request_path (String)
+  #   conversion: goal (String, required), path (String, optional)
+  #
   module PageTracking
     extend ActiveSupport::Concern
 

data/app/controllers/ruby_cms/admin/analytics_controller.rb

@@ -17,6 +17,7 @@ module RubyCms
         )
         @stats = report.dashboard_stats
         @stats.each {|key, value| instance_variable_set(:"@#{key}", value) }
+        @active_users = active_users_count
       end
 
       def page_details
@@ -73,6 +74,17 @@ module RubyCms
                     alert: "Invalid date range. Maximum range is #{max_days} days."
       end
 
+      def active_users_count
+        Ahoy::Event
+          .where(name: RubyCms::Analytics::Report::EVENT_PAGE_VIEW)
+          .where(time: 5.minutes.ago..)
+          .joins(:visit)
+          .distinct
+          .count(:visitor_token)
+      rescue StandardError
+        nil
+      end
+
       def sanitize_period(value)
         %w[day week month year].include?(value.to_s) ? value.to_s : nil
       end

data/app/controllers/ruby_cms/admin/commands_controller.rb

@@ -34,7 +34,7 @@ module RubyCms
 
         respond_to do |format|
           format.html do
-            token = persist_run_payload_for_redirect(output: output, log_tail: log_tail)
+            token = persist_run_payload_for_redirect(output:, log_tail:)
             redirect_to ruby_cms_admin_settings_commands_path,
                         status: :see_other,
                         flash: { FLASH_RUN => token }
@@ -55,14 +55,14 @@ module RubyCms
                         status: :see_other,
                         flash: { FLASH_RUN => token }
           end
-          format.json { render json: { error: e.message }, status: :unprocessable_entity }
+          format.json { render json: { error: e.message }, status: :unprocessable_content }
         end
       end
 
       private
 
       def persist_run_payload_for_redirect(output: nil, log_tail: nil, error: nil)
-        payload = { output: output, log_tail: log_tail, error: error }.compact
+        payload = { output:, log_tail:, error: }.compact
         token = SecureRandom.urlsafe_base64(32)
         if rails_cache_null_store?
           session[session_run_key(token)] = payload
@@ -77,7 +77,7 @@ module RubyCms
         return if token.blank?
 
         payload = load_run_payload(token)
-        assign_run_ivars_from_payload(payload) if payload.is_a?(Hash)
+        assign_run_ivars_from_payload(payload) if payload.kind_of?(Hash)
       end
 
       def load_run_payload(token)
@@ -99,7 +99,7 @@ module RubyCms
       end
 
       def rails_cache_null_store?
-        Rails.cache.is_a?(ActiveSupport::Cache::NullStore)
+        Rails.cache.kind_of?(ActiveSupport::Cache::NullStore)
       end
 
       def session_run_key(token)
@@ -115,7 +115,7 @@ module RubyCms
 
       def visible_commands
         RubyCms.registered_commands.select {|c| current_user_cms&.can?(c[:permission]) }
-                              .sort_by {|c| [ c[:label].to_s.downcase, c[:key] ] }
+                                   .sort_by {|c| [c[:label].to_s.downcase, c[:key]] }
       end
     end
   end

data/app/javascript/controllers/ruby_cms/bulk_action_table_controller.js

@@ -13,11 +13,38 @@ export default class extends Controller {
     "dialogContent",
     "dialogTitle",
     "dialogMessage",
+    "searchForm",
   ];
   static values = {
     csrfToken: String,
     bulkActionUrl: String,
     itemName: { type: String, default: "item" },
+    processingLabel: { type: String, default: "Processing..." },
+    confirmLabel: { type: String, default: "Confirm" },
+    selectAtLeastOneMessage: {
+      type: String,
+      default: "Please select at least one item.",
+    },
+    itemIdNotFoundMessage: {
+      type: String,
+      default: "Item ID not found for deletion.",
+    },
+    deletePathNotFoundMessage: {
+      type: String,
+      default: "Delete path not found.",
+    },
+    actionUrlNotConfiguredMessage: {
+      type: String,
+      default: "Action URL not configured. Please configure an action URL for this page.",
+    },
+    defaultConfirmMessage: {
+      type: String,
+      default: "Are you sure you want to proceed?",
+    },
+    genericActionErrorMessage: {
+      type: String,
+      default: "An error occurred while performing %{action}.",
+    },
   };
 
   connect() {
@@ -35,12 +62,29 @@ export default class extends Controller {
     // Handle ESC key to close dialog
     this.boundHandleKeydown = this.handleKeydown.bind(this);
     document.addEventListener("keydown", this.boundHandleKeydown);
+    this.searchDebounceTimer = null;
   }
 
   disconnect() {
     if (this.boundHandleKeydown) {
       document.removeEventListener("keydown", this.boundHandleKeydown);
     }
+    if (this.searchDebounceTimer) {
+      clearTimeout(this.searchDebounceTimer);
+      this.searchDebounceTimer = null;
+    }
+  }
+
+  autoSearch() {
+    if (!this.hasSearchFormTarget) return;
+
+    if (this.searchDebounceTimer) {
+      clearTimeout(this.searchDebounceTimer);
+    }
+
+    this.searchDebounceTimer = setTimeout(() => {
+      this.searchFormTarget.requestSubmit();
+    }, 250);
   }
 
   handleKeydown(event) {
@@ -182,7 +226,7 @@ export default class extends Controller {
   showActionDialog(event) {
     const count = this.getSelectedIds().length;
     if (count === 0) {
-      this.showNotification("Please select at least one item.", "error");
+      this.showNotification(this.selectAtLeastOneMessageValue, "error");
       return;
     }
 
@@ -245,13 +289,13 @@ export default class extends Controller {
     if (actionName === "delete") {
       return "Are you sure you want to delete the selected items? This action cannot be undone.";
     }
-    return "Are you sure you want to proceed?";
+    return this.defaultConfirmMessageValue;
   }
 
   redirectToBulkAction(url, actionName) {
     const selectedIds = this.getSelectedIds();
     if (selectedIds.length === 0) {
-      this.showNotification("Please select at least one item.", "error");
+      this.showNotification(this.selectAtLeastOneMessageValue, "error");
       return;
     }
 
@@ -266,9 +310,8 @@ export default class extends Controller {
   }
 
   showDialog() {
-    const label = this.currentActionLabel || "Confirm";
-    const message =
-      this.currentActionConfirm || "Are you sure you want to proceed?";
+    const label = this.currentActionLabel || this.confirmLabelValue;
+    const message = this.currentActionConfirm || this.defaultConfirmMessageValue;
 
     if (this.hasDialogTitleTarget) {
       this.dialogTitleTarget.textContent = label;
@@ -353,7 +396,7 @@ export default class extends Controller {
         event.params.itemId || event.params.rubyCmsBulkActionTableItemIdParam;
 
       if (!itemId) {
-        this.showNotification("Item ID not found for deletion.", "error");
+        this.showNotification(this.itemIdNotFoundMessageValue, "error");
         return;
       }
 
@@ -371,7 +414,7 @@ export default class extends Controller {
           this.getFallbackPath(this.itemNameValue, itemId);
 
         if (!deletePath) {
-          this.showNotification("Delete path not found.", "error");
+          this.showNotification(this.deletePathNotFoundMessageValue, "error");
           return;
         }
 
@@ -424,7 +467,7 @@ export default class extends Controller {
 
     if (this.hasDialogConfirmButtonTarget) {
       this.dialogConfirmButtonTarget.disabled = true;
-      this.dialogConfirmButtonTarget.textContent = "Processing...";
+      this.dialogConfirmButtonTarget.textContent = this.processingLabelValue;
     }
 
     try {
@@ -464,7 +507,7 @@ export default class extends Controller {
     const selectedIds = itemIds || this.getSelectedIds();
 
     if (selectedIds.length === 0) {
-      this.showNotification("Please select at least one item.", "error");
+      this.showNotification(this.selectAtLeastOneMessageValue, "error");
       return;
     }
 
@@ -483,7 +526,7 @@ export default class extends Controller {
 
     if (!actionUrl) {
       this.showNotification(
-        "Action URL not configured. Please configure an action URL for this page.",
+        this.actionUrlNotConfiguredMessageValue,
         "error",
       );
       return;
@@ -522,7 +565,10 @@ export default class extends Controller {
         }
       } else {
         const contentType = response.headers.get("content-type");
-        let errorMessage = `An error occurred while performing ${action}.`;
+        let errorMessage = this.interpolateActionMessage(
+          this.genericActionErrorMessageValue,
+          action,
+        );
 
         if (contentType && contentType.includes("application/json")) {
           try {
@@ -547,12 +593,18 @@ export default class extends Controller {
     } catch (error) {
       console.error(`Error performing bulk action ${action}:`, error);
       this.showNotification(
-        `An error occurred while performing ${action}.`,
+        this.interpolateActionMessage(this.genericActionErrorMessageValue, action),
         "error",
       );
     }
   }
 
+  interpolateActionMessage(template, action) {
+    const normalizedTemplate =
+      template || "An error occurred while performing %{action}.";
+    return normalizedTemplate.replace("%{action}", action || "action");
+  }
+
   showNotification(message, type = "info") {
     const toast = document.createElement("div");
     const colorMap = {