activeadmin 1.0.0 → 2.13.1

data/config/locales/tr.yml

@@ -8,6 +8,7 @@ tr:
     edit: "Düzenle"
     delete: "Sil"
     delete_confirmation: "Bu kaydı silmek istediğinizden emin misiniz?"
+    create_another: "Başka bir %{model} oluştur"
     new_model: "Yeni %{model}"
     edit_model: "%{model} Kaydını Düzenle"
     delete_model: "%{model} Kaydını Sil"
@@ -20,6 +21,7 @@ tr:
     has_many_new: "Yeni %{model} Ekle"
     has_many_delete: "Sil"
     has_many_remove: "Çıkar"
+    move: "Taşı"
     filters:
       buttons:
         filter: "Filtrele"
@@ -31,6 +33,10 @@ tr:
         ends_with: "İle biter"
         greater_than: "Büyüktür"
         less_than: "Küçüktür"
+        gteq_datetime: "Büyük yada eşit"
+        lteq_datetime: "Küçük yada eşit"
+        from: "Başlangıç"
+        to: "Bitiş"
     search_status:
       headline: "Arama"
       current_scope: "Kapsam:"
@@ -39,6 +45,7 @@ tr:
     status_tag:
       "yes": "Evet"
       "no": "Hayır"
+      "unset": "Hayır"
     main_content: "İçeriği görüntülemek için lütfen %{model}#main_content metodunu ekleyin."
     logout: "Çıkış Yap"
     powered_by: "%{active_admin} %{version} tarafından desteklenmektedir."
@@ -51,6 +58,7 @@ tr:
       one_page: "<b>%{n}</b> %{model} kaydının tamamı görüntüleniyor"
       multiple: "<b>%{from}&nbsp;-&nbsp;%{to}</b> arası %{model} görüntüleniyor (toplam %{total} kayıt)"
       multiple_without_total: "<b>%{from}&nbsp;-&nbsp;%{to}</b> arası %{model} görüntüleniyor"
+      per_page: "Sayfa Başına: "
       entry:
         one: "kayıt"
         other: "kayıtlar"
@@ -68,7 +76,6 @@ tr:
         one: "1 %{model} başarıyla silindi"
         other: "Toplam %{count} %{plural_model} başarıyla silindi"
       selection_toggle_explanation: "(Seçimi Değiştir)"
-      link: "Yeni oluştur"
       action_label: "Seçilenleri %{title}"
       labels:
         destroy: "Sil"
@@ -78,7 +85,6 @@ tr:
       author_type: "Yazar Tipi"
       body: "Ayrıntı"
       author: "Yazar"
-      title: "Yorum"
       add: "Yorum Ekle"
       delete: "Yorumu Sil"
       delete_confirmation: "Bu yorumları silmek istediğinizden emin misiniz?"
@@ -97,6 +103,8 @@ tr:
         title: "Alt alan adı"
       password:
         title: "Şifre"
+      password_confirmation:
+        title: "Şifreyi Tekrarla"
       sign_up:
         title: "Kaydol"
         submit: "Kaydol"

data/config/locales/uk.yml

@@ -31,6 +31,8 @@ uk:
         ends_with: "Закінчується"
         greater_than: "більше"
         less_than: "менше"
+        from: "від"
+        to: "до"
     search_status:
       headline: "Статус пошуку:"
       current_scope: "Область:"
@@ -39,6 +41,7 @@ uk:
     status_tag:
       "yes": "Так"
       "no": "Ні"
+      "unset": "Ні"
     main_content: "Створіть %{model}#main_content для відображення вмісту."
     logout: "Вийти"
     powered_by: "Powered by %{active_admin} %{version}"
@@ -72,7 +75,6 @@ uk:
         many: "Успішно видалено: %{count} %{plural_model}"
         other: "Успішно видалено: %{count} %{plural_model}"
       selection_toggle_explanation: "(Скасувати все / Зняти виділення)"
