activeadmin 1.0.0 → 1.1.0

data/config/locales/zh-TW.yml

@@ -68,7 +68,6 @@
         one: "成功刪除 1 %{model}"
         other: "成功刪除 %{count} %{plural_model}"
       selection_toggle_explanation: "（切換選取）"
-      link: "建立一個"
       action_label: "%{title} 已選取"
       labels:
         destroy: "刪除"
@@ -78,7 +77,6 @@
       author_type: "作者身份"
       body: "內文"
       author: "作者"
-      title: "評論"
       add: "新增評論"
       delete: "刪除評論"
       delete_confirmation: "你確定要刪除這些評論嗎？"
@@ -126,7 +124,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/config/mdl_style.rb

@@ -0,0 +1,9 @@
+all
+
+exclude_rule "first-header-h1"
+
+exclude_rule "line-length"
+
+rule "no-trailing-punctuation", punctuation: ".,;:!"
+
+exclude_rule "first-line-h1"

data/cucumber.yml

@@ -1,3 +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: CLASS_RELOADING=true --format 'progress' --require features/support/env.rb --require features/step_definitions features --tags @requires-reloading
+default: --format 'progress' --require features/support/regular_env.rb features --tags ~@requires-reloading --tags ~@wip
+wip: --format 'progress' --require features/support/env.rb features --tags @wip:3 --wip features
+class-reloading: CLASS_RELOADING=true --format 'progress' --require features/support/reload_env.rb features --tags @requires-reloading

data/docs/0-installation.md

@@ -1,6 +1,7 @@
 ---
 redirect_from: /docs/0-installation.html
 ---
+
 # Installation
 
 Active Admin is a Ruby Gem.
@@ -22,29 +23,30 @@ 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 use an existing user class, provide it 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.coffee`
+* `app/assets/stylesheets/active_admin.scss`
+* `config/initializers/active_admin.rb`
 
 Now, migrate and seed your database before starting the 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

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,10 +46,12 @@ 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
+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 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.
 
 ## Localize Format For Dates and Times
@@ -140,16 +143,19 @@ 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 }
 ```
@@ -177,6 +183,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,5 @@ 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.

data/docs/11-decorators.md

@@ -1,6 +1,7 @@
 ---
 redirect_from: /docs/11-decorators.html
 ---
+
 # Decorators
 
 Active Admin allows you to use the decorator pattern to provide view-specific

data/docs/12-arbre-components.md

@@ -1,6 +1,7 @@
 ---
 redirect_from: /docs/12-arbre-components.html
 ---
+
 # Arbre Components
 
 Arbre allows the creation of shareable and extendable HTML components and is
@@ -21,7 +22,7 @@ ActiveAdmin.register Post do
         row :id
         row 'Tags' do
           post.tags.each do |tag|
-            a tag, href: admin_post_path(q: {tagged_with_contains: tag})          
+            a tag, href: admin_post_path(q: {tagged_with_contains: tag})
             text_node " ".html_safe
           end
         end
@@ -57,7 +58,7 @@ The Columns component allows you draw content into scalable columns. All you
 need to do is define the number of columns and the component will take care of
 the rest.
 
-#### Simple Columns
+### Simple Columns
 
 To create simple columns, use the `columns` method. Within the block, call
 the #column method to create a new column.
@@ -138,18 +139,15 @@ takes a block.
 Status tags provide convenient syntactic sugar for styling items that have
 status. A common example of where the status tag could be useful is for orders
 that are complete or in progress. `status_tag` takes a status, like
-"In Progress", a type, which defaults to nil, and a hash of options. The
-status_tag will generate html markup that Active Admin css uses in styling.
+"In Progress", and a hash of options. The status_tag will generate HTML markup
+that Active Admin CSS uses in styling.
 
 ```ruby
 status_tag 'In Progress'
 # => <span class='status_tag in_progress'>In Progress</span>
 
-status_tag 'active', :ok
-# => <span class='status_tag active ok'>Active</span>
-
-status_tag 'active', :ok, class: 'important', id: 'status_123', label: 'on'
-# => <span class='status_tag active ok important' id='status_123'>on</span>
+status_tag 'active', class: 'important', id: 'status_123', label: 'on'
+# => <span class='status_tag active important' id='status_123'>on</span>
 ```
 
 ## Tabs

