ruby_cms 0.2.0.1 → 0.2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f997170922c55751d5a99a10253efbeaa4cc8c7f82ffa18e7083b5a932cacc26
-  data.tar.gz: 179a045dd39b70960801f6b3901e218bc4103ffd767dbc48202d9722c2467d67
+  metadata.gz: 6cb6a4534aa479ff1d6b82351e60cc965d544aa7770e28a8e97502ab03596874
+  data.tar.gz: 1d149a75c0e04968cfc49608e3224ed188d49fbe4ab127dbc0184ebad88d64b3
 SHA512:
-  metadata.gz: aa897c7d17c24754544357dea2d82797506f11623a4125fc1ca49653f9daa21aeed9e97c703016efee4a8003a64b8ee4f4060bedcbe25977b80c83268f633f62
-  data.tar.gz: 7245bb0f650775224383ac1d4588241fe5f084713525a13003706ce27acc25dff00a6dd485cefb816b7faec02a4f03d66c89f3528a7ab39ee9feca9925205687
+  metadata.gz: 3bbca13f42f1062a96839fb2e378c3a63c94f44c27cec43e23db091bee4c40e252077f78f9b827e70317f58ecfe5740f4f304720585173b938cf302fda92649c
+  data.tar.gz: 2424fda47001767955be5fc4d9809e5f0f56dffedc096ac8b67583e2a29b4c76a7401bb2b82f9867784a5545bc2c2987862f429c419caaff7dac3e8e57154c72

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.0.2] - 2026-04-02
+
+- Add commands page
+
 ## [0.2.0.1] - 2026-04-02
 
 - Fix compile

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

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+module RubyCms
+  module Admin
+    class CommandsController < BaseController
+      cms_page :commands
+
+      # HTML: POST/redirect/GET — URL blijft /settings/commands (geen /run in de adresbalk).
+      RUN_CACHE_PREFIX = "ruby_cms/commands/run/v1/"
+      FLASH_RUN = :ruby_cms_commands_run
+
+      def index
+        @commands = visible_commands
+        consume_run_payload_from_flash
+      end
+
+      def run
+        key = params.permit(:key)[:key].presence || params.dig(:command, :key)
+        cmd = RubyCms.find_command(key)
+        unless cmd
+          return respond_to do |format|
+            format.html do
+              redirect_to ruby_cms_admin_settings_commands_path,
+                          alert: t("ruby_cms.admin.commands.unknown", default: "Unknown command.")
+            end
+            format.json { render json: { error: "Unknown command" }, status: :not_found }
+          end
+        end
+
+        require_permission!(cmd[:permission])
+
+        output = utf8_text(RubyCms::CommandRunner.run_rake(cmd[:rake_task]))
+        log_tail = utf8_text(RubyCms::CommandRunner.tail_log)
+
+        respond_to do |format|
+          format.html do
+            token = persist_run_payload_for_redirect(output: output, log_tail: log_tail)
+            redirect_to ruby_cms_admin_settings_commands_path,
+                        status: :see_other,
+                        flash: { FLASH_RUN => token }
+          end
+          format.json do
+            render json: {
+              command_output: output,
+              app_log_tail: log_tail
+            }
+          end
+        end
+      rescue StandardError => e
+        Rails.logger.error("[RubyCMS] Commands#run: #{e.class}: #{e.message}")
+        respond_to do |format|
+          format.html do
+            token = persist_run_payload_for_redirect(error: utf8_text(e.message))
+            redirect_to ruby_cms_admin_settings_commands_path,
+                        status: :see_other,
+                        flash: { FLASH_RUN => token }
+          end
+          format.json { render json: { error: e.message }, status: :unprocessable_entity }
+        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
+        token = SecureRandom.urlsafe_base64(32)
+        if rails_cache_null_store?
+          session[session_run_key(token)] = payload
+        else
+          Rails.cache.write("#{RUN_CACHE_PREFIX}#{token}", payload, expires_in: 15.minutes)
+        end
+        token
+      end
+
+      def consume_run_payload_from_flash
+        token = flash[FLASH_RUN]
+        return if token.blank?
+
+        payload = load_run_payload(token)
+        assign_run_ivars_from_payload(payload) if payload.is_a?(Hash)
+      end
+
+      def load_run_payload(token)
+        if rails_cache_null_store?
+          session.delete(session_run_key(token))
+        else
+          key = "#{RUN_CACHE_PREFIX}#{token}"
+          data = Rails.cache.read(key)
+          Rails.cache.delete(key) if data
+          data
+        end
+      end
+
+      def assign_run_ivars_from_payload(payload)
+        p = payload.with_indifferent_access
+        @run_error = utf8_text(p[:error]) if p[:error].present?
+        @run_command_output = utf8_text(p[:output]) if p.key?(:output)
+        @run_app_log_tail = utf8_text(p[:log_tail]) if p.key?(:log_tail)
+      end
+
+      def rails_cache_null_store?
+        Rails.cache.is_a?(ActiveSupport::Cache::NullStore)
+      end
+
+      def session_run_key(token)
+        "#{RUN_CACHE_PREFIX}#{token}"
+      end
+
+      # Rake / log IO is often ASCII-8BIT; ERB buffers are UTF-8 — normalize before render/JSON.
+      def utf8_text(value)
+        return +"" if value.nil?
+
+        value.to_s.encode(Encoding::UTF_8, invalid: :replace, undef: :replace, replace: "?")
+      end
+
+      def visible_commands
+        RubyCms.registered_commands.select {|c| current_user_cms&.can?(c[:permission]) }
+                              .sort_by {|c| [ c[:label].to_s.downcase, c[:key] ] }
+      end
+    end
+  end
+end

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