-      link: "Створити"
       action_label: "%{title} вибране"
       labels:
         destroy: "Видалити"
@@ -81,7 +83,6 @@ uk:
       author_type: "Тип автора"
       body: "Текст"
       author: "Автор"
-      title: "Коментар"
       add: "Додати Коментар"
       resource: "Ресурс"
       no_comments_yet: "Поки-що немає коментарів."
@@ -127,7 +128,7 @@ uk:
     unsupported_browser:
       headline: "Зверніть, будь-ласка, увагу, що ActiveAdmin більше не підтримує Internet Explorer 8 версії і нижче"
       recommendation: "Ми рекомендуємо оновити версію вашого браузеру (<a href=\"http://windows.microsoft.com/ie\">Internet Explorer</a>, <a href=\"https://chrome.google.com/\">Google Chrome</a>, або <a href=\"https://mozilla.org/firefox/\">Firefox</a>)."
-      turn_off_compatibility_view: "Якщо ви використовуєте IE 9 і вище, переконайтесь, що <a href=\"http://windows.microsoft.com/en-US/windows7/webpages-look-incorrect-in-Internet-Explorer\">ви вимкнули опцію \"Перегляд в режимі сумісності\"</a>."
+      turn_off_compatibility_view: "Якщо ви використовуєте IE 9 і вище, переконайтесь, що <a href=\"https://support.microsoft.com/uk-ua/help/17471\">ви вимкнули опцію \"Перегляд в режимі сумісності\"</a>."
     access_denied:
       message: "Ви не авторизовані для виконання даної дії."
     index_list:

data/config/locales/vi.yml

@@ -1,22 +1,23 @@
 vi:
   active_admin:
-    dashboard: Dashboard
+    dashboard: Bảng điều khiển
     dashboard_welcome:
-      welcome: "Chào mừng bạn đến với Active Admin. Đây là trang Dashboard mặc định."
-      call_to_action: "Để thêm phần phần cho trang Dashboar hãy chỉnh sửa 'app/admin/dashboard.rb'"
+      welcome: "Chào mừng bạn đến với Active Admin. Đây là trang điều khiển mặc định."
+      call_to_action: "Để thêm thành phần cho trang điều khiển hãy chỉnh sửa 'app/admin/dashboard.rb'"
     view: "Xem"
     edit: "Chỉnh sửa"
     delete: "Xóa"
-    delete_confirmation: "Bạn có chắc chắn rằng mình muốn xóa cái này?"
+    delete_confirmation: "Bạn có chắc chắn rằng mình muốn xóa không?"
     new_model: "Tạo mới %{model}"
     edit_model: "Chỉnh sửa %{model}"
     delete_model: "Xóa %{model}"
+    create_another: "Tạo thêm %{model}"
     details: "%{model} Chi tiết"
     cancel: "Hủy"
     empty: "Trống"
     previous: "Trước"
-    next: "Tiếp"
-    download: "Download:"
+    next: "Sau"
+    download: "Tải về:"
     has_many_new: "Thêm mới %{model}"
     has_many_delete: "Xóa"
     has_many_remove: "Hủy bỏ"
@@ -25,26 +26,38 @@ vi:
         filter: "Lọc"
         clear: "Xóa dữ liệu lọc"
       predicates:
-        contains: "Thông tin"
+        contains: "Có chứa"
         equals: "Bằng"
         starts_with: "Bắt đầu với"
-        ends_with: "Kết thúc với việc"
+        ends_with: "Kết thúc bởi"
         greater_than: "Lớn hơn"
         less_than: "Nhỏ hơn"
+        gteq_datetime: "Lớn hơn hoặc bằng"
+        lteq_datetime: "Nhỏ hơn hoặc bằng"
+        from: "Từ"
+        to: "Đến"
+    search_status:
+      headline: "Danh sách tìm kiếm:"
+      current_scope: "Phạm vi:"
+      current_filters: "Bộ lộc hiện tại:"
+      no_current_filters: "Không có"
     status_tag:
       "yes": "Có"
       "no": "Không Có"
