activeadmin 2.9.0 → 3.2.0

data/docs/0-installation.md

@@ -1,142 +0,0 @@
----
-redirect_from: /docs/0-installation.html
----
-
-# Installation
-
-Active Admin is a Ruby Gem.
-
-```ruby
-gem 'activeadmin'
-
-# Plus integrations with:
-gem 'devise'
-gem 'cancancan'
-gem 'draper'
-gem 'pundit'
-```
-
-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. Here are your options:
-
-* 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:
-
-  ```sh
-  rails g active_admin:install User
-  ```
-
-* 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`
-* `app/assets/stylesheets/active_admin.scss`
-* `config/initializers/active_admin.rb`
-
-Now, migrate and seed your database before starting the server:
-
-```sh
-rails db:migrate
-rails db:seed
-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
-```
-
-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
-```
-
-## simple_form
-
-If you're getting the error `wrong number of arguments (6 for 4..5)`, [read #2703].
-
-## webpacker
-
-For new apps starting with Rails 6.0, Webpacker has become the default asset generator. 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
-[read #2703]: https://github.com/activeadmin/activeadmin/issues/2703#issuecomment-38140864

data/docs/1-general-configuration.md

@@ -1,224 +0,0 @@
----
-redirect_from: /docs/1-general-configuration.html
----
-
-# 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 used 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"
-config.site_title_image = ->(context) { context.current_user.company.logo_url }
-```
-
-## Internationalization (I18n)
-
-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)!
-
-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
-
-Active Admin sets `:long` as default localize format for dates and times.
-If you want, you can customize it.
-
-```ruby
-config.localize_format = :short
-```
-
-## 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
-```
-
-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.
-
-## 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.comments = false
-end
-
-# For a namespace:
-ActiveAdmin.setup do |config|
-  config.namespace :admin do |admin|
-    admin.comments = false
-  end
-end
-
-# For a given resource:
-ActiveAdmin.register Post do
-  config.comments = false
-end
-```
-
-You can change the name under which comments are registered:
-
-```ruby
-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
-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
-```
-
-## Footer Customization
-
-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,150 +0,0 @@
----
-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,
-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.
-
-## Customize the breadcrumbs
-
-```ruby
-ActiveAdmin.register_page "Calendar" do
-  breadcrumb do
-    ['admin', 'calendar']
-  end
-end
-```
-
-## Customize the Namespace
-
-We use the `admin` namespace by default, but you can use anything:
-
-```ruby
-# Available at /today/calendar
-ActiveAdmin.register_page "Calendar", namespace: :today
-
-# Available at /calendar
-ActiveAdmin.register_page "Calendar", namespace: false
-```
-
-## Belongs To
-
-To nest the page within another resource, you can use the `belongs_to` method:
-
-```ruby
-ActiveAdmin.register Project
-ActiveAdmin.register_page "Status" do
-  belongs_to :project
-end
-```
-
-See also the [Belongs To](2-resource-customization.md#belongs-to) documentation
-and examples.
-
-## 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 :view_site 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 :add 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"
-
-Page actions can handle multiple HTTP verbs.
-
-```ruby
-page_action :add_event, method: [:get, :post] do
-  # ...
-end
-```
-
-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

data/docs/11-decorators.md

@@ -1,70 +0,0 @@
----
-redirect_from: /docs/11-decorators.html
----
-
-# 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 < Draper::Decorator
-  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
-```
-
-You can pass any decorator class as an argument to `decorate_with`
-as long as it accepts the record to be decorated as a parameter in
-the initializer, and responds to all the necessary methods.
-
-```ruby
-# app/decorators/post_decorator.rb
-class PostDecorator
-  attr_reader :post
-  delegate_missing_to :post
-
-  def initialize(post)
-    @post = post
-  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
-```