Class: ActiveAdmin::Namespace
- Inherits:
-
Object
- Object
- ActiveAdmin::Namespace
- Defined in:
- lib/active_admin/namespace.rb
Overview
Namespaces are the basic organizing principle for resources within Active Admin
Each resource is registered into a namespace which defines:
* the namespaceing for routing
* the module to namespace controllers
* the menu which gets displayed (other resources in the same namespace)
For example:
ActiveAdmin.register Post, :namespace => :admin
Will register the Post model into the “admin” namespace. This will namespace the urls for the resource to “/admin/posts” and will set the controller to Admin::PostsController
You can also register to the “root” namespace, which is to say no namespace at all.
ActiveAdmin.register Post, :namespace => false
This will register the resource to an instantiated namespace called :root. The resource will be accessible from “/posts” and the controller will be PostsController.
Constant Summary collapse
- RegisterEvent =
'active_admin.namespace.register'.freeze
Instance Attribute Summary collapse
-
#application ⇒ Object
readonly
Returns the value of attribute application.
-
#menus ⇒ Object
readonly
Returns the value of attribute menus.
-
#name ⇒ Object
readonly
Returns the value of attribute name.
-
#resources ⇒ Object
readonly
Returns the value of attribute resources.
Instance Method Summary collapse
-
#add_logout_button_to_menu(menu, priority = 100, html_options = {}) ⇒ Object
Add the default logout button to the menu, using the ActiveAdmin configuration settings.
-
#build_default_utility_nav ⇒ Object
protected
Builds the default utility navigation in top right header with current user & logout button.
-
#build_menu(name = DEFAULT_MENU, &block) ⇒ Object
Add a callback to be ran when we build the menu.
- #build_menu_collection ⇒ Object protected
- #build_page(name, options) ⇒ Object protected
- #fetch_menu(name) ⇒ Object
-
#find_or_build_resource(resource_class, options) ⇒ Object
protected
Either returns an existing Resource instance or builds a new one for the resource and options.
-
#initialize(application, name) ⇒ Namespace
constructor
A new instance of Namespace.
-
#module_name ⇒ Object
Returns the name of the module if required.
- #parse_page_registration_block(config, &block) ⇒ Object protected
- #parse_registration_block(config, &block) ⇒ Object protected
-
#read_default_setting(name) ⇒ Object
Override from ActiveAdmin::Settings to inherit default attributes from the application.
-
#register(resource_class, options = {}, &block) ⇒ Object
Register a resource into this namespace.
-
#register_module ⇒ Object
protected
Creates a ruby module to namespace all the classes in if required.
- #register_page(name, options = {}, &block) ⇒ Object
- #register_page_controller(config) ⇒ Object protected
- #register_resource_controller(config) ⇒ Object protected
- #reset_menu! ⇒ Object
-
#resource_for(klass) ⇒ Object
Returns the first registered ActiveAdmin::Resource instance for a given class.
- #root? ⇒ Boolean
-
#unload! ⇒ Object
Unload all the registered resources for this namespace.
- #unload_resources! ⇒ Object protected
Constructor Details
#initialize(application, name) ⇒ Namespace
Returns a new instance of Namespace.
32 33 34 35 36 37 38 |
# File 'lib/active_admin/namespace.rb', line 32 def initialize(application, name) @application = application @name = name.to_s.underscore.to_sym @resources = ResourceCollection.new register_module unless root? end |
Instance Attribute Details
#application ⇒ Object (readonly)
Returns the value of attribute application.
30 31 32 |
# File 'lib/active_admin/namespace.rb', line 30 def application @application end |
#menus ⇒ Object (readonly)
Returns the value of attribute menus.
30 31 32 |
# File 'lib/active_admin/namespace.rb', line 30 def @menus end |
#name ⇒ Object (readonly)
Returns the value of attribute name.
30 31 32 |
# File 'lib/active_admin/namespace.rb', line 30 def name @name end |
#resources ⇒ Object (readonly)
Returns the value of attribute resources.
30 31 32 |
# File 'lib/active_admin/namespace.rb', line 30 def resources @resources end |
Instance Method Details
#add_logout_button_to_menu(menu, priority = 100, html_options = {}) ⇒ Object
Add the default logout button to the menu, using the ActiveAdmin configuration settings
131 132 133 134 135 136 137 138 139 140 141 |
# File 'lib/active_admin/namespace.rb', line 131 def (, priority=100, ={}) if logout_link_path logout_method = logout_link_method || :get .add :id => 'logout', :priority => priority, :label => proc{ I18n.t('active_admin.logout') }, :html_options => .reverse_merge(:method => logout_method), :url => proc{ render_or_call_method_or_proc_on self, active_admin_namespace.logout_link_path }, :if => proc{ current_active_admin_user? } end end |
#build_default_utility_nav ⇒ Object (protected)
Builds the default utility navigation in top right header with current user & logout button
158 159 160 161 162 163 164 165 166 167 168 |
# File 'lib/active_admin/namespace.rb', line 158 def build_default_utility_nav return if @menus.exists? :utility_navigation @menus. :utility_navigation do || .add :label => proc{ display_name current_active_admin_user }, :url => proc{ url_for [active_admin_namespace.name, current_active_admin_user] rescue '#' }, :id => 'current_user', :if => proc{ current_active_admin_user? } end end |
#build_menu(name = DEFAULT_MENU, &block) ⇒ Object
Add a callback to be ran when we build the menu
116 117 118 119 120 121 122 |
# File 'lib/active_admin/namespace.rb', line 116 def (name = DEFAULT_MENU, &block) @menus.before_build do || . name do || block.call() end end end |
#build_menu_collection ⇒ Object (protected)
145 146 147 148 149 150 151 152 153 154 155 |
# File 'lib/active_admin/namespace.rb', line 145 def @menus = MenuCollection.new @menus.on_build do || build_default_utility_nav resources.each do |resource| resource.(@menus) end end end |
#build_page(name, options) ⇒ Object (protected)
176 177 178 |
# File 'lib/active_admin/namespace.rb', line 176 def build_page(name, ) resources.add Page.new(self, name, ) end |
#fetch_menu(name) ⇒ Object
102 103 104 |
# File 'lib/active_admin/namespace.rb', line 102 def (name) @menus.fetch(name) end |
#find_or_build_resource(resource_class, options) ⇒ Object (protected)
Either returns an existing Resource instance or builds a new one for the resource and options
172 173 174 |
# File 'lib/active_admin/namespace.rb', line 172 def find_or_build_resource(resource_class, ) resources.add Resource.new(self, resource_class, ) end |
#module_name ⇒ Object
80 81 82 83 |
# File 'lib/active_admin/namespace.rb', line 80 def module_name return nil if root? @module_name ||= name.to_s.camelize end |
#parse_page_registration_block(config, &block) ⇒ Object (protected)
216 217 218 |
# File 'lib/active_admin/namespace.rb', line 216 def parse_page_registration_block(config, &block) PageDSL.new(config).run_registration_block(&block) end |
#parse_registration_block(config, &block) ⇒ Object (protected)
211 212 213 214 |
# File 'lib/active_admin/namespace.rb', line 211 def parse_registration_block(config, &block) config.dsl = ResourceDSL.new(config) config.dsl.run_registration_block(&block) end |
#read_default_setting(name) ⇒ Object
Override from ActiveAdmin::Settings to inherit default attributes from the application
98 99 100 |
# File 'lib/active_admin/namespace.rb', line 98 def read_default_setting(name) application.send(name) end |
#register(resource_class, options = {}, &block) ⇒ Object
Register a resource into this namespace. The preffered method to access this is to use the global registration ActiveAdmin.register which delegates to the proper namespace instance.
43 44 45 46 47 48 49 50 51 52 53 54 55 56 |
# File 'lib/active_admin/namespace.rb', line 43 def register(resource_class, = {}, &block) config = find_or_build_resource(resource_class, ) # Register the resource register_resource_controller(config) parse_registration_block(config, &block) if block_given? # Dispatch a registration event ActiveAdmin::Event.dispatch ActiveAdmin::Resource::RegisterEvent, config # Return the config config end |
#register_module ⇒ Object (protected)
Creates a ruby module to namespace all the classes in if required
202 203 204 |
# File 'lib/active_admin/namespace.rb', line 202 def register_module eval "module ::#{module_name}; end" end |
#register_page(name, options = {}, &block) ⇒ Object
58 59 60 61 62 63 64 65 66 67 |
# File 'lib/active_admin/namespace.rb', line 58 def register_page(name, = {}, &block) config = build_page(name, ) # Register the resource register_page_controller(config) parse_page_registration_block(config, &block) if block_given? config end |
#register_page_controller(config) ⇒ Object (protected)
180 181 182 183 |
# File 'lib/active_admin/namespace.rb', line 180 def register_page_controller(config) eval "class ::#{config.controller_name} < ActiveAdmin::PageController; end" config.controller.active_admin_config = config end |
#register_resource_controller(config) ⇒ Object (protected)
206 207 208 209 |
# File 'lib/active_admin/namespace.rb', line 206 def register_resource_controller(config) eval "class ::#{config.controller_name} < ActiveAdmin::ResourceController; end" config.controller.active_admin_config = config end |
#reset_menu! ⇒ Object
106 107 108 |
# File 'lib/active_admin/namespace.rb', line 106 def @menus.clear! end |
#resource_for(klass) ⇒ Object
Returns the first registered ActiveAdmin::Resource instance for a given class
92 93 94 |
# File 'lib/active_admin/namespace.rb', line 92 def resource_for(klass) resources[klass] end |
#root? ⇒ Boolean
69 70 71 |
# File 'lib/active_admin/namespace.rb', line 69 def root? name == :root end |
#unload! ⇒ Object
Unload all the registered resources for this namespace
86 87 88 89 |
# File 'lib/active_admin/namespace.rb', line 86 def unload! unload_resources! end |
#unload_resources! ⇒ Object (protected)
185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 |
# File 'lib/active_admin/namespace.rb', line 185 def unload_resources! resources.each do |resource| parent = (module_name || 'Object').constantize const_name = resource.controller_name.split('::').last # Remove the const if its been defined parent.send(:remove_const, const_name) if parent.const_defined?(const_name) # Remove circular references resource.controller.active_admin_config = nil if resource.is_a?(Resource) && resource.dsl resource.dsl.run_registration_block { @config = nil } end end @resources = ResourceCollection.new end |