+      "unset": "Không Có"
     main_content: "Xin bổ sung %{model}#main_content để hiển thị nội dung."
     logout: "Đăng xuất"
     powered_by: "Powered by %{active_admin} %{version}"
     sidebars:
       filters: "Bộ Lọc"
+      search_status: "Trạng thái tìm kiếm"
     pagination:
       empty: "Không có %{model} nào được tìm thấy"
       one: "Đang hiển thị <b>1</b> %{model}"
       one_page: "Đang hiển thị <b>tất cả %{n}</b> %{model}"
       multiple: "Đang hiển thị %{model} <b>%{from}&nbsp;-&nbsp;%{to}</b> of <b>%{total}</b> trong tất cả."
       multiple_without_total: "Đang hiển thị %{model} <b>%{from}&nbsp;-&nbsp;%{to}</b>."
+      per_page: "Mỗi trang: "
       entry:
         one: "entry"
         other: "entries"
@@ -62,21 +75,37 @@ vi:
         one: "Đã xóa thành công 1 %{model}"
         other: "Đã xóa thành công %{count} %{plural_model}"
       selection_toggle_explanation: "(Thay đổi lựa chọn)"
-      link: "Tạo mới"
       action_label: "%{title} được chọn"
       labels:
         destroy: "Xóa"
     comments:
+      created_at: "Đã tạo"
+      resource_type: "Resource Type"
       body: "Nội dung"
       author: "Tác giả"
-      title: "Bình luận"
       add: "Thêm bình luận"
-      resource: "Tài nguyên"
+      delete: "Xoá bình luận"
+      delete_confirmation: "Bạn có chắc chắn muốn xóa những bình luận này?"
+      resource: "Resource"
       no_comments_yet: "Chưa có bình luận."
+      author_missing: "Vô danh"
       title_content: "Bình luận (%{count})"
       errors:
         empty_text: "Lời bình luận chưa được lưu, vì nội dung còn trống."
     devise:
+      username:
+        title: "Tên người dùng"
+      email:
+        title: "Email"
+      subdomain:
+        title: "Tên miền phụ"
+      password:
+        title: "Mật khẩu"
+      password_confirmation:
+        title: "Mật khẩu xác nhận"
+      sign_up:
+        title: "Đăng ký"
+        submit: "Đăng ký"
       login:
         title: "Đăng nhập"
         remember_me: "Ghi nhớ tôi"
@@ -87,8 +116,20 @@ vi:
       change_password:
         title: "Thay đổi mật khẩu của bạn"
         submit: "Thay đổi mật khẩu của tôi"
+      unlock:
+        title: "Gởi lại hướng dẫn mở khoá"
+        submit: "Gởi lại hướng dẫn mở khoá"
+      resend_confirmation_instructions:
+        title: "Gởi lại hướng dẫn xác nhận"
+        submit: "Gởi lại hướng dẫn xác nhận"
       links:
         sign_in: "Đăng nhập"
         forgot_your_password: "Quên mật khẩu của bạn?"
         sign_in_with_omniauth_provider: "Đăng nhập với %{provider}"
-
+    access_denied:
+      message: "Bạn không có quyền thực hiện tính năng này"
+    index_list:
+      table: "Bảng"
+      block: "Danh sách"
+      grid: "Lưới"
+      blog: "Blog"

data/config/locales/zh-CN.yml

@@ -8,12 +8,13 @@
     edit: "编辑"
     delete: "删除"
     delete_confirmation: "确定删除?"
+    create_another: "新建另一个%{model}"
     new_model: "新建%{model}"
     edit_model: "编辑%{model}"
     delete_model: "删除%{model}"
     details: "%{model}详情"
     cancel: "取消"
-    empty: "清空"
+    empty: "未定义"
     previous: "上一个"
     next: "下一个"
     download: "下载:"
