active_administration 0.0.1

data/config/locales/zh-TW.yml

@@ -0,0 +1,94 @@
+"zh-TW":
+  active_admin:
+    dashboard: 儀表板
+    dashboard_welcome:
+      welcome: "歡迎來到 Active Admin 這是預設的儀表板頁面。"
+      call_to_action: "要新增儀表板內容，請查看 'app/admin/dashboard.rb'"
+    view: "檢視"
+    edit: "編輯"
+    delete: "刪除"
+    delete_confirmation: "你確定要刪除嗎？"
+    new_model: "新增 %{model}"
+    create_model: "新增 %{model}"
+    edit_model: "編輯 %{model}"
+    update_model: "編輯 %{model}"
+    delete_model: "刪除 %{model}"
+    details: "%{model} 明細"
+    cancel: "取消"
+    empty: "空的"
+    previous: "前一個"
+    next: "下一個"
+    download: "下載:"
+    has_many_new: "增加新的 %{model}"
+    has_many_delete: "刪除"
+    has_many_remove: "清除"
+    filters:
+      buttons:
+        filter: "篩選"
+        clear: "清除篩選條件"
+      predicates:
+        contains: "包含"
+        equals: "等於"
+        starts_with: "开头"
+        ends_with: "完与"
+        greater_than: "大於"
+        less_than: "小於"
+    main_content: "請編寫 %{model}#main_content 以顯示內容。"
+    logout: "登出"
+    powered_by: "Powered by %{active_admin} %{version}"
+    sidebars:
+      filters: "篩選條件"
+    pagination:
+      empty: "找不到 %{model} "
+      one: "顯示 <b>1</b> %{model}"
+      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> 筆"
+      entry:
+        one: "筆"
+        other: "筆"
+    any: "任何"
+    blank_slate:
+      content: "尚無 %{resource_name}"
+      link: "建立一筆"
+    batch_actions:
+      button_label: "批次作業"
+      default_confirmation: "你確定你要這樣做？"
+      delete_confirmation: "您確定要刪除這些 %{plural_model} 嗎？"
+      succesfully_destroyed:
+        one: "成功刪除 1 %{model}"
+        other: "成功刪除 %{count} %{plural_model}"
+      selection_toggle_explanation: "(切換選取)"
+      link: "建立一個"
+      action_label: "%{title} 已選取"
+      labels:
+        destroy: "刪除"
+    comments:
+      body: "內文"
+      author: "作者"
+      title: "評論"
+      add: "新增評論"
+      resource: "資源"
+      no_comments_yet: "尚無評論"
+      title_content: "(%{count}) 則評論"
+      errors:
+        empty_text: "評論儲存失敗，不允許空白的內容。"
+    devise:
+      login:
+        title: "登錄"
+        remember_me: "記住我"
+        submit: "登錄"
+      reset_password:
+        title: "忘記密碼？"
+        submit: "重置密碼"
+      change_password:
+        title: "更改您的密碼"
+        submit: "更改我的密碼"
+      resend_confirmation_instructions:
+        title: '重新發送確認信'
+        submit: '重新發送確認信'
+      links:
+        sign_in: "登錄"
+        forgot_your_password: "忘記密碼？"
+        sign_in_with_omniauth_provider: "登入%{provider}"
+

data/cucumber.yml

@@ -0,0 +1,3 @@
+default: --format 'progress' --require features/support/env.rb --require features/step_definitions features --tags ~@requires-reloading --tags ~@wip
+wip: --format 'progress' --require features/support/env.rb --require features/step_definitions features --tags @wip:3 --wip features
+class-reloading: RAILS_ENV=cucumber_with_reloading --format 'progress' --require features/support/env.rb --require features/step_definitions features --tags @requires-reloading

data/docs/0-installation.md

