Module: RailsAdmin::Config
- Defined in:
- lib/rails_admin/config.rb,
lib/rails_admin/config/model.rb,
lib/rails_admin/config/fields.rb,
lib/rails_admin/config/actions.rb,
lib/rails_admin/config/hideable.rb,
lib/rails_admin/config/sections.rb,
lib/rails_admin/config/groupable.rb,
lib/rails_admin/config/proxyable.rb,
lib/rails_admin/config/has_fields.rb,
lib/rails_admin/config/has_groups.rb,
lib/rails_admin/config/lazy_model.rb,
lib/rails_admin/config/actions/new.rb,
lib/rails_admin/config/fields/base.rb,
lib/rails_admin/config/actions/base.rb,
lib/rails_admin/config/actions/edit.rb,
lib/rails_admin/config/actions/show.rb,
lib/rails_admin/config/configurable.rb,
lib/rails_admin/config/fields/group.rb,
lib/rails_admin/config/fields/types.rb,
lib/rails_admin/config/actions/index.rb,
lib/rails_admin/config/sections/base.rb,
lib/rails_admin/config/sections/edit.rb,
lib/rails_admin/config/sections/list.rb,
lib/rails_admin/config/sections/show.rb,
lib/rails_admin/config/actions/delete.rb,
lib/rails_admin/config/actions/export.rb,
lib/rails_admin/config/sections/modal.rb,
lib/rails_admin/config/proxyable/proxy.rb,
lib/rails_admin/config/sections/create.rb,
lib/rails_admin/config/sections/export.rb,
lib/rails_admin/config/sections/nested.rb,
lib/rails_admin/config/sections/update.rb,
lib/rails_admin/config/actions/dashboard.rb,
lib/rails_admin/config/fields/types/date.rb,
lib/rails_admin/config/fields/types/enum.rb,
lib/rails_admin/config/fields/types/text.rb,
lib/rails_admin/config/fields/types/time.rb,
lib/rails_admin/config/fields/association.rb,
lib/rails_admin/config/fields/types/color.rb,
lib/rails_admin/config/fields/types/float.rb,
lib/rails_admin/config/actions/bulk_delete.rb,
lib/rails_admin/config/actions/show_in_app.rb,
lib/rails_admin/config/fields/types/hidden.rb,
lib/rails_admin/config/fields/types/string.rb,
lib/rails_admin/config/actions/history_show.rb,
lib/rails_admin/config/fields/types/boolean.rb,
lib/rails_admin/config/fields/types/decimal.rb,
lib/rails_admin/config/fields/types/integer.rb,
lib/rails_admin/config/actions/history_index.rb,
lib/rails_admin/config/fields/types/datetime.rb,
lib/rails_admin/config/fields/types/password.rb,
lib/rails_admin/config/fields/types/ck_editor.rb,
lib/rails_admin/config/fields/types/dragonfly.rb,
lib/rails_admin/config/fields/types/paperclip.rb,
lib/rails_admin/config/fields/types/timestamp.rb,
lib/rails_admin/config/fields/types/wysihtml5.rb,
lib/rails_admin/config/fields/types/serialized.rb,
lib/rails_admin/config/fields/types/carrierwave.rb,
lib/rails_admin/config/fields/types/code_mirror.rb,
lib/rails_admin/config/fields/types/file_upload.rb,
lib/rails_admin/config/fields/types/bson_object_id.rb,
lib/rails_admin/config/fields/types/has_one_association.rb,
lib/rails_admin/config/fields/types/has_many_association.rb,
lib/rails_admin/config/fields/types/belongs_to_association.rb,
lib/rails_admin/config/fields/types/polymorphic_association.rb,
lib/rails_admin/config/fields/types/has_and_belongs_to_many_association.rb
Defined Under Namespace
Modules: Actions, Configurable, Fields, Groupable, HasFields, HasGroups, Hideable, Proxyable, Sections Classes: LazyModel, Model
Constant Summary collapse
- DEFAULT_AUTHENTICATION =
RailsAdmin is setup to try and authenticate with warden If warden is found, then it will try to authenticate
This is valid for custom warden setups, and also devise If you’re using the admin setup for devise, you should set RailsAdmin to use the admin
Proc.new do request.env['warden'].try(:authenticate!) end
- DEFAULT_AUTHORIZE =
Proc.new {}
- DEFAULT_AUDIT =
Proc.new {}
- DEFAULT_CURRENT_USER =
Proc.new do request.env["warden"].try(:user) || respond_to?(:current_user) && current_user end
Class Attribute Summary collapse
-
.compact_show_view ⇒ Object
hide blank fields in show view if true.
-
.default_hidden_fields ⇒ Object
Fields to be hidden in show, create and update views.
-
.default_items_per_page ⇒ Object
Default items per page value used if a model level option has not been configured.
-
.default_search_operator ⇒ Object
Returns the value of attribute default_search_operator.
-
.excluded_models ⇒ Object
Configuration option to specify which models you want to exclude.
-
.included_models ⇒ Object
Configuration option to specify a whitelist of models you want to RailsAdmin to work with.
-
.label_methods ⇒ Object
Configuration option to specify which method names will be searched for to be used as a label for object records.
-
.main_app_name ⇒ Object
Application title, can be an array of two elements.
-
.navigation_static_label ⇒ Object
Returns the value of attribute navigation_static_label.
-
.navigation_static_links ⇒ Object
accepts a hash of static links to be shown below the main navigation.
-
.registry ⇒ Object
readonly
Stores model configuration objects in a hash identified by model’s class name.
-
.total_columns_width ⇒ Object
Set the max width of columns in list view before a new set is created.
-
.yell_for_non_accessible_fields ⇒ Object
yell about fields that are not marked as accessible.
Class Method Summary collapse
-
.actions(&block) ⇒ Object
Returns action configuration object.
-
.audit_with(*args, &block) ⇒ Object
Setup auditing/history/versioning provider that observe objects lifecycle.
-
.authenticate_with(&blk) ⇒ Object
Setup authentication to be run as a before filter This is run inside the controller instance so you can setup any authentication you need to.
-
.authorize_with(*args, &block) ⇒ Object
Setup authorization to be run as a before filter This is run inside the controller instance so you can setup any authorization you need to.
-
.configure_with(extension) {|configuration| ... } ⇒ Object
Setup configuration using an extension-provided ConfigurationAdapter.
-
.current_user_method(&block) ⇒ Object
Setup a different method to determine the current user or admin logged in.
-
.model(entity, &block) ⇒ Object
Loads a model configuration instance from the registry or registers a new one if one is yet to be added.
-
.models ⇒ Object
Returns all model configurations.
-
.models_pool ⇒ Object
pool of all found model names from the whole application.
-
.reset ⇒ Object
Reset all configurations to defaults.
-
.reset_model(model) ⇒ Object
Reset a provided model’s configuration.
-
.visible_models(bindings) ⇒ Object
Get all models that are configured as visible sorted by their weight and label.
Class Attribute Details
.compact_show_view ⇒ Object
hide blank fields in show view if true
56 57 58 |
# File 'lib/rails_admin/config.rb', line 56 def compact_show_view @compact_show_view end |
.default_hidden_fields ⇒ Object
Fields to be hidden in show, create and update views
43 44 45 |
# File 'lib/rails_admin/config.rb', line 43 def default_hidden_fields @default_hidden_fields end |
.default_items_per_page ⇒ Object
Default items per page value used if a model level option has not been configured
47 48 49 |
# File 'lib/rails_admin/config.rb', line 47 def default_items_per_page @default_items_per_page end |
.default_search_operator ⇒ Object
Returns the value of attribute default_search_operator.
49 50 51 |
# File 'lib/rails_admin/config.rb', line 49 def default_search_operator @default_search_operator end |
.excluded_models ⇒ Object
Configuration option to specify which models you want to exclude.
33 34 35 |
# File 'lib/rails_admin/config.rb', line 33 def excluded_models @excluded_models end |
.included_models ⇒ Object
Configuration option to specify a whitelist of models you want to RailsAdmin to work with. The excluded_models list applies against the whitelist as well and further reduces the models RailsAdmin will use. If included_models is left empty ([]), then RailsAdmin will automatically use all the models in your application (less any excluded_models you may have specified).
40 41 42 |
# File 'lib/rails_admin/config.rb', line 40 def included_models @included_models end |
.label_methods ⇒ Object
Configuration option to specify which method names will be searched for to be used as a label for object records. This defaults to [:name, :title]
53 54 55 |
# File 'lib/rails_admin/config.rb', line 53 def label_methods @label_methods end |
.main_app_name ⇒ Object
Application title, can be an array of two elements
30 31 32 |
# File 'lib/rails_admin/config.rb', line 30 def main_app_name @main_app_name end |
.navigation_static_label ⇒ Object
Returns the value of attribute navigation_static_label.
69 70 71 |
# File 'lib/rails_admin/config.rb', line 69 def @navigation_static_label end |
.navigation_static_links ⇒ Object
accepts a hash of static links to be shown below the main navigation
68 69 70 |
# File 'lib/rails_admin/config.rb', line 68 def @navigation_static_links end |
.registry ⇒ Object (readonly)
Stores model configuration objects in a hash identified by model’s class name.
65 66 67 |
# File 'lib/rails_admin/config.rb', line 65 def registry @registry end |
.total_columns_width ⇒ Object
Set the max width of columns in list view before a new set is created
59 60 61 |
# File 'lib/rails_admin/config.rb', line 59 def total_columns_width @total_columns_width end |
.yell_for_non_accessible_fields ⇒ Object
yell about fields that are not marked as accessible
72 73 74 |
# File 'lib/rails_admin/config.rb', line 72 def yell_for_non_accessible_fields @yell_for_non_accessible_fields end |
Class Method Details
.actions(&block) ⇒ Object
Returns action configuration object
243 244 245 |
# File 'lib/rails_admin/config.rb', line 243 def actions(&block) RailsAdmin::Config::Actions.instance_eval(&block) if block end |
.audit_with(*args, &block) ⇒ Object
Setup auditing/history/versioning provider that observe objects lifecycle
103 104 105 106 107 108 109 110 111 112 113 |
# File 'lib/rails_admin/config.rb', line 103 def audit_with(*args, &block) extension = args.shift if(extension) @audit = Proc.new { @auditing_adapter = RailsAdmin::AUDITING_ADAPTERS[extension].new(*([self] + args).compact) } else @audit = block if block end @audit || DEFAULT_AUDIT end |
.authenticate_with(&blk) ⇒ Object
Setup authentication to be run as a before filter This is run inside the controller instance so you can setup any authentication you need to
By default, the authentication will run via warden if available and will run the default.
If you use devise, this will authenticate the same as authenticate_user!
97 98 99 100 |
# File 'lib/rails_admin/config.rb', line 97 def authenticate_with(&blk) @authenticate = blk if blk @authenticate || DEFAULT_AUTHENTICATION end |
.authorize_with(*args, &block) ⇒ Object
Setup authorization to be run as a before filter This is run inside the controller instance so you can setup any authorization you need to.
By default, there is no authorization.
To use an authorization adapter, pass the name of the adapter. For example, to use with CanCan, pass it like this.
See the wiki for more on authorization.
138 139 140 141 142 143 144 145 146 147 148 |
# File 'lib/rails_admin/config.rb', line 138 def (*args, &block) extension = args.shift if(extension) @authorize = Proc.new { @authorization_adapter = RailsAdmin::AUTHORIZATION_ADAPTERS[extension].new(*([self] + args).compact) } else @authorize = block if block end @authorize || DEFAULT_AUTHORIZE end |
.configure_with(extension) {|configuration| ... } ⇒ Object
Setup configuration using an extension-provided ConfigurationAdapter
162 163 164 165 |
# File 'lib/rails_admin/config.rb', line 162 def configure_with(extension) configuration = RailsAdmin::CONFIGURATION_ADAPTERS[extension].new yield(configuration) if block_given? end |
.current_user_method(&block) ⇒ Object
Setup a different method to determine the current user or admin logged in. This is run inside the controller instance and made available as a helper.
By default, _request.env.user_ or current_user will be used.
180 181 182 183 |
# File 'lib/rails_admin/config.rb', line 180 def current_user_method(&block) @current_user = block if block @current_user || DEFAULT_CURRENT_USER end |
.model(entity, &block) ⇒ Object
Loads a model configuration instance from the registry or registers a new one if one is yet to be added.
First argument can be an instance of requested model, its class object, its class name as a string or symbol or a RailsAdmin::AbstractModel instance.
If a block is given it is evaluated in the context of configuration instance.
Returns given model’s configuration
212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 |
# File 'lib/rails_admin/config.rb', line 212 def model(entity, &block) key = begin if entity.kind_of?(RailsAdmin::AbstractModel) entity.model.try(:name).try :to_sym elsif entity.kind_of?(Class) entity.name.to_sym elsif entity.kind_of?(String) || entity.kind_of?(Symbol) entity.to_sym else entity.class.name.to_sym end end if block @registry[key] = RailsAdmin::Config::LazyModel.new(entity, &block) else @registry[key] ||= RailsAdmin::Config::LazyModel.new(entity) end end |
.models ⇒ Object
Returns all model configurations
250 251 252 |
# File 'lib/rails_admin/config.rb', line 250 def models RailsAdmin::AbstractModel.all.map{|m| model(m)} end |
.models_pool ⇒ Object
pool of all found model names from the whole application
194 195 196 197 198 |
# File 'lib/rails_admin/config.rb', line 194 def models_pool excluded = (excluded_models.map(&:to_s) + ['RailsAdmin::History']) (viable_models - excluded).uniq.sort end |
.reset ⇒ Object
Reset all configurations to defaults.
257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 |
# File 'lib/rails_admin/config.rb', line 257 def reset @compact_show_view = true @yell_for_non_accessible_fields = true @authenticate = nil @authorize = nil @audit = nil @current_user = nil @default_hidden_fields = {} @default_hidden_fields[:base] = [:_type] @default_hidden_fields[:edit] = [:id, :_id, :created_at, :created_on, :deleted_at, :updated_at, :updated_on, :deleted_on] @default_hidden_fields[:show] = [:id, :_id, :created_at, :created_on, :deleted_at, :updated_at, :updated_on, :deleted_on] @default_items_per_page = 20 @default_search_operator = 'default' @attr_accessible_role = nil @excluded_models = [] @included_models = [] @total_columns_width = 697 @label_methods = [:name, :title] @main_app_name = Proc.new { [Rails.application.engine_name.titleize.chomp(' Application'), 'Admin'] } @registry = {} @navigation_static_links = {} @navigation_static_label = nil RailsAdmin::Config::Actions.reset end |
.reset_model(model) ⇒ Object
Reset a provided model’s configuration.
285 286 287 288 |
# File 'lib/rails_admin/config.rb', line 285 def reset_model(model) key = model.kind_of?(Class) ? model.name.to_sym : model.to_sym @registry.delete(key) end |
.visible_models(bindings) ⇒ Object
Get all models that are configured as visible sorted by their weight and label.
294 295 296 297 298 299 300 301 302 |
# File 'lib/rails_admin/config.rb', line 294 def visible_models(bindings) visible_models_with_bindings(bindings).sort do |a, b| if (weight_order = a.weight <=> b.weight) == 0 a.label.downcase <=> b.label.downcase else weight_order end end end |