@@ -31,14 +32,19 @@
         ends_with: "完与"
         greater_than: "大于"
         less_than: "小于"
+        gteq_datetime: "大于等于"
+        lteq_datetime: "小于等于"
+        from: "起"
+        to: "止"
     search_status:
       headline: "搜索条件："
       current_scope: "搜索范围："
       current_filters: "过滤条件："
       no_current_filters: "无"
     status_tag:
-      "yes": "是的"
-      "no": "无"
+      "yes": "是"
+      "no": "否"
+      "unset": "否"
     main_content: "请执行 %{model}#main_content 来显示内容."
     logout: "退出"
     powered_by: "Powered by %{active_admin} %{version}"
@@ -51,6 +57,7 @@
       one_page: "显示 <b>所有 %{n}</b> %{model}"
       multiple: "显示所有 <b>%{total}</b> %{model}中的<b>%{from}&nbsp;-&nbsp;%{to}</b> 条"
       multiple_without_total: "%{model}中的<b>%{from}&nbsp;-&nbsp;%{to}</b> 条"
+      per_page: "每页："
       entry:
         one: "条目"
         other: "条目"
@@ -63,22 +70,26 @@
     batch_actions:
       button_label: "批处理"
       default_confirmation: "你确定你要这样做？"
-      delete_confirmation: "你确定要删除所有%{plural_model}?"
+      delete_confirmation: "你确定要删除这些%{plural_model}?"
       succesfully_destroyed:
         one: "成功删除 1 %{model}"
         other: "成功删除 %{count} %{plural_model}"
       selection_toggle_explanation: "(切换选择)"
-      link: "新建一个"
       action_label: "%{title} 被选中"
       labels:
         destroy: "删除"
     comments:
+      created_at: "创建于"
+      resource_type: "资源类型"
+      author_type: "作者类型"
       body: "内容"
       author: "作者"
-      title: "评论"
       add: "添加评论"
+      delete: "删除评论"
+      delete_confirmation: "你确定删除这些评论？"
       resource: "资源"
       no_comments_yet: "暂时没有评论"
+      author_missing: "匿名"
       title_content: "(%{count})条评论"
       errors:
         empty_text: "评论保存失败，内空不能为空."
@@ -91,6 +102,11 @@
         title: "子域"
       password:
         title: "密码"
+      password_confirmation:
+        title: "确认密码"
+      sign_up:
+        title: "注册"
+        submit: "注册"
       login:
         title: "登录"
         remember_me: "记住我"
@@ -98,6 +114,9 @@
       reset_password:
         title: "忘记了密码？"
         submit: "重置我的密码"
+      change_password:
+        title: "修改密码"
+        submit: "修改密码"
       unlock:
         title: "重新发送送解锁命令"
         submit: "重新发送送解锁命令"
@@ -105,12 +124,20 @@
         title: " 重新发送确认指示"
         submit: " 重新发送确认指示"
       links:
+        sign_up: "注册"
         sign_in: "登录"
         forgot_your_password: "忘记了密码？"
-        sign_in_with_omniauth_provider: "登入%{provider}"
+        sign_in_with_omniauth_provider: "通过%{provider}登录"
+        resend_unlock_instructions: "重发解锁邮件"
+        resend_confirmation_instructions: "重发确认邮件"
     unsupported_browser:
       headline: "很抱歉，ActiveAdmin 已不再支持 Internet Explorer 8 以下版本的浏览器。"
       recommendation: "建议您升级到最新版本的<a href=\"http://windows.microsoft.com/ie\">Internet Explorer</a>，<a href=\"https://chrome.google.com/\">Google Chrome</a>，或是 <a href=\"https://mozilla.org/firefox/\">Firefox</a>。"
       turn_off_compatibility_view: "如果您使用的是 IE 9 或更新的版本，请确认<a href=\"https://support.microsoft.com/zh-cn/help/17472/windows-internet-explorer-11-fix-site-display-problems-compatibility-view\">已关闭“兼容性视图”</a>。"
     access_denied:
       message: "您无权处理此操作"
