ActiveScaffold：讓 Ruby on Rails 後台管理介面開發事半功倍

痛點：傳統 Scaffold 的三大缺陷

• 不支援關聯：無法自動處理 belongs_to/has_many 關聯的下拉選單或巢狀列表。
• 無法往返：生成的靜態程式碼一旦修改，就無法重新生成而不覆蓋變更。
• 樣式單薄：缺乏 CSS 主題支援，介面極其簡陋。

ActiveScaffold 核心優勢

• 動態反射 ActiveRecord 模型，自動生成完整 CRUD 介面。
• 支援關聯導航、搜尋、分頁、匯出、本地化、權限控制。
• 修改模型關聯即自動更新介面，無需手動調整 View。

安裝與基本設定

script/plugin install https://activescaffold.googlecode.com/svn/tags/active_scaffold

控制器改用 active_scaffold :model_name，並套用預設版面 layout "activescaffold"。

進階客製化技巧

全域與區域設定

# 全域
AjaxScaffold.set_defaults do |conf|
  conf.list.results_per_page = 20
end

# 區域 (UsersController)
active_scaffold :user do |conf|
  conf.modules.exclude :update
  conf.list.label = 'People'
  conf.list.sorting = [{:last_name => :ASC}, {:first_name => :ASC}]
  conf.list.columns.exclude :password_hash
end

模型顯示與欄位格式化

• 實作 to_label 方法自訂列表顯示文字（如 first_name + ' ' + last_name）。
• 在 app/helpers/user_helper.rb 定義 欄位名_column(record) 格式化輸出（如日期格式）。
• 虛擬屬性（如 password、password_confirmation）需自訂 _form_column 方法渲染為密碼框。

關聯介面優化

• 列表頁自動顯示關聯連結，可覆寫 關聯名_column 自訂連結邏輯。
• 表單預設使用下拉選單，大量資料時可改寫 _form_column 使用靜態選單或 AJAX 自動完成。

搜尋效能調校

• 啟用即時搜尋：conf.actions.add :live_search。
• 限制搜尋欄位：conf.live_search.columns = [:last_name, :first_name]。
• 關閉全文搜尋改用前綴比對：conf.live_search.full_text_search = false，避免 LIKE '%keyword%' 導致索引失效。

自訂動作與匯出

新增 action_links 連結至自訂 Controller 方法，配合 Model 定義 csv_header、to_csv 實現泛用 CSV 匯出。

本地化與樣式覆寫

• 實作 Object#as_ 掛鉤 Globalize 等本地化插件。
• 引入自訂 CSS 覆寫預設樣式：stylesheet_include_tag "as_overrides"。

兩層權限控制

• Controller 層：定義 動作_authorized? 方法，搭配 current_user_method。
• Model 層：定義 authorized_for_動作? 實現資料級權限（如僅專案擁有者可編輯）。

結語

ActiveScaffold 以動態反射與慣例優於配置，解決傳統 Scaffold 痛點，讓開發者專注於核心業務邏輯，是 Rails 後台管理介面的最佳加速器。