data/docs/13-authorization-adapter.md

@@ -1,6 +1,7 @@
 ---
 redirect_from: /docs/13-authorization-adapter.html
 ---
+
 # Authorization Adapter
 
 Active Admin offers the ability to define and use your own authorization
@@ -40,7 +41,8 @@ application's `config/initializers/active_admin.rb` and add/modify the line:
 config.authorization_adapter = "OnlyAuthorsAuthorization"
 ```
 
-Authorization adapters can be configured per ActiveAdmin namespace as well, for example:
+Authorization adapters can be configured per ActiveAdmin namespace as well, for
+example:
 
 ```ruby
 ActiveAdmin.setup do |config|
@@ -73,9 +75,9 @@ end
 
 ## Scoping Collections in Authorization Adapters
 
-`ActiveAdmin::AuthorizationAdapter` also provides a hook method (`#scope_collection`)
-for the adapter to scope the resource's collection. For example, you may want to
-centralize the scoping:
+`ActiveAdmin::AuthorizationAdapter` also provides a hook method
+(`#scope_collection`) for the adapter to scope the resource's collection. For
+example, you may want to centralize the scoping:
 
 ```ruby
 class OnlyMyAccount < ActiveAdmin::AuthorizationAdapter
@@ -104,7 +106,9 @@ class OnlyDashboard < ActiveAdmin::AuthorizationAdapter
   def authorized?(action, subject = nil)
     case subject
     when ActiveAdmin::Page
-      action == :read && subject.name == "Dashboard" && subject.namespace.name == :admin
+      action == :read &&
+        subject.name == "Dashboard" &&
+        subject.namespace.name == :admin
     else
       false
     end
@@ -116,24 +120,23 @@ end
 
 By default Active Admin simplifies the controller actions into 4 actions:
 
-  * `:read` - This controls if the user can view the menu item as well as the
-    index and show screens.
-  * `:create` - This controls if the user can view the new screen and submit
-    the form to the create action.
-  * `:update` - This controls if the user can view the edit screen and submit
-    the form to the update action.
-  * `:destroy` - This controls if the user can delete a resource.
+* `:read` - This controls if the user can view the menu item as well as the
+  index and show screens.
+* `:create` - This controls if the user can view the new screen and submit
+  the form to the create action.
+* `:update` - This controls if the user can view the edit screen and submit
+  the form to the update action.
+* `:destroy` - This controls if the user can delete a resource.
 
 Each of these actions is available as a constant. Eg: `:read` is available as
 `ActiveAdmin::Authorization::READ`.
 
-
 ## Checking for Authorization in Controllers and Views
 
 Active Admin provides a helper method to check if the current user is
 authorized to perform an action on a subject.
 
-Simply use the `#authorized?(action, subject) method to check.
+Simply use the `#authorized?(action, subject)` method to check.
 
 ```ruby
 ActiveAdmin.register Post do
@@ -187,18 +190,19 @@ initializer:
 config.authorization_adapter = ActiveAdmin::CanCanAdapter
 ```
 