+    index_list:
+      table: "表格"
+      block: "列表"
+      grid: "网格"
+      blog: "博客"

data/config/locales/zh-TW.yml

@@ -39,6 +39,7 @@
     status_tag:
       "yes": "是"
       "no": "否"
+      "unset": "否"
     main_content: "請實作 %{model}#main_content 以顯示內容。"
     logout: "登出"
     powered_by: "Powered by %{active_admin} %{version}"
@@ -68,7 +69,6 @@
         one: "成功刪除 1 %{model}"
         other: "成功刪除 %{count} %{plural_model}"
       selection_toggle_explanation: "（切換選取）"
-      link: "建立一個"
       action_label: "%{title} 已選取"
       labels:
         destroy: "刪除"
@@ -78,7 +78,6 @@
       author_type: "作者身份"
       body: "內文"
       author: "作者"
-      title: "評論"
       add: "新增評論"
       delete: "刪除評論"
       delete_confirmation: "你確定要刪除這些評論嗎？"
@@ -126,7 +125,7 @@
     unsupported_browser:
       headline: "很抱歉，ActiveAdmin 已不再支援 Internet Explorer 8 以下版本的瀏覽器。"
       recommendation: "建議您升級到最新版本的<a href=\"http://windows.microsoft.com/ie\">Internet Explorer</a>，<a href=\"https://chrome.google.com/\">Google Chrome</a>，或是 <a href=\"https://mozilla.org/firefox/\">Firefox</a>。"
-      turn_off_compatibility_view: "若您是使用 IE 9 或更新的版本，請確認<a href=\"http://windows.microsoft.com/zh-TW/windows7/webpages-look-incorrect-in-Internet-Explorer\">「相容性檢視」是關閉的</a>。"
+      turn_off_compatibility_view: "若您是使用 IE 9 或更新的版本，請確認<a href=\"https://support.microsoft.com/zh-tw/help/17471\">「相容性檢視」是關閉的</a>。"
     access_denied:
       message: "您沒有權限執行此項操作"
     index_list:

data/docs/.gitignore

@@ -0,0 +1 @@
+_site/

data/docs/0-installation.md

@@ -1,6 +1,7 @@
 ---
 redirect_from: /docs/0-installation.html
 ---
+
 # Installation
 
 Active Admin is a Ruby Gem.
@@ -10,7 +11,7 @@ gem 'activeadmin'
 
 # Plus integrations with:
 gem 'devise'
-gem 'cancan' # or cancancan
+gem 'cancancan'
 gem 'draper'
 gem 'pundit'
 ```
@@ -22,35 +23,36 @@ that can be injected into your existing Ruby on Rails application.
 
 After installing the gem, you need to run the generator. Here are your options:
 
-- If you don't want to use Devise, run it with `--skip-users`:
+* If you don't want to use Devise, run it with `--skip-users`:
+
   ```sh
   rails g active_admin:install --skip-users
   ```
 
-- If you want to use an existing user class, provide it as an argument:
+* If you want to customize the name of the generated user class, or if you want to use an existing user class, provide the class name as an argument:
+
   ```sh
   rails g active_admin:install User
   ```
 
-- Otherwise, with no arguments we will create an `AdminUser` class to use with Devise:
+* Otherwise, with no arguments we will create an `AdminUser` class to use with Devise:
+
   ```sh
   rails g active_admin:install
   ```
 
 The generator adds these core files, among others:
 
-```
-app/admin/dashboard.rb
-app/assets/javascripts/active_admin.js.coffee
-app/assets/stylesheets/active_admin.scss
-config/initializers/active_admin.rb
-```
+* `app/admin/dashboard.rb`
+* `app/assets/javascripts/active_admin.js`
+* `app/assets/stylesheets/active_admin.scss`
+* `config/initializers/active_admin.rb`
 
 Now, migrate and seed your database before starting the server:
 
 ```sh
