Class: Alchemy::Resource
- Inherits:
-
Object
- Object
- Alchemy::Resource
- Defined in:
- lib/alchemy/resource.rb
Overview
Alchemy::Resource
Used to DRY up resource like structures in Alchemy’s admin backend. So far Language, User and Tag already uses this.
It provides convenience methods to create an admin interface without further knowledge about the model and the controller (it’s instantiated with controller_path at least and guesses the model accordingly)
For examples how to use in controllers see Alchemy::ResourcesController or inherit from it directly.
Naming Conventions
As Rails’ form helpers, path helpers, etc. and declarative authorization rely on controller_path even if the model class is named differently (or sits in another namespace) model and controller are handled separatly here. Therefore “resource” always refers to the controller_path whereas “model” refers to the model class.
Skip attributes
Usually you don’t want your users to see and edit all attributes provided by a model. Hence some default attributes, namely id, updated_at, created_at, creator_id and updater_id are not returned by Resource#attributes.
If you want to skip a different set of attributes just define a skipped_alchemy_resource_attributes
class method in your model class that returns an array of strings.
Example
def self.skipped_alchemy_resource_attributes
%w(id updated_at secret_token remote_ip)
end
Restrict attributes
Beside skipping certain attributes you can also restrict them. Restricted attributes can not be edited by the user but still be seen in the index view. No attributes are restricted by default.
Example
def self.restricted_alchemy_resource_attributes
%w(synced_at remote_record_id)
end
Searchable attributes
By default all :text and :string based attributes are searchable in the admin interface. You can overwrite this behaviour by providing a set of attribute names that should be searchable instead.
Example
def self.searchable_alchemy_resource_attributes
%w(remote_record_id firstname lastname age)
end
Resource relations
Alchemy::Resource can take care of ActiveRecord relations.
BelongsTo Relations
For belongs_to associations you will have to define a alchemy_resource_relations
class method in your model class:
def self.alchemy_resource_relations
{
location: {attr_method: 'name', attr_type: 'string'},
organizer: {attr_method: 'name', attr_type: 'string'}
}
end
With this knowledge Resource#attributes will return location#name and organizer#name instead of location_id and organizer_id. Refer to Alchemy::ResourcesController for further details on usage.
Creation
Resource needs a controller_path at least. Without other arguments it will guess the model name from it and assume that the model doesn’t live in an engine. Moreover model and controller has to follow Rails’ naming convention:
Event -> EventsController
It will also strip “admin” automatically, so this is also valid:
Event -> Admin::EventsController
If your Resource and it’s controllers are part of an engine you need to provide Alchemy’s module_definition, so resource can provide the correct url_proxy. If you don’t declare it in Alchemy, you need at least provide the following hash (i.e. if your engine is named EventEngine):
resource = Resource.new(controller_path, {"engine_name" => "event_engine"})
If you don’t want to stick with these conventions you can separate model and controller by providing a model class (for example used by Alchemy’s Tags admin interface):
resource = Resource.new('/admin/tags', {"engine_name"=>"alchemy"}, Gutentag::Tag)
Constant Summary collapse
- DEFAULT_SKIPPED_ATTRIBUTES =
%w(id updated_at created_at creator_id updater_id)
- DEFAULT_SKIPPED_ASSOCIATIONS =
%w(creator updater)
- SEARCHABLE_COLUMN_TYPES =
[:string, :text]
Instance Attribute Summary collapse
-
#model ⇒ Object
readonly
Returns the value of attribute model.
-
#model_associations ⇒ Object
Returns the value of attribute model_associations.
-
#resource_relations ⇒ Object
Returns the value of attribute resource_relations.
Instance Method Summary collapse
- #attributes ⇒ Object
- #editable_attributes ⇒ Object
- #engine_name ⇒ Object
-
#help_text_for(attribute) ⇒ Object
Returns a help text for resource’s form.
- #in_engine? ⇒ Boolean
-
#initialize(controller_path, module_definition = nil, custom_model = nil) ⇒ Resource
constructor
A new instance of Resource.
-
#model_association_names ⇒ Object
Returns an array of underscored association names.
- #namespace_for_scope ⇒ Object
- #namespaced_resource_name ⇒ Object
- #namespaced_resources_name ⇒ Object
- #resource_array ⇒ Object
- #resource_name ⇒ Object
- #resources_name ⇒ Object
-
#restricted_attributes ⇒ Object
Return attributes that should be viewable but not editable.
-
#search_field_name ⇒ Object
Search field input name.
-
#searchable_attribute_names ⇒ Object
Returns all attribute names that are searchable in the admin interface.
-
#skipped_attributes ⇒ Object
Return attributes that should neither be viewable nor editable.
Constructor Details
#initialize(controller_path, module_definition = nil, custom_model = nil) ⇒ Resource
Returns a new instance of Resource.
108 109 110 111 112 113 114 115 116 117 118 119 |
# File 'lib/alchemy/resource.rb', line 108 def initialize(controller_path, module_definition = nil, custom_model = nil) @controller_path = controller_path @module_definition = module_definition @model = (custom_model || guess_model_from_controller_path) if model.respond_to?(:alchemy_resource_relations) if !model.respond_to?(:reflect_on_all_associations) raise MissingActiveRecordAssociation end store_model_associations map_relations end end |
Instance Attribute Details
#model ⇒ Object (readonly)
Returns the value of attribute model.
102 103 104 |
# File 'lib/alchemy/resource.rb', line 102 def model @model end |
#model_associations ⇒ Object
Returns the value of attribute model_associations.
101 102 103 |
# File 'lib/alchemy/resource.rb', line 101 def model_associations @model_associations end |
#resource_relations ⇒ Object
Returns the value of attribute resource_relations.
101 102 103 |
# File 'lib/alchemy/resource.rb', line 101 def resource_relations @resource_relations end |
Instance Method Details
#attributes ⇒ Object
160 161 162 163 164 165 166 167 168 169 |
# File 'lib/alchemy/resource.rb', line 160 def attributes @_attributes ||= model.columns.collect do |col| next if skipped_attributes.include?(col.name) { name: col.name, type: resource_column_type(col), relation: resource_relation(col.name) }.delete_if { |_k, v| v.nil? } end.compact end |
#editable_attributes ⇒ Object
171 172 173 |
# File 'lib/alchemy/resource.rb', line 171 def editable_attributes attributes.reject { |h| restricted_attributes.map(&:to_s).include?(h[:name].to_s) } end |
#engine_name ⇒ Object
199 200 201 |
# File 'lib/alchemy/resource.rb', line 199 def engine_name @module_definition && @module_definition['engine_name'] end |
#help_text_for(attribute) ⇒ Object
Returns a help text for resource’s form
Example:
de:
alchemy:
resource_help_texts:
my_resource_name:
attribute_name: This is the fancy help text
213 214 215 216 217 |
# File 'lib/alchemy/resource.rb', line 213 def help_text_for(attribute) ::I18n.translate!(attribute[:name], scope: [:alchemy, :resource_help_texts, resource_name]) rescue ::I18n::MissingTranslationData false end |
#in_engine? ⇒ Boolean
195 196 197 |
# File 'lib/alchemy/resource.rb', line 195 def in_engine? !engine_name.nil? end |
#model_association_names ⇒ Object
Returns an array of underscored association names
153 154 155 156 157 158 |
# File 'lib/alchemy/resource.rb', line 153 def model_association_names return unless model_associations model_associations.map do |assoc| assoc.name.to_sym end end |
#namespace_for_scope ⇒ Object
145 146 147 148 149 |
# File 'lib/alchemy/resource.rb', line 145 def namespace_for_scope namespace_array = namespace_diff namespace_array.delete(engine_name) if in_engine? namespace_array end |
#namespaced_resource_name ⇒ Object
133 134 135 |
# File 'lib/alchemy/resource.rb', line 133 def namespaced_resource_name @_namespaced_resource_name ||= namespaced_resources_name.singularize end |
#namespaced_resources_name ⇒ Object
137 138 139 140 141 142 143 |
# File 'lib/alchemy/resource.rb', line 137 def namespaced_resources_name @_namespaced_resources_name ||= begin resource_name_array = resource_array.dup resource_name_array.delete(engine_name) if in_engine? resource_name_array.join('_') end end |
#resource_array ⇒ Object
121 122 123 |
# File 'lib/alchemy/resource.rb', line 121 def resource_array @_resource_array ||= controller_path_array.reject { |el| el == 'admin' } end |
#resource_name ⇒ Object
129 130 131 |
# File 'lib/alchemy/resource.rb', line 129 def resource_name @_resource_name ||= resources_name.singularize end |
#resources_name ⇒ Object
125 126 127 |
# File 'lib/alchemy/resource.rb', line 125 def resources_name @_resources_name ||= resource_array.last end |
#restricted_attributes ⇒ Object
Return attributes that should be viewable but not editable.
221 222 223 224 225 226 227 |
# File 'lib/alchemy/resource.rb', line 221 def restricted_attributes if model.respond_to?(:restricted_alchemy_resource_attributes) model.restricted_alchemy_resource_attributes else [] end end |
#search_field_name ⇒ Object
Search field input name
Joins all searchable attribute names into a Ransack compatible search query
191 192 193 |
# File 'lib/alchemy/resource.rb', line 191 def search_field_name searchable_attribute_names.join("_or_") + "_cont" end |
#searchable_attribute_names ⇒ Object
Returns all attribute names that are searchable in the admin interface
177 178 179 180 181 182 183 184 185 |
# File 'lib/alchemy/resource.rb', line 177 def searchable_attribute_names if model.respond_to?(:searchable_alchemy_resource_attributes) model.searchable_alchemy_resource_attributes else attributes.select { |a| searchable_attribute?(a) } .concat(searchable_relation_attributes(attributes)) .collect { |h| h[:name] } end end |
#skipped_attributes ⇒ Object
Return attributes that should neither be viewable nor editable.
231 232 233 234 235 236 237 |
# File 'lib/alchemy/resource.rb', line 231 def skipped_attributes if model.respond_to?(:skipped_alchemy_resource_attributes) model.skipped_alchemy_resource_attributes else DEFAULT_SKIPPED_ATTRIBUTES end end |