History: Branching
Preview of version: 6
From Tiki 15 onwards, it is possible to include contents of other YAML files in profiles depending on branching logic.
The basic usage is through the use of the !include directive. In YAML, the "!" preceding the string means that that is a directive and some kiind of execution is to happen, returning some kind of output that replaces the directive.
The following is an extremely basic example on how it works:
test.yml
wysiwyg.yml
nonwysiwyg.yml
Each of the options of YAML files to include for a particular key (in the above case, feature_wysiwyg) is an item in a list starting with the !include directive followed by the filename (relative to the profile), and then a condition comparing 2 values using operators.
If the condition is true, then it includes that YAML file and ignores the other conditions. If not it moves on to the next option and performs the test again. It is customary to provide a default YML file in case any of the preceding conditions are not met. This works pretty much is the same way as a typical CASE structure in PHP.
In the above example, wysiwyg.yml will be included and therefore wysiwyg will be on. If on the other hand:
since 1 not equals 2, it will default to the nonwysiwyg.yml and set feature_wysiwyg to 'n'.
Note that the contents of the included YAML files should start with the same key as that to be replaced. For example, wysiwyg.yml and nonwysiwyg.yml both start with "feature_wysiwyg".
neq: not equal to
lt: less than
le: less than or equal to
gt: greater than
ge: greater than or equal to
Basic usage
The basic usage is through the use of the !include directive. In YAML, the "!" preceding the string means that that is a directive and some kiind of execution is to happen, returning some kind of output that replaces the directive.
The following is an extremely basic example on how it works:
test.yml
preferences: feature_wysiwyg: - !include wysiwyg.yml 1 eq 1 - !include nonwysiwyg.yml
wysiwyg.yml
feature_wysiwyg: y
nonwysiwyg.yml
feature_wysiwyg: n
Each of the options of YAML files to include for a particular key (in the above case, feature_wysiwyg) is an item in a list starting with the !include directive followed by the filename (relative to the profile), and then a condition comparing 2 values using operators.
If the condition is true, then it includes that YAML file and ignores the other conditions. If not it moves on to the next option and performs the test again. It is customary to provide a default YML file in case any of the preceding conditions are not met. This works pretty much is the same way as a typical CASE structure in PHP.
In the above example, wysiwyg.yml will be included and therefore wysiwyg will be on. If on the other hand:
preferences: feature_wysiwyg: - !include wysiwyg.yml 1 eq 2 - !include nonwysiwyg.yml
since 1 not equals 2, it will default to the nonwysiwyg.yml and set feature_wysiwyg to 'n'.
Note that the contents of the included YAML files should start with the same key as that to be replaced. For example, wysiwyg.yml and nonwysiwyg.yml both start with "feature_wysiwyg".
Comparison operators
eq: equal toneq: not equal to
lt: less than
le: less than or equal to
gt: greater than
ge: greater than or equal to
Limitations
- Included YAML files themselves cannot contain !include statements.
History
Current Profiles
Latest Changes
- test_profile_change
- test_new_personal_blog_and_profile
- test_new_personal_blog_and_profile_vlog_include
- Bootstrap Row and Col Plugin Aliases
- Profile_Test_all_Modules_Test_all_Modules_page
- Bug_Tracker_16
- Bug_Tracker_16
- Profile_Tracker_as_Calendar_page_09
- Tracker_as_Calendar_09
- TikiKart_Product_Include
- Shopping_Cart
- Scheduler_Presets_20
- test_new_personal_blog_and_profile_post3_include
- test_new_personal_blog_and_profile_post2_include
- test_new_personal_blog_and_profile_post1_include
- test_new_personal_blog_and_profile_about_include
- test_new_personal_blog_and_profile_social_include
- R_demo
- Voting_System
- Test_all_tracker_field_types_profile