-rake db:migrate
-rake db:seed
+rails db:migrate
+rails db:seed
 rails server
 ```
 
@@ -67,7 +69,8 @@ To register an existing model with Active Admin:
 rails generate active_admin:resource MyModel
 ```
 
-This creates a file at `app/admin/my_model.rb` to set up the UI; refresh your browser to see it.
+This creates a file at `app/admin/my_model.rb` to set up the UI; refresh your
+browser to see it.
 
 # Upgrading
 
@@ -98,8 +101,8 @@ Kaminari.configure do |config|
 end
 ```
 
-If you are also using [Draper](https://github.com/drapergem/draper), you may want to
-make sure `per_page_kaminari` is delegated correctly:
+If you are also using [Draper](https://github.com/drapergem/draper), you may
+want to make sure `per_page_kaminari` is delegated correctly:
 
 ```ruby
 Draper::CollectionDecorator.send :delegate, :per_page_kaminari
@@ -109,6 +112,30 @@ Draper::CollectionDecorator.send :delegate, :per_page_kaminari
 
 If you're getting the error `wrong number of arguments (6 for 4..5)`, [read #2703].
 
+## webpacker
+
+You can **opt-in to using Webpacker for ActiveAdmin assets** as well by updating your configuration to turn on the `use_webpacker` option, either at installation time or manually.
+
+* at active_admin installation:
+
+  ```sh
+  rails g active_admin:install --use_webpacker
+  ```
+
+* manually:
+
+  ```ruby
+  ActiveAdmin.setup do |config|
+    config.use_webpacker = true
+  end
+  ```
+
+  And run the generator to get default Active Admin assets:
+
+  ```sh
+  rails g active_admin:webpacker
+  ```
+
 [CHANGELOG]: https://github.com/activeadmin/activeadmin/blob/master/CHANGELOG.md
 [dashboard.rb]: https://github.com/activeadmin/activeadmin/blob/master/lib/generators/active_admin/install/templates/dashboard.rb
 [active_admin.rb]: https://github.com/activeadmin/activeadmin/blob/master/lib/generators/active_admin/install/templates/active_admin.rb.erb

data/docs/1-general-configuration.md

@@ -1,6 +1,7 @@
 ---
 redirect_from: /docs/1-general-configuration.html
 ---
+
 # General Configuration
 
 You can configure Active Admin settings in `config/initializers/active_admin.rb`.
@@ -45,11 +46,22 @@ config.site_title_image = ->(context) { context.current_user.company.logo_url }
 
 ## Internationalization (I18n)
 
