Class: Alchemy::Content
- Inherits:
-
BaseRecord
- Object
- ActiveRecord::Base
- BaseRecord
- Alchemy::Content
- Defined in:
- app/models/alchemy/content.rb
Defined Under Namespace
Modules: Factory
Class Method Summary collapse
-
.translated_label_for(content_name, element_name = nil) ⇒ Object
Returns the translated label for a content name.
Instance Method Summary collapse
-
#default_text(default) ⇒ Object
Returns the default value from content definition.
-
#dom_id ⇒ Object
Returns a string used as dom id on html elements.
- #essence_partial_name ⇒ Object
- #essence_validation_failed? ⇒ Boolean
- #form_field_id(essence_column = 'ingredient') ⇒ Object
-
#form_field_name(essence_column = 'ingredient') ⇒ Object
Returns a string to be passed to Rails form field tags to ensure we have same params layout everywhere.
-
#has_custom_tinymce_config? ⇒ Boolean
Returns true if there is a tinymce setting defined that contains settings.
-
#has_tinymce? ⇒ Boolean
Returns true if there is a tinymce setting defined on the content definiton or if the
essence.has_tinymce?
returns true. - #has_validations? ⇒ Boolean
-
#ingredient ⇒ Object
Gets the ingredient from essence.
-
#ingredient=(value) ⇒ Object
Sets the ingredient from essence.
- #linked? ⇒ Boolean
-
#name_for_label ⇒ Object
Returns the translated name for displaying in labels, etc.
- #normalized_essence_type ⇒ Object
-
#preview_content? ⇒ Boolean
Returns true if this content should be taken for element preview.
-
#preview_text(maxlength = 30) ⇒ Object
Proxy method that returns the preview text from essence.
-
#scope_condition ⇒ Object
ActsAsList scope.
-
#serialize ⇒ Object
Serialized object representation for json api.
-
#serialized_ingredient ⇒ Object
Ingredient value from essence for json api.
-
#settings ⇒ Object
Settings from the elements.yml definition.
-
#settings_value(key, options = {}) ⇒ Object
Fetches value from settings.
- #siblings ⇒ Object
-
#tinymce_class_name ⇒ Object
Returns css class names for the content textarea.
-
#to_partial_path ⇒ Object
The content’s view partial is dependent from its name.
-
#update_essence(params = {}) ⇒ Object
Updates the essence.
Methods included from Factory
Methods included from Hints
Methods included from Logger
Methods inherited from BaseRecord
Class Method Details
.translated_label_for(content_name, element_name = nil) ⇒ Object
Returns the translated label for a content name.
Translate it in your locale yml file:
alchemy:
content_names:
foo: Bar
Optionally you can scope your content name to an element:
alchemy:
content_names:
article:
foo: Baz
78 79 80 81 82 83 84 |
# File 'app/models/alchemy/content.rb', line 78 def translated_label_for(content_name, element_name = nil) Alchemy.t( content_name, scope: "content_names.#{element_name}", default: Alchemy.t("content_names.#{content_name}", default: content_name.humanize) ) end |
Instance Method Details
#default_text(default) ⇒ Object
Returns the default value from content definition
If the value is a symbol it gets passed through i18n inside the alchemy.default_content_texts
scope
259 260 261 262 263 264 265 266 |
# File 'app/models/alchemy/content.rb', line 259 def default_text(default) case default when Symbol Alchemy.t(default, scope: :default_content_texts) else default end end |
#dom_id ⇒ Object
Returns a string used as dom id on html elements.
205 206 207 208 |
# File 'app/models/alchemy/content.rb', line 205 def dom_id return '' if essence.nil? "#{essence_partial_name}_#{id}" end |
#essence_partial_name ⇒ Object
230 231 232 233 |
# File 'app/models/alchemy/content.rb', line 230 def essence_partial_name return '' if essence.nil? essence.partial_name end |
#essence_validation_failed? ⇒ Boolean
174 175 176 |
# File 'app/models/alchemy/content.rb', line 174 def essence_validation_failed? essence.errors.any? end |
#form_field_id(essence_column = 'ingredient') ⇒ Object
200 201 202 |
# File 'app/models/alchemy/content.rb', line 200 def form_field_id(essence_column = 'ingredient') "contents_#{id}_#{essence_column}" end |
#form_field_name(essence_column = 'ingredient') ⇒ Object
Returns a string to be passed to Rails form field tags to ensure we have same params layout everywhere.
Example:
<%= text_field_tag content.form_field_name, content.ingredient %>
Options:
You can pass an Essence column_name. Default is ‘ingredient’
Example:
<%= text_field_tag content.form_field_name(:link), content.ingredient %>
196 197 198 |
# File 'app/models/alchemy/content.rb', line 196 def form_field_name(essence_column = 'ingredient') "contents[#{id}][#{essence_column}]" end |
#has_custom_tinymce_config? ⇒ Boolean
Returns true if there is a tinymce setting defined that contains settings.
246 247 248 |
# File 'app/models/alchemy/content.rb', line 246 def has_custom_tinymce_config? settings[:tinymce].is_a?(Hash) end |
#has_tinymce? ⇒ Boolean
Returns true if there is a tinymce setting defined on the content definiton or if the essence.has_tinymce?
returns true.
241 242 243 |
# File 'app/models/alchemy/content.rb', line 241 def has_tinymce? settings[:tinymce].present? || (essence.present? && essence.has_tinymce?) end |
#has_validations? ⇒ Boolean
178 179 180 |
# File 'app/models/alchemy/content.rb', line 178 def has_validations? definition['validate'].present? end |
#ingredient ⇒ Object
Gets the ingredient from essence
128 129 130 131 |
# File 'app/models/alchemy/content.rb', line 128 def ingredient return nil if essence.nil? essence.ingredient end |
#ingredient=(value) ⇒ Object
Sets the ingredient from essence
153 154 155 156 |
# File 'app/models/alchemy/content.rb', line 153 def ingredient=(value) raise EssenceMissingError if essence.nil? essence.ingredient = value end |
#linked? ⇒ Boolean
215 216 217 |
# File 'app/models/alchemy/content.rb', line 215 def linked? essence && !essence.link.blank? end |
#name_for_label ⇒ Object
Returns the translated name for displaying in labels, etc.
211 212 213 |
# File 'app/models/alchemy/content.rb', line 211 def name_for_label self.class.translated_label_for(name, element.name) end |
#normalized_essence_type ⇒ Object
235 236 237 |
# File 'app/models/alchemy/content.rb', line 235 def normalized_essence_type self.class.normalize_essence_type(essence_type) end |
#preview_content? ⇒ Boolean
Returns true if this content should be taken for element preview.
220 221 222 |
# File 'app/models/alchemy/content.rb', line 220 def preview_content? !!definition['as_element_title'] end |
#preview_text(maxlength = 30) ⇒ Object
Proxy method that returns the preview text from essence.
226 227 228 |
# File 'app/models/alchemy/content.rb', line 226 def preview_text(maxlength = 30) essence.preview_text(maxlength) end |
#scope_condition ⇒ Object
ActsAsList scope
36 37 38 39 |
# File 'app/models/alchemy/content.rb', line 36 def scope_condition # Fixes a bug with postgresql having a wrong element_id value, if element_id is nil. "element_id = #{element_id || 'null'} AND essence_type = '#{essence_type}'" end |
#serialize ⇒ Object
Serialized object representation for json api
135 136 137 138 139 140 141 |
# File 'app/models/alchemy/content.rb', line 135 def serialize { name: name, value: serialized_ingredient, link: essence.try(:link) }.delete_if { |_k, v| v.blank? } end |
#serialized_ingredient ⇒ Object
Ingredient value from essence for json api
If the essence responds to serialized_ingredient
method it takes this otherwise it uses the ingredient column.
148 149 150 |
# File 'app/models/alchemy/content.rb', line 148 def serialized_ingredient essence.try(:serialized_ingredient) || ingredient end |
#settings ⇒ Object
Settings from the elements.yml definition
107 108 109 110 |
# File 'app/models/alchemy/content.rb', line 107 def settings return {} if definition.blank? @settings ||= definition.fetch(:settings, {}) end |
#settings_value(key, options = {}) ⇒ Object
Fetches value from settings
118 119 120 |
# File 'app/models/alchemy/content.rb', line 118 def settings_value(key, = {}) settings.update( || {}).symbolize_keys[key.to_sym] end |
#siblings ⇒ Object
122 123 124 125 |
# File 'app/models/alchemy/content.rb', line 122 def siblings return [] if !element element.contents end |
#tinymce_class_name ⇒ Object
Returns css class names for the content textarea.
251 252 253 |
# File 'app/models/alchemy/content.rb', line 251 def tinymce_class_name "has_tinymce" + (has_custom_tinymce_config? ? " #{element.name}_#{name}" : "") end |
#to_partial_path ⇒ Object
The content’s view partial is dependent from its name
Define contents
Contents are defined in the config/alchemy/elements.yml
file
- name: article
contents:
- name: headline
type: EssenceText
Override the view
Content partials live in app/views/alchemy/essences
102 103 104 |
# File 'app/models/alchemy/content.rb', line 102 def to_partial_path "alchemy/essences/#{essence_partial_name}_view" end |
#update_essence(params = {}) ⇒ Object
Updates the essence.
Called from Alchemy::Element#update_contents
Adds errors to self.base if essence validation fails.
164 165 166 167 168 169 170 171 172 |
# File 'app/models/alchemy/content.rb', line 164 def update_essence(params = {}) raise EssenceMissingError if essence.nil? if essence.update(params) return true else errors.add(:essence, :validation_failed) return false end end |