-You can also specify a method to be called on unauthorized access. This is necessary
-in order to prevent a redirect loop that can happen if a user tries to access a page
-they don't have permissions for (see [#2081](https://github.com/activeadmin/activeadmin/issues/2081)).
+You can also specify a method to be called on unauthorized access. This is
+necessary in order to prevent a redirect loop that can happen if a user tries to
+access a page they don't have permissions for (see
+[#2081](https://github.com/activeadmin/activeadmin/issues/2081)).
 
 ```ruby
 config.on_unauthorized_access = :access_denied
 ```
 
-The method `access_denied` would be defined in `application_controller.rb`. Here is one
-example that redirects the user from the page they don't have permission to
-access to a resource they have permission to access (organizations in this case), and
-also displays the error message in the browser:
+The method `access_denied` would be defined in `application_controller.rb`. Here
+is one example that redirects the user from the page they don't have permission
+to access to a resource they have permission to access (organizations in this
+case), and also displays the error message in the browser:
 
 ```ruby
 class ApplicationController < ActionController::Base
@@ -235,11 +239,14 @@ class Ability
 end
 ```
 
-To view more details about the API's, visit project pages of [CanCan](https://github.com/ryanb/cancan) and [CanCanCan](https://github.com/CanCanCommunity/cancancan).
+To view more details about the API's, visit project pages of
+[CanCan](https://github.com/ryanb/cancan) and
+[CanCanCan](https://github.com/CanCanCommunity/cancancan).
 
 ## Using the Pundit Adapter
 
-Active Admin provides an adapter out of the box also for [Pundit](https://github.com/elabs/pundit).
+Active Admin provides an adapter out of the box also for
+[Pundit](https://github.com/elabs/pundit).
 
 To use the Pundit adapter, simply update the configuration in the Active Admin
 initializer:
@@ -248,4 +255,12 @@ initializer:
 config.authorization_adapter = ActiveAdmin::PunditAdapter
 ```
 
-You can simply use Pundit the way that you would expect and Active Admin will use it for authorization. Check Pundit's documentation to [set up Pundit in your application](https://github.com/elabs/pundit#installation). If you want to use batch actions just ensure that `destroy_all?` method is defined in your policy class. You can use this [template policy](https://github.com/activeadmin/activeadmin/blob/master/spec/support/templates/policies/application_policy.rb) in your application instead of default one generated by Pundit's `rails g pundit:install` command.
+You can simply use Pundit the way that you would expect and Active Admin will
+use it for authorization. Check Pundit's documentation to [set up Pundit in your
+application](https://github.com/elabs/pundit#installation). If you want to use
+batch actions just ensure that `destroy_all?` method is defined in your policy
+class. You can use this [template
+policy](https://github.com/activeadmin/activeadmin/blob/master/spec/support/templates/policies/application_policy.rb)
+in your application instead of default one generated by Pundit's `rails g
+pundit:install` command.
+

data/docs/14-gotchas.md

@@ -1,24 +1,29 @@
 ---
 redirect_from: /docs/14-gotchas.html
 ---
-#Gotchas
+
+# Gotchas
 
 ## Security
 
 ### Spreadsheet applications vulnerable to unescaped CSV data
 
-If your CSV export includes untrusted data provided by your users, it's possible that they could include an executable formula that could call arbitrary commands on your computer. See [#4256](https://github.com/activeadmin/activeadmin/issues/4256) for more details.
+If your CSV export includes untrusted data provided by your users, it's possible
+that they could include an executable formula that could call arbitrary commands
+on your computer. See
+[#4256](https://github.com/activeadmin/activeadmin/issues/4256) for more
+details.
 
 ## Session Commits & Asset Pipeline
 
-When configuring the asset pipeline ensure that the asset prefix 
-(`config.assets.prefix`) is not the same as the namespace of ActiveAdmin 
-(default namespace is `/admin`). If they are the same Sprockets will prevent the 
-session from being committed. Flash messages won't work and you will be unable to 
+When configuring the asset pipeline ensure that the asset prefix
+(`config.assets.prefix`) is not the same as the namespace of ActiveAdmin
+(default namespace is `/admin`). If they are the same Sprockets will prevent the
+session from being committed. Flash messages won't work and you will be unable to
 use the session for storing anything.
 
-For more information see the following post: 
-[http://www.intridea.com/blog/2013/3/20/rails-assets-prefix-may-disable-your-session](http://www.intridea.com/blog/2013/3/20/rails-assets-prefix-may-disable-your-session)
+For more information see [the following
+post](http://www.intridea.com/blog/2013/3/20/rails-assets-prefix-may-disable-your-session).
 
 ## Helpers
 
@@ -27,13 +32,14 @@ find a solution.
 
 ### Helpers are not reloading in development
 
-This is a known and still open [issue](https://github.com/activeadmin/activeadmin/issues/697)
-the only way is to restart your server each time you change a helper.
+This is a known and still open
+[issue](https://github.com/activeadmin/activeadmin/issues/697) the only way is
+to restart your server each time you change a helper.
 
 ### Helper maybe not included by default
 
-If you use `config.action_controller.include_all_helpers = false` in your application config, 
-you need to include it by hand.
+If you use `config.action_controller.include_all_helpers = false` in your
+application config, you need to include it by hand.
 
 #### Solutions
 
@@ -62,23 +68,27 @@ end
 
 ## CSS
 
-In order to avoid the override of your application style with the Active Admin one, you can do one of these things:
-* You can properly move the generated file `active_admin.scss` from `app/assets/stylesheets` to `vendor/assets/stylesheets`.
-* You can remove all `require_tree` commands from your root level css files, where the `active_admin.scss` is in the tree.
+In order to avoid the override of your application style with the Active Admin
+one, you can do one of these things:
+
+* You can properly move the generated file `active_admin.scss` from
+  `app/assets/stylesheets` to `vendor/assets/stylesheets`.
+* You can remove all `require_tree` commands from your root level css files,
+  where the `active_admin.scss` is in the tree.
 
 ## Conflicts
 
 ### With gems that provides a `search` class method on a model
 
-If a gem defines a `search` class method on a model, this can result in conflicts 
+If a gem defines a `search` class method on a model, this can result in conflicts
 with the same method provided by `ransack` (a dependency of ActiveAdmin).
 
-Each of this conflicts need to solved is a different way. Some solutions are 
+Each of this conflicts need to solved is a different way. Some solutions are
 listed below.
 
 #### `tire`, `retire` and `elasticsearch-rails`
 
-This conflict can be solved, by using explicitly the `search` method of `tire`, 
+This conflict can be solved, by using explicitly the `search` method of `tire`,
 `retire` or `elasticsearch-rails`:
 
 ##### For `tire` and `retire`
@@ -101,9 +111,12 @@ YourModel.solr_search
 
 ### Rails 5 scaffold generators
 
-Active Admin requires the `inherited_resources` gem which may break scaffolding under Rails 5 as it replaces the default scaffold generator. The solution is to configure the default controller in `config/application.rb` as outlined in [activeadmin/inherited_resources#195](https://github.com/activeadmin/inherited_resources/issues/195)
+Active Admin requires the `inherited_resources` gem which may break scaffolding
+under Rails 5 as it replaces the default scaffold generator. The solution is to
+configure the default controller in `config/application.rb` as outlined in
+[activeadmin/inherited_resources#195](https://github.com/activeadmin/inherited_resources/issues/195)
 
-```
+```ruby
 module SampleApp
   class Application < Rails::Application
     ...
@@ -113,7 +126,13 @@ module SampleApp
 end
 ```
 
-
 ## Authentication & Application Controller
 
-The `ActiveAdmin::BaseController` inherits from the `ApplicationController`. Any authentication method(s) specified in the `ApplicationController` callbacks will be called instead of the authentication method in the active admin config file. For example, if the ApplicationController has a callback `before_action :custom_authentication_method` and the config file's authentication method is `config.authentication_method = :authenticate_active_admin_user`, then `custom_authentication_method` will be called instead of `authenticate_active_admin_user`.
+The `ActiveAdmin::BaseController` inherits from the `ApplicationController`. Any
+authentication method(s) specified in the `ApplicationController` callbacks will
+be called instead of the authentication method in the active admin config file.
+For example, if the ApplicationController has a callback `before_action
+:custom_authentication_method` and the config file's authentication method is
+`config.authentication_method = :authenticate_active_admin_user`, then
+`custom_authentication_method` will be called instead of
+`authenticate_active_admin_user`.