@@ -0,0 +1,84 @@
+# Installation
+
+Active Admin is a Ruby Gem.
+
+```ruby
+gem 'activeadmin'
+```
+
+More accurately, it's a [Rails Engine](http://guides.rubyonrails.org/engines.html)
+that can be injected into your existing Ruby on Rails application.
+
+## Setting up Active Admin
+
+After installing the gem, you need to run the generator (one of the following):
+
+```sh
+rails g active_admin:install              # creates the AdminUser class
+rails g active_admin:install User         # uses an existing class
+rails g active_admin:install --skip-users # skips user authentication entirely
+```
+
+The generator adds these core files, among others:
+
+```
+app/admin/dashboard.rb
+app/assets/javascripts/active_admin.js.coffee
+app/assets/stylesheets/active_admin.css.scss
+config/initializers/active_admin.rb
+```
+
+Now, migrate your database and start the server:
+
+```sh
+rake db:migrate
+rails server
+```
+
+Visit `http://localhost:3000/admin` and log in as the default user:
+
+* __User__: admin@example.com
+* __Password__: password
+
+Voila! You're on your brand new Active Admin dashboard.
+
+To register an existing model with Active Admin:
+
+```sh
+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.
+
+# Upgrading
+
+When upgrading to a new version, it's a good idea to check the [CHANGELOG].
+
+To update the JS & CSS assets:
+
+```sh
+rails generate active_admin:assets
+```
+
+You should also sync these files with their counterparts in the AA source code:
+
+* app/admin/dashboard.rb [~>][dashboard.rb]
+* config/initializers/active_admin.rb [~>][active_admin.rb]
+
+# Gem compatibility
+
+## will_paginate
+
+If you use `will_paginate` in your app, you need to configure an initializer for
+Kaminari to avoid conflicts.
+
+```ruby
+# config/initializers/kaminari.rb
+Kaminari.configure do |config|
+  config.page_method_name = :per_page_kaminari
+end
+```
+
+[CHANGELOG]: https://github.com/gregbell/active_admin/blob/master/CHANGELOG.md
+[dashboard.rb]: https://github.com/gregbell/active_admin/blob/master/lib/generators/active_admin/install/templates/dashboard.rb
+[active_admin.rb]: https://github.com/gregbell/active_admin/blob/master/lib/generators/active_admin/install/templates/active_admin.rb.erb

data/docs/1-general-configuration.md

@@ -0,0 +1,138 @@
+# General Configuration
+
+You can configure Active Admin settings in `config/initializers/active_admin.rb`.
+Here are a few common configurations:
+
+## Authentication
+
+Active Admin requires two settings to authenticate and use the current user
+within your application.
+
++ the method controllers use to force authentication
+
+```ruby
+config.authentication_method = :authenticate_admin_user!
+```
+
++ the method used to access the current user
+
+```ruby
+config.current_user_method = :current_admin_user
+```
+
+Both of these settings can be set to false to turn off authentication.
+
+```ruby
+config.authentication_method = false
+config.current_user_method   = false
+```
+
+## Site Title Options
+
+Every page has what's called the site title on the left side of the menu bar.
+If you want, you can customize it.
+
+```ruby
+config.site_title       = "My Admin Site"
+config.site_title_link  = "/"
+config.site_title_image = "site_image.png"
+config.site_title_image = "http://www.google.com/images/logos/google_logo_41.png"
+```
+
+## Internationalization (I18n)
+
+To translate Active Admin to a new language or customize an existing translation, you can copy
+[config/locales/en.yml](https://github.com/gregbell/active_admin/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/gregbell/active_admin/blob/master/CONTRIBUTING.md)
+
+## Namespaces
+
+When registering resources in Active Admin, they are loaded into a namespace.
+The default namespace is "admin".
+
+```ruby
+# app/admin/posts.rb
+ActiveAdmin.register Post do
+  # ...
+end
+```
+
+The Post resource will be loaded into the "admin" namespace and will be
+available at `/admin/posts`. Each namespace holds on to its own settings that
+inherit from the application's configuration.
+
+For example, if you have two namespaces (`:admin` and `:super_admin`) and want to
+have different site title's for each, you can use the `config.namespace(name)`
+block within the initializer file to configure them individually.
+
+```ruby
+ActiveAdmin.setup do |config|
+  config.site_title = "My Default Site Title"
+
+  config.namespace :admin do |admin|
+    admin.site_title = "Admin Site"
+  end
+
+  config.namespace :super_admin do |super_admin|
+    super_admin.site_title = "Super Admin Site"
+  end
+end
+```
+
+Each setting available in the Active Admin setup block is configurable on a per
+namespace basis.
+
+## Load paths
+
+By default Active Admin files go inside `app/admin/`. You can change this
+directory in the initializer file:
+
+```ruby
+ActiveAdmin.setup do |config|
+  config.load_paths = [File.join(Rails.root, "app", "ui")]
+end
+```
+
+## Comments
+
+By default Active Admin includes comments on resources. Sometimes, this is
+undesired. To disable comments:
+
+```ruby
+# For the entire application:
+ActiveAdmin.setup do |config|
+  config.allow_comments = false
+end
+
+# For a namespace:
+ActiveAdmin.setup do |config|
+  config.namespace :admin do |admin|
+    admin.allow_comments = false
+  end
+end
+
+# For a given resource:
+ActiveAdmin.register Post do
+  config.comments = false
+end
+```
+
+## Utility Navigation
+
+The "utility navigation" shown at the top right normally shows the current user
+and a link to log out. However, the utility navigation is just like any other
+menu in the system; you can provide your own menu to be rendered in its place.
+
+```ruby
+ActiveAdmin.setup do |config|
+  config.namespace :admin do |admin|
+    admin.build_menu :utility_navigation do |menu|
+      menu.add label: "ActiveAdmin.info", url: "http://www.activeadmin.info",
+                                          html_options: { target: :blank }
+      admin.add_current_user_to_menu  menu
+      admin.add_logout_button_to_menu menu
+    end
+  end
+end
+```

data/docs/10-custom-pages.md

@@ -0,0 +1,84 @@
+# Custom Pages
+
+If you have data you want on a standalone page that isn't tied to a resource,
+custom pages provide you with a familiar syntax and feature set:
+
+* a menu item
+* sidebars
+* action items
+* page actions
+
+## Create a new Page
+
+Creating a page is as simple as calling `register_page`:
+
+```ruby
+# app/admin/calendar.rb
+ActiveAdmin.register_page "Calendar" do
+  content do
+    para "Hello World"
+  end
+end
+```
+
+Anything rendered within `content` will be the main content on the page.
+Partials behave exactly the same way as they do for resources:
+
+```ruby
+# app/admin/calendar.rb
+ActiveAdmin.register_page "Calendar" do
+  content do
+    render partial: 'calendar'
+  end
+end
+
+# app/views/admin/calendar/_calendar.html.arb
+table do
+  thead do
+    tr do
+      %w[Sunday Monday Tuesday Wednesday Thursday Friday Saturday].each &method(:th)
+    end
+  end
+  tbody do
+    # ...
+  end
+end
+```
+
+## Customize the Menu
+
+See the [Menu](2-resource-customization.md#customize-the-menu) documentation.
+
+## Add a Sidebar
+
+See the [Sidebars](7-sidebars.md) documentation.
+
+## Add an Action Item
+
+Just like other resources, you can add action items. The difference here being that
+`:only` and `:except` don't apply because there's only one page it could apply to.
+
+```ruby
+action_item do
+  link_to "View Site", "/"
+end
+```
+
+## Add a Page Action
+
+Page actions are custom controller actions (which mirror the resource DSL for the same feature).
+
+```ruby
+page_action :add_event, method: :post do
+  # ...
+  redirect_to admin_calendar_path, notice: "Your event was added"
+end
+
+action_item do
+  link_to "Add Event", admin_calendar_add_event_path, method: :post
+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"

data/docs/11-decorators.md

@@ -0,0 +1,50 @@
+# Decorators
+
+Active Admin allows you to use the decorator pattern to provide view-specific
+versions of a resource. [Draper](https://github.com/drapergem/draper) is
+recommended but not required.
+
+## Example usage
+
+```ruby
+# app/models/post.rb
+class Post < ActiveRecord::Base
+  # has title, content, and image_url
+end
+
+# app/decorators/post_decorator.rb
+class PostDecorator < ApplicationDecorator
+  delegate_all
+
+  def image
+    h.image_tag model.image_url
+  end
+end
+
+# app/admin/post.rb
+ActiveAdmin.register Post do
+  decorate_with PostDecorator
+
+  index do
+    column :title
+    column :image
+    actions
+  end
+end
+```
+
+## Forms
+
+By default, ActiveAdmin does *not* decorate the resource used to render forms.
+If you need ActiveAdmin to decorate the forms, you can pass `decorate: true` to the
+form block.
+
+```ruby
+ActiveAdmin.register Post do
+  decorate_with PostDecorator
+
+  form decorate: true do |f|
+    # ...
+  end
+end
+```