@@ -0,0 +1,72 @@
+import { Controller } from "@hotwired/stimulus";
+
+export default class extends Controller {
+  static targets = ["commandOutput", "appLog"];
+  static values = { runUrl: String };
+
+  async run(event) {
+    const key =
+      event.currentTarget?.dataset?.commandKey || event.params?.key;
+    const runUrl = this.runUrlValue?.trim?.() || this.runUrlValue;
+
+    if (!key || !runUrl) {
+      const msg =
+        !runUrl
+          ? "Missing run URL (check data-ruby-cms--admin-commands-run-url-value)."
+          : "Missing command key on the button.";
+      if (this.hasCommandOutputTarget) {
+        this.commandOutputTarget.textContent = msg;
+      } else {
+        console.error("[ruby-cms--admin-commands]", msg);
+      }
+      return;
+    }
+
+    const token = document.querySelector('meta[name="csrf-token"]')?.content;
+    const button = event.currentTarget;
+    button.disabled = true;
+
+    if (this.hasCommandOutputTarget) {
+      this.commandOutputTarget.textContent = "Running…";
+    }
+    if (this.hasAppLogTarget) {
+      this.appLogTarget.textContent = "…";
+    }
+
+    try {
+      const response = await fetch(runUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json",
+          "X-CSRF-Token": token || "",
+        },
+        body: JSON.stringify({ key }),
+      });
+
+      const data = await response.json().catch(() => ({}));
+
+      if (!response.ok) {
+        const err = data.error || `Request failed (${response.status})`;
+        if (this.hasCommandOutputTarget) {
+          this.commandOutputTarget.textContent = err;
+        }
+        return;
+      }
+
+      if (this.hasCommandOutputTarget) {
+        this.commandOutputTarget.textContent =
+          data.command_output || "(no output)";
+      }
+      if (this.hasAppLogTarget) {
+        this.appLogTarget.textContent = data.app_log_tail || "(no log lines)";
+      }
+    } catch (e) {
+      if (this.hasCommandOutputTarget) {
+        this.commandOutputTarget.textContent = e?.message || String(e);
+      }
+    } finally {
+      button.disabled = false;
+    }
+  }
+}

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

@@ -12,6 +12,7 @@ import ClickableRowController from "ruby_cms/clickable_row_controller";
 import AutoSavePreferenceController from "ruby_cms/auto_save_preference_controller";
 import NavOrderSortableController from "ruby_cms/nav_order_sortable_controller";
 import ContentBlockHistoryController from "ruby_cms/content_block_history_controller";
+import AdminCommandsController from "ruby_cms/admin_commands_controller";
 
 
 export {
@@ -26,10 +27,16 @@ export {
   AutoSavePreferenceController,
   NavOrderSortableController,
   ContentBlockHistoryController,
+  AdminCommandsController,
 };
 
 // Helper function to register all RubyCms controllers with a Stimulus application
+const registeredApplications = new WeakSet();
+
 export function registerRubyCmsControllers(application) {
+  if (!application || typeof application.register !== "function") return;
+  if (registeredApplications.has(application)) return;
+
   application.register("ruby-cms--visual-editor", VisualEditorController);
   application.register("ruby-cms--page-preview", PagePreviewController);
   application.register("ruby-cms--mobile-menu", MobileMenuController);
@@ -41,6 +48,7 @@ export function registerRubyCmsControllers(application) {
   application.register("ruby-cms--toggle", ToggleController);
   application.register("ruby-cms--locale-tabs", LocaleTabsController);
   application.register("ruby-cms--content-block-history", ContentBlockHistoryController);
+  application.register("ruby-cms--admin-commands", AdminCommandsController);
   application.register("clickable-row", ClickableRowController);
   application.register(
     "ruby-cms--auto-save-preference",
@@ -50,6 +58,8 @@ export function registerRubyCmsControllers(application) {
     "ruby-cms--nav-order-sortable",
     NavOrderSortableController,
   );
+
+  registeredApplications.add(application);
 }
 
 // Auto-register controllers when this module is imported

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

@@ -1,7 +1,19 @@
 import { Controller } from "@hotwired/stimulus";
 
 export default class extends Controller {
-  static targets = ["tab"];
+  static targets = ["tab", "localeLabel"];
+
+  connect() {
+    const activeTab = this.tabTargets.find(
+      (t) => t.getAttribute("aria-selected") === "true"
+    );
+    if (!activeTab) return;
+
+    this.tabTargets.forEach((t) => {
+      this.setTabState(t, t === activeTab);
+    });
+    this.syncLocaleLabel(activeTab);
+  }
 
   switchTab(event) {
     const tab = event.currentTarget;
@@ -25,6 +37,7 @@ export default class extends Controller {
 
     // Highlight selected tab
     this.setTabState(tab, true);
+    this.syncLocaleLabel(tab);
   }
 
   findPanel(panelId) {
@@ -47,6 +60,13 @@ export default class extends Controller {
     tab.setAttribute("aria-selected", isActive ? "true" : "false");
   }
 
+  syncLocaleLabel(tab) {
+    if (!this.hasLocaleLabelTarget) return;
+
+    const label = tab.dataset.localeLabel;
+    if (label) this.localeLabelTarget.textContent = label;
+  }
+
   splitClasses(classListString) {
     return (classListString || "")
       .split(" ")

data/app/services/ruby_cms/command_runner.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module RubyCms
+  # Runs whitelisted Rake tasks and reads log tails for the admin Commands UI.
+  class CommandRunner
+    class << self
+      def run_rake(task)
+        raise ArgumentError, "rake task blank" if task.to_s.strip.blank?
+
+        env = { "RAILS_ENV" => Rails.env.to_s }
+        argv = [ "bundle", "exec", "rake", task.to_s ]
+        stdout_and_stderr, status = Open3.capture2e(env, *argv, chdir: Rails.root.to_s)
+        <<~TEXT.strip
+          $ #{argv.join(" ")}
+          (exit #{status.exitstatus})
+
+          #{stdout_and_stderr}
+        TEXT
+      rescue Errno::ENOENT => e
+        <<~TEXT.strip
+          Failed to run command: #{e.message}
+        TEXT
+      end
+
+      def tail_log(lines: 400, max_bytes: 512 * 1024)
+        path = Rails.root.join("log", "#{Rails.env}.log")
+        return "(Log file not found: #{path})" unless path.file?
+
+        File.open(path, "rb") do |f|
+          size = f.size
+          f.seek([ 0, size - max_bytes ].max)
+          chunk = f.read
+          chunk.lines.last(lines.to_i.clamp(1, 10_000)).join
+        end
+      rescue StandardError => e
+        "(Could not read log: #{e.message})"
+      end
+    end
+  end
+end

data/app/views/ruby_cms/admin/commands/index.html.erb

@@ -0,0 +1,104 @@
+<%= render RubyCms::Admin::AdminPageHeader.new(
+  title: t("ruby_cms.admin.commands.title", default: "Commands"),
+  subtitle: t("ruby_cms.admin.commands.subtitle", default: "Run registered Rake tasks from the host app. Output and recent log lines appear on the right."),
+  breadcrumbs: [
+    { label: t("ruby_cms.admin.breadcrumb.admin", default: "Admin"), url: ruby_cms_admin_root_path },
+    { label: t("ruby_cms.admin.commands.title", default: "Commands") }
+  ]
+) %>
+
+<div class="flex min-h-0 flex-col gap-4">
+  <% if @run_error.present? %>
+    <div class="w-full shrink-0 rounded-xl border border-destructive/40 bg-destructive/10 px-4 py-3 text-sm text-destructive">
+      <%= h(@run_error) %>
+    </div>
+  <% end %>
+
+  <%#
+    md+: 3-koloms grid — links 1/3 (commando's), rechts 2/3 (output + log).
+    Klein scherm: één kolom, eerst commando's, daaronder resultaat.
+  %>
+  <div
+    class="grid min-h-0 w-full min-w-0 grid-cols-1 gap-4 md:grid-cols-3 md:gap-6 md:items-stretch md:min-h-[min(32rem,calc(100dvh-14rem))] md:max-h-[min(90vh,calc(100dvh-12rem))] md:overflow-hidden"
+    dir="ltr"
+  >
+    <%# Links: 1/3 — beschikbare commando's %>
+    <aside
+      class="flex min-h-[16rem] w-full min-w-0 flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-sm ring-1 ring-black/[0.03] md:col-span-1 md:row-start-1 md:h-full md:min-h-0"
+    >
+      <div class="shrink-0 border-b border-border/80 px-4 py-3">
+        <h2 class="text-sm font-semibold leading-tight tracking-tight text-foreground">
+          <%= t("ruby_cms.admin.commands.available", default: "Available commands") %>
+        </h2>
+        <p class="mt-1 text-xs leading-snug text-muted-foreground">
+          <%= t("ruby_cms.admin.commands.hint", default: "Commands are registered in the host app initializer (RubyCms.register_command).") %>
+        </p>
+      </div>
+      <div class="min-h-0 flex-1 overflow-y-auto overscroll-contain p-4">
+        <% if @commands.any? %>
+          <div class="flex flex-col gap-3">
+            <% @commands.each do |cmd| %>
+              <div class="rounded-xl border border-border/60 bg-muted/20 p-3">
+                <div class="flex flex-col gap-2">
+                  <div class="min-w-0">
+                    <p class="text-sm font-medium leading-snug text-foreground"><%= cmd[:label] %></p>
+                    <% if cmd[:description].present? %>
+                      <p class="mt-1 text-xs leading-snug text-muted-foreground"><%= cmd[:description] %></p>
+                    <% end %>
+                    <p class="mt-2 break-all font-mono text-[10px] leading-tight text-muted-foreground">
+                      rake <%= cmd[:rake_task] %>
+                    </p>
+                  </div>
+                  <%= button_to t("ruby_cms.admin.commands.run", default: "Run"),
+                      ruby_cms_admin_settings_commands_run_path,
+                      method: :post,
+                      params: { key: cmd[:key] },
+                      form: {
+                        data: { turbo: false },
+                        class: "m-0 w-full shrink-0"
+                      },
+                      class: "inline-flex w-full cursor-pointer items-center justify-center rounded-lg bg-primary px-3 py-2 text-sm font-medium text-primary-foreground shadow-sm transition-colors hover:bg-primary/90" %>
+                </div>
+              </div>
+            <% end %>
+          </div>
+        <% else %>
+          <p class="text-sm text-muted-foreground">
+            <%= t("ruby_cms.admin.commands.empty", default: "No commands are registered, or your role cannot run any of them.") %>
+          </p>
+        <% end %>
+      </div>
+    </aside>
+
+    <%# Rechts: 2/3 — commando-output + applicatielog %>
+    <section
+      aria-label="<%= t("ruby_cms.admin.commands.right_column_label", default: "Command result and application log") %>"
+      class="flex min-h-0 w-full min-w-0 flex-col gap-3 md:col-span-2 md:row-start-1 md:h-full md:min-h-0 md:overflow-hidden md:border-l md:border-border/60 md:pl-6"
+    >
+      <%# min-h-0: grid/flex item mag krimpen zodat max-h geldt en <pre> scrollt i.p.v. de pagina. %>
+      <div class="flex min-h-0 max-h-[50dvh] flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-sm ring-1 ring-black/[0.03]">
+        <div class="shrink-0 border-b border-border/80 px-4 py-3">
+          <h3 class="text-sm font-semibold text-foreground">
+            <%= t("ruby_cms.admin.commands.command_output", default: "Command output") %>
+          </h3>
+        </div>
+        <pre
+          class="ruby-cms-commands__pre min-h-0 flex-1 overflow-y-auto overflow-x-auto overscroll-contain whitespace-pre-wrap break-words p-4 text-xs font-mono text-foreground [scrollbar-gutter:stable]"
+          aria-live="polite"
+        ><%= @run_command_output.present? ? h(@run_command_output) : t("ruby_cms.admin.commands.output_placeholder", default: "Output appears here after you run a command.") %></pre>
+      </div>
+
+      <div class="flex min-h-0 max-h-[50dvh] flex-col overflow-hidden rounded-2xl border border-border bg-card shadow-sm ring-1 ring-black/[0.03] [scrollbar-gutter:stable]">
+        <div class="shrink-0 border-b border-border/80 px-4 py-3">
+          <h3 class="text-sm font-semibold text-foreground">
+            <%= t("ruby_cms.admin.commands.app_log", default: "Application log (tail)") %>
+          </h3>
+        </div>
+        <pre
+          class="ruby-cms-commands__pre min-h-0 flex-1 overflow-y-auto overflow-x-auto overscroll-contain whitespace-pre-wrap break-words p-4 text-xs font-mono text-muted-foreground [scrollbar-gutter:stable]"
+          aria-live="polite"
+        ><%= @run_app_log_tail.present? ? h(@run_app_log_tail) : t("ruby_cms.admin.commands.log_placeholder", default: "Recent log lines appear here after a run.") %></pre>
+      </div>
+    </section>
+  </div>
+</div>

data/app/views/ruby_cms/admin/content_blocks/show.html.erb

@@ -28,7 +28,8 @@
               id: "content-block-form",
               data: { turbo: false } do |f| %>
   <div class="<%= RubyCms::Admin::AdminResourceCard::CARD_CLASS %>">
-    <div class="<%= RubyCms::Admin::AdminResourceCard::GRID_CLASS %>">
+    <div class="<%= RubyCms::Admin::AdminResourceCard::GRID_CLASS %>"
+         data-controller="ruby-cms--locale-tabs">
       <%# ── Form Fields (Left 2/3) ── %>
       <div class="<%= RubyCms::Admin::AdminResourceCard::MAIN_CLASS %>">
         <% if @content_block.errors.any? %>
@@ -78,18 +79,23 @@
 
         <%# ── Locale Tabs ── %>
         <% if @blocks_by_locale.present? %>
-          <div class="rounded-xl border border-border/60 overflow-hidden" data-controller="ruby-cms--locale-tabs">
+          <div class="rounded-xl border border-border/60 overflow-hidden">
             <div class="flex gap-1 p-2 bg-background border-b border-border/60" role="tablist">
               <% @blocks_by_locale.each_with_index do |(locale_s, _), idx| %>
+                <% tab_active = "bg-background text-primary shadow-sm ring-1 ring-border/60" %>
+                <% tab_inactive = "bg-transparent text-muted-foreground hover:bg-muted hover:text-foreground" %>
                 <button type="button"
                         role="tab"
-                        aria-selected="<%= idx == 0 %>"
+                        aria-selected="<%= idx == 0 ? "true" : "false" %>"
                         aria-controls="locale-panel-<%= locale_s %>"
                         id="locale-tab-<%= locale_s %>"
                         data-ruby-cms--locale-tabs-target="tab"
                         data-panel-id="locale-panel-<%= locale_s %>"
+                        data-locale-label="<%= ruby_cms_locale_display_name(locale_s) %>"
+                        data-active-classes="<%= tab_active %>"
+                        data-inactive-classes="<%= tab_inactive %>"
                         data-action="click->ruby-cms--locale-tabs#switchTab"
-                        class="px-3 py-1.5 rounded-md text-xs font-medium border-none cursor-pointer transition-colors <%= idx == 0 ? 'bg-background text-primary shadow-sm ring-1 ring-border/60' : 'bg-transparent text-muted-foreground hover:bg-muted hover:text-foreground' %>">
+                        class="px-3 py-1.5 rounded-md text-xs font-medium border-none cursor-pointer transition-colors <%= idx == 0 ? tab_active : tab_inactive %>">
                   <%= ruby_cms_locale_display_name(locale_s) %>
                 </button>
               <% end %>
@@ -154,7 +160,8 @@
 
             <div>
               <dt class="<%= RubyCms::Admin::AdminResourceCard::DETAIL_LABEL_CLASS %>">Locale</dt>
-              <dd class="<%= RubyCms::Admin::AdminResourceCard::DETAIL_VALUE_CLASS %>"><%= ruby_cms_locale_display_name(@content_block.locale) %></dd>
+              <dd class="<%= RubyCms::Admin::AdminResourceCard::DETAIL_VALUE_CLASS %>"
+                  data-ruby-cms--locale-tabs-target="localeLabel"><%= ruby_cms_locale_display_name(@content_block.locale) %></dd>
             </div>
 
             <div>

data/app/views/ruby_cms/admin/settings/index.html.erb

@@ -80,6 +80,15 @@
               <% end %>
             </div>
           </div>
+
+          <div class="mt-4 rounded-xl border border-border/80 bg-muted/15 px-4 py-3 text-sm leading-relaxed text-muted-foreground">
+            <p class="m-0"><%= t("ruby_cms.admin.settings.commands_page_hint") %></p>
+            <p class="mt-2 mb-0">
+              <%= link_to t("ruby_cms.admin.settings.commands_open_link"),
+                  ruby_cms_admin_settings_commands_path,
+                  class: "font-medium text-foreground underline decoration-border underline-offset-2 hover:text-primary" %>
+            </p>
+          </div>
         <% elsif entries_for_grid.any? %>
           <h2 class="text-base font-semibold tracking-tight text-foreground"><%= settings_tab_label(@active_tab) %></h2>
           <p class="mt-1 text-sm text-muted-foreground">

data/config/importmap.rb

@@ -36,3 +36,5 @@ pin "ruby_cms/nav_order_sortable_controller",
 pin "ruby_cms/page_preview_controller", to: "controllers/ruby_cms/page_preview_controller.js"
 pin "ruby_cms/content_block_history_controller",
     to: "controllers/ruby_cms/content_block_history_controller.js"
+pin "ruby_cms/admin_commands_controller",
+    to: "controllers/ruby_cms/admin_commands_controller.js"

data/config/locales/en.yml

@@ -27,6 +27,7 @@ en:
         permissions: "Permissions"
         visitor_errors: "Visitor errors"
         users: "Users"
+        commands: "Commands"
         settings: "Settings"
     admin:
       breadcrumb:
@@ -40,6 +41,19 @@ en:
         de: "German"
         fr: "French"
         es: "Spanish"
+      commands:
+        title: "Commands"
+        subtitle: "Run registered Rake tasks from the host app. Output and recent log lines appear on the right."
+        available: "Available commands"
+        hint: "Commands are registered in the host app initializer (RubyCms.register_command)."
+        run: "Run"
+        empty: "No commands are registered, or your role cannot run any of them."
+        command_output: "Command output"
+        app_log: "Application log (tail)"
+        output_placeholder: "Output appears here after you run a command."
+        log_placeholder: "Recent log lines appear here after a run."
+        unknown: "Unknown command."
+        right_column_label: "Command result and application log"
       settings:
         title: "Settings"
         subtitle: "Configure admin interface preferences"
@@ -57,6 +71,8 @@ en:
         reset_inline_hint: "Restore factory defaults for the entire admin (all sections)."
         reset_confirm: "Reset all settings to default values?"
         no_settings: "No settings in this category"
+        commands_page_hint: "Registered rake tasks (Commands) are not a tab on this screen. Open “Commands” in the left sidebar under “Settings”, or use the link below."
+        commands_open_link: "Open Commands"
       analytics:
         title: "Analytics"
         subtitle: "Traffic and engagement overview"

data/config/locales/nl.yml

@@ -16,6 +16,7 @@ nl:
         permissions: "Rechten"
         visitor_errors: "Bezoekersfouten"
         users: "Gebruikers"
+        commands: "Commando's"
         settings: "Instellingen"
     admin:
       breadcrumb:
@@ -29,6 +30,22 @@ nl:
         de: "Duits"
         fr: "Frans"
         es: "Spaans"
+      commands:
+        title: "Commando's"
+        subtitle: "Voer geregistreerde Rake-taken uit (host app). Uitvoer en recente logregels staan rechts."
+        available: "Beschikbare commando's"
+        hint: "Commando's registreer je in de host app (RubyCms.register_command)."
+        run: "Uitvoeren"
+        empty: "Er zijn geen commando's geregistreerd, of je rol mag er geen uitvoeren."
+        command_output: "Uitvoer commando"
+        app_log: "Applicatielog (tail)"
+        output_placeholder: "Uitvoer verschijnt hier na het uitvoeren."
+        log_placeholder: "Recente logregels verschijnen hier na een run."
+        unknown: "Onbekend commando."
+        right_column_label: "Commando-resultaat en applicatielog"
+      settings:
+        commands_page_hint: "Geregistreerde Rake-taken (Commando's) staan niet als tab op dit scherm. Open «Commando's» in de linkerzijbalk onder het kopje Instellingen, of gebruik de link hieronder."
+        commands_open_link: "Commando's openen"
       content_blocks:
         created: "Contentblok aangemaakt."
         updated: "Contentblok bijgewerkt."

data/config/routes.rb

@@ -49,6 +49,9 @@ RubyCms::Engine.routes.draw do # rubocop:disable Metrics/BlockLength
     post "settings/nav_order", to: "settings#update_nav_order", as: :settings_nav_order
     post "settings/reset_defaults", to: "settings#reset_defaults", as: :settings_reset_defaults
 
+    get "settings/commands", to: "commands#index", as: :settings_commands
+    post "settings/commands/run", to: "commands#run", as: :settings_commands_run
+
     resources :users, only: %i[index create destroy] do
       collection do
         delete "bulk_delete", to: "users#bulk_delete"

data/lib/ruby_cms/commands_registry.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module RubyCms
+  # Host apps register runnable commands (usually Rake tasks) shown on Admin → Commands.
+  module CommandsRegistry
+    def registered_commands
+      @registered_commands ||= []
+    end
+
+    def registered_commands=(list)
+      @registered_commands = list
+    end
+
+    # Register a button-triggered command for the admin Commands screen.
+    #
+    # @param key [String, Symbol] Unique id (e.g. :copy_en_to_nl)
+    # @param label [String] Button label
+    # @param rake_task [String] Full rake task name, including args in brackets if needed
+    # @param description [String, nil] Optional help text under the button
+    # @param permission [Symbol] Required to run (+can?+); default +:manage_admin+
+    def register_command(key:, label:, rake_task:, description: nil, permission: :manage_admin)
+      k = key.to_s
+      entry = {
+        key: k,
+        label: label.to_s,
+        rake_task: rake_task.to_s,
+        description: description.to_s.presence,
+        permission: permission.to_sym
+      }
+      self.registered_commands = registered_commands.reject {|e| e[:key] == k } + [entry]
+      entry
+    end
+
+    def find_command(key)
+      registered_commands.find {|e| e[:key] == key.to_s }
+    end
+  end
+
+  extend CommandsRegistry
+end

data/lib/ruby_cms/engine/navigation_registration.rb

@@ -66,6 +66,15 @@ module RubyCms
         permission: :manage_permissions,
         order: 4
       )
+      RubyCms.register_page(
+        key: :commands,
+        label: "Commands",
+        path: lambda(&:ruby_cms_admin_settings_commands_path),
+        icon: :wrench,
+        section: :settings,
+        permission: :manage_admin,
+        order: 5
+      )
       RubyCms.register_page(
         key: :settings,
         label: "Settings",
@@ -73,7 +82,7 @@ module RubyCms
         icon: :cog_6_tooth,
         section: :settings,
         permission: :manage_admin,
-        order: 5
+        order: 6
       )
     end
   end

data/lib/ruby_cms/settings_registry.rb

@@ -240,6 +240,13 @@ module RubyCms
           category: :navigation,
           description: "Show Analytics in navigation"
         )
+        register(
+          key: :nav_show_commands,
+          type: :boolean,
+          default: true,
+          category: :navigation,
+          description: "Show Commands in navigation"
+        )
         register(
           key: :nav_order,
           type: :json,

data/lib/ruby_cms/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyCms
-  VERSION = "0.2.0.1"
+  VERSION = "0.2.0.2"
 end

data/lib/ruby_cms.rb

@@ -10,6 +10,7 @@ require_relative "ruby_cms/engine"
 require_relative "ruby_cms/app_integration"
 require_relative "ruby_cms/content_blocks_sync"
 require_relative "ruby_cms/content_blocks_grouping"
+require_relative "ruby_cms/commands_registry"
 
 module RubyCms
   class Error < StandardError; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_cms
 version: !ruby/object:Gem::Version
-  version: 0.2.0.1
+  version: 0.2.0.2
 platform: ruby
 authors:
 - Codebyjob
@@ -96,6 +96,7 @@ files:
 - app/controllers/concerns/ruby_cms/visitor_error_capture.rb
 - app/controllers/ruby_cms/admin/analytics_controller.rb
 - app/controllers/ruby_cms/admin/base_controller.rb
+- app/controllers/ruby_cms/admin/commands_controller.rb
 - app/controllers/ruby_cms/admin/content_block_versions_controller.rb
 - app/controllers/ruby_cms/admin/content_blocks_controller.rb
 - app/controllers/ruby_cms/admin/dashboard_controller.rb
@@ -114,6 +115,7 @@ files:
 - app/helpers/ruby_cms/bulk_action_table_helper.rb
 - app/helpers/ruby_cms/content_blocks_helper.rb
 - app/helpers/ruby_cms/settings_helper.rb
+- app/javascript/controllers/ruby_cms/admin_commands_controller.js
 - app/javascript/controllers/ruby_cms/auto_save_preference_controller.js
 - app/javascript/controllers/ruby_cms/bulk_action_table_controller.js
 - app/javascript/controllers/ruby_cms/clickable_row_controller.js
@@ -138,6 +140,7 @@ files:
 - app/models/ruby_cms/user_permission.rb
 - app/models/ruby_cms/visitor_error.rb
 - app/services/ruby_cms/analytics/report.rb
+- app/services/ruby_cms/command_runner.rb
 - app/services/ruby_cms/security_tracker.rb
 - app/views/admin/content_block_versions/index.html.erb
 - app/views/admin/content_block_versions/show.html.erb
@@ -160,6 +163,7 @@ files:
 - app/views/ruby_cms/admin/analytics/partials/_top_visitors.html.erb
 - app/views/ruby_cms/admin/analytics/partials/_utm_sources.html.erb
 - app/views/ruby_cms/admin/analytics/visitor_details.html.erb
+- app/views/ruby_cms/admin/commands/index.html.erb
 - app/views/ruby_cms/admin/content_block_versions/index.html.erb
 - app/views/ruby_cms/admin/content_block_versions/show.html.erb
 - app/views/ruby_cms/admin/content_blocks/_form.html.erb
@@ -215,6 +219,7 @@ files:
 - lib/ruby_cms.rb
 - lib/ruby_cms/app_integration.rb
 - lib/ruby_cms/cli.rb
+- lib/ruby_cms/commands_registry.rb
 - lib/ruby_cms/content_blocks_grouping.rb
 - lib/ruby_cms/content_blocks_sync.rb
 - lib/ruby_cms/css_compiler.rb