-To translate Active Admin to a new language or customize an existing translation, you can copy
+Active Admin comes with translations for a lot of
+[locales](https://github.com/activeadmin/activeadmin/blob/master/config/locales/).
+Active Admin does not provide the translations for the kaminari gem it uses for pagination,
+to get these you can use the
+[kaminari-i18n](https://github.com/tigrish/kaminari-i18n) gem.
+
+To translate Active Admin to a new language or customize an existing
+translation, you can copy
 [config/locales/en.yml](https://github.com/activeadmin/activeadmin/blob/master/config/locales/en.yml)
-to your application's `config/locales` folder and update it. We welcome new/updated translations,
-so feel free to [contribute](https://github.com/activeadmin/activeadmin/blob/master/CONTRIBUTING.md)!
-To translate third party gems like devise, use for example devise-i18n.
+to your application's `config/locales` folder and update it. We welcome
+new/updated translations, so feel free to
+[contribute](https://github.com/activeadmin/activeadmin/blob/master/CONTRIBUTING.md)!
+
+When using [devise](https://github.com/plataformatec/devise) for authentication,
+you can use the [devise-i18n](https://github.com/tigrish/devise-i18n)
+gem to get the devise translations for other locales.
 
 ## Localize Format For Dates and Times
 
@@ -94,6 +106,26 @@ ActiveAdmin.setup do |config|
 end
 ```
 
+If you are creating a multi-tenant application you may want to have multiple namespaces mounted to the same path. We can do this using the `route_options` settings on the namespace
+
+```ruby
+config.namespace :site_1 do |admin|
+  admin.route_options = { path: :admin, constraints: ->(request){ request.domain == "site1.com" } }
+end
+
+config.namespace :site_2 do |admin|
+  admin.route_options = { path: :admin, constraints: ->(request){ request.domain == "site2.com" } }
+end
+```
+
+If you would like to mount the namespace to a subdomain instead of path we can use the `route_options` for this as well
+
+```ruby
+config.namespace :admin do |admin|
+  admin.route_options = { path: '', subdomain: 'admin' }
+end
+```
+
 Each setting available in the Active Admin setup block is configurable on a per
 namespace basis.
 
@@ -140,20 +172,29 @@ config.comments_registration_name = 'AdminComment'
 
 You can change the order for the comments and you can change the column to be
 used for ordering:
+
 ```ruby
 config.comments_order = 'created_at ASC'
 ```
 
 You can disable the menu item for the comments index page:
+
 ```ruby
 config.comments_menu = false
 ```
 
 You can customize the comment menu:
+
 ```ruby
 config.comments_menu = { parent: 'Admin', priority: 1 }
 ```
 
+Remember to indicate where to place the comments and form with:
+
+```ruby
+active_admin_comments
+```
+
 ## Utility Navigation
 
 The "utility navigation" shown at the top right normally shows the current user
@@ -177,6 +218,7 @@ end
 
 By default, Active Admin displays a "Powered by ActiveAdmin" message on every
 page. You can override this message and show domain-specific messaging:
+
 ```ruby
 config.footer = "MyApp Revision v1.3"
 ```

data/docs/10-custom-pages.md

@@ -1,6 +1,7 @@
 ---
 redirect_from: /docs/10-custom-pages.html
 ---
+
 # Custom Pages
 
 If you have data you want on a standalone page that isn't tied to a resource,
@@ -52,7 +53,7 @@ end
 
 See the [Menu](2-resource-customization.md#customize-the-menu) documentation.
 
-## Customize the breadcrumbs
+## Customize the breadcrumbs
 
 ```ruby
 ActiveAdmin.register_page "Calendar" do
@@ -85,7 +86,8 @@ ActiveAdmin.register_page "Status" do
 end
 ```
 
-See also the [Belongs To](2-resource-customization.md#belongs-to) documentation and examples.
+See also the [Belongs To](2-resource-customization.md#belongs-to) documentation
+and examples.
 
 ## Add a Sidebar
 
@@ -104,7 +106,8 @@ end
 
 ## Add a Page Action
 
-Page actions are custom controller actions (which mirror the resource DSL for the same feature).
+Page actions are custom controller actions (which mirror the resource DSL for
+the same feature).
 
 ```ruby
 page_action :add_event, method: :post do
@@ -119,7 +122,8 @@ end
 
 This defines the route `/admin/calendar/add_event` which can handle HTTP POST requests.
 
-Clicking on the action item will reload page and display the message "Your event was added"
+Clicking on the action item will reload page and display the message "Your event
+was added"
 
 Page actions can handle multiple HTTP verbs.
 
@@ -128,4 +132,19 @@ page_action :add_event, method: [:get, :post] do
   # ...
 end
 ```
-See also the [Custom Actions](8-custom-actions.md#http-verbs) example.
+
+See also the [Custom Actions](8-custom-actions.md#http-verbs) example.
+
+## Use custom column as id
+
+You can use custom parameter instead of id
+
+```ruby
+ActiveAdmin.register User do
+  controller do
+    defaults :finder => :find_by_name
+  end
+end
+```
+
+This defines the resource route as `/admin/users/john` if user name is john