lib/rails/generators/alchemy/scaffold/files/elements.yml in alchemy_cms-2.5.0.b5 vs lib/rails/generators/alchemy/scaffold/files/elements.yml in alchemy_cms-2.5.0.b9
- old
+ new
@@ -1,24 +1,24 @@
# == In this configuration you setup Alchemy´s element layouts.
-#
+#
# Use rails generate alchemy:scaffold to generate this file for your app.
-#
+#
# Elements containing all necessary basic tools for displaying and editing content inside Alchemy.
# They consists of composed contents (different essence-types) as shown in the illustration of an elements-sheme below.
#
# == Schema of an element
-#
+#
# =================================
# # Content 1 (EssenceText) #
# # #
# # Content 2 (EssencePicture) #
# # #
# # Content 3 (EssenceRichtext) #
# =================================
#
# == Example of a basic element layout
-#
+#
# - name: a_unique_name (Used for the partial name in +app/views/elements+ and translated as Element.display_name)
# unique: Bool //pass true if this element only can be displayed once on page
# contents:
# - name: head
# type: EssenceText
@@ -34,38 +34,38 @@
# * EssenceRichtext (Used to store editable richtext. Editor is rendered as a textarea with TinyMCE Editor.)
# * EssencePicture (Used to store picture ids from pictures assigned through the library. The editor is rendered as a picture-editor collection with a lot of options (i.e. image cropper). The view renders the assigned picture, resizes it, crops it and caches the result.)
# * EssenceFlash (Used to store attachment ids from attachments assigned through the library. The view renders an embeded object.)
# * EssenceDate (Used to store a DateTime object. The view output is passed through Rails I18n Library, so it will be fully localized.)
# * EssenceHtml (Used to store a String (max. 255 Chars.). The view output renders the raw, not sanitized or unescaped String. So be carefull!)
-#
+#
# After finishing the setup of your element layouts, you need to generate the files for the elements before using them in Alchemy.
# For creating these files, use the following command in your terminal:
-#
-# rails generate elements
-#
+#
+# rails generate alchemy:elements
+#
# All new elements will be created as two different partials in Rails.root/app/views/elements.
# For each element there is an editor-view wich will be rendered when editing them in Alchemy and another view for the website´s frontend.
-#
+#
# app/views/elements/_elements_name_editor.html.erb
# app/views/elements/_elements_name_view.html.erb
-#
-# For most contents in an element you can specify additional options, so they get rendered in a specific way.
+#
+# For most contents of an element you can specify additional options, so they get rendered in a specific way.
# These options can be defined as symbols, but its too much to list them up here.
# You can find these options described in the application_helper.rb, most of them at the render_essence method.
#
# == Setting a content as preview-text for the element
-#
+#
# You can set a content-essence as preview-text for its element like this
# take_me_for_preview: true
#
#
# == Adding contents dynamically in the frontend
-#
+#
# You are able to add content-essences dynamically to the element from the Alchemy frontend.
# You just have to make contents available for adding them.
# This example enables this feature
-#
+#
# - name: headline
# unique: false
# contents:
# - name: headline
# type: EssenceText
@@ -75,17 +75,39 @@
# - name: big_text
# type: EssenceRichtext
#
# Now an Alchemy user can add the content 'big_text' from the element as much as desired.
#
-# === Translate element names
-#
-# Element names are passed through the I18n library. So you can translate them in your config/locales language yml file.
-#
+#
+# == Deactivate indexing (Ferret search) for certain contents
+#
+# Contents of type EssenceText and EssenceRichtext can be excluded from being indexed by the Ferret search engine.
+#
# Example:
-#
+#
+# - name: contactform
+# unique: true
+# contents:
+# - name: mail_to
+# type: EssenceText
+# do_not_index: true
+#
+#
+# == Validate contents before updating the element
+#
+# More informations in [Content#essence_validations]
+#
+#
+# == Translate element and content names
+#
+# Element and content names are passed through the I18n library. So you can translate them in your config/locales language yml file.
+#
+# Example:
+#
# de:
# alchemy:
# element_names:
# contact: Kontakt
# search: Suche
+# content_names:
+# headline: Überschrift