class ActiveAdmin::DSL
The Active Admin DSL
. This class is where all the registration blocks are evaluated. This is the central place for the API given to users of Active Admin.
Public Class Methods
Source
# File lib/active_admin/dsl.rb, line 10 def initialize(config) @config = config end
Public Instance Methods
Source
# File lib/active_admin/dsl.rb, line 87 def action_item(name, options = {}, &block) config.add_action_item(name, options, &block) end
Add a new action item to the resource
@param [Symbol] name @param [Hash] options valid keys include:
:only: A single or array of controller actions to display this action item on. :except: A single or array of controller actions not to display this action item on.
Source
# File lib/active_admin/dsl.rb, line 102 def batch_action(title, options = {}, &block) # Create symbol & title information if title.is_a? String sym = title.titleize.tr(" ", "").underscore.to_sym else sym = title title = sym.to_s.titleize end # Either add/remove the batch action unless options == false config.add_batch_action(sym, title, options, &block) else config.remove_batch_action sym end end
Add a new batch action item to the resource Provide a symbol/string to register the action, options, & block to execute on request
To unregister an existing action, just provide the symbol & pass false as the second param
@param [Symbol or String] title @param [Hash] options valid keys include:
> :if is a proc that will be called to determine if the BatchAction
should be displayed¶ ↑
> :sort_order is used to sort the batch actions ascending¶ ↑
> :confirm is a string which the user will have to accept in order to process the action¶ ↑
Source
# File lib/active_admin/dsl.rb, line 29 def config @config end
The instance of ActiveAdmin::Resource
that’s being registered currently. You can use this within your registration blocks to modify options:
eg:
ActiveAdmin.register Post do config.sort_order = "id_desc" end
Source
# File lib/active_admin/dsl.rb, line 74 def controller(&block) @config.controller.class_exec(&block) if block_given? @config.controller end
Returns the controller for this resource. If you pass a block, it will be evaluated in the controller.
Example:
ActiveAdmin.register Post do controller do def some_method_on_controller # Method gets added to Admin::PostsController end end end
Source
# File lib/active_admin/dsl.rb, line 55 def include(mod) mod.included(self) end
Include a module with this resource. The modules’s ‘included` method is called with the instance of the `ActiveAdmin::DSL` passed into it.
eg:
module HelpSidebar def self.included(dsl) dsl.sidebar "Help" do "Call us for Help" end end end ActiveAdmin.register Post do include HelpSidebar end
@param [Module] mod A module to include
@return [Nil]
Source
# File lib/active_admin/dsl.rb, line 15 def run_registration_block(&block) instance_exec &block if block_given? end
Runs the registration block inside this object