-
Task
-
Resolution: Fixed
-
Neutral
-
None
-
-
Empty show more show less
-
Empty show more show less
When writing some training material I came across the question what the difference was between having components=none or enabled=false for an inheritance node in areas/components.
The difference is that you can have inheritance enabled, but you do not want to inherit the data, only the settings, so components=none makes sense if you combine it with properties=all for example. properties=all enables the inheritance of the properties set in the area's definition, such as title, description, etc.
However, I wasn't even aware of the properties property and I couldn't find any place where this was mentioned. Another problem with that is that there are several places where inheritance is used but it is not detailed enough and you can get lost while looking for it.
Therefore this is a recommendation on what to do:
- Detailed reference for the inheritance feature and its settings [1] (properties, default values, explanation)
- Centralized information under http://documentation.magnolia-cms.com/reference.html for example (or any better suiting place)
These are all the pages that contain some pieces of valuable information about inheritance:
- (http://documentation.magnolia-cms.com/reference/components.html#Relateddocumentation - links to the next link)
- http://wiki.magnolia-cms.com/display/WIKI/Inheritable+components
- http://documentation.magnolia-cms.com/templates/stk/template-prototype.html#Componentinheritance
- http://documentation.magnolia-cms.com/reference/areas.html - The image on the bottom actually contains all of the properties [2] I would be interested in for inheritance!
[1],[2] possible properties for inheritance:
- components - all | filtered | none
- enabled - true | false
- nodeComparatorClass - <fully-qualified-classname>
- predicateClass - <fully-qualified-classname>
- properties - all | none