Field that stores YAML data and formats it as an object, when requested.
After installation create a new field, let's say called people and assign it to a template, or just edit an existing text-based field and choose Yaml for the type, save!
In the Details-Tab you have some options you can choose from:
Parse as
Default is WireArray/WireData, the data can also be parsed as Object or Associative Array.
Associative Array is the fastest and the default output by the used Spyc parser, WireArray/WireData might be the slowest, but it's also the most feature rich. You can access properties like you are used to with pages or fields, like $page->person->get('title|name') or $page->people->find('age>20').
Now, in your just created field you can put in some YAML like this:
- name: Jane Doe
occupation: Product Manager
age: 33
hobbies:
- running
- movies
- name: John Doe
occupation: Service Worker
age: 28
hobbies:
- cycling
- fishing
In your template, or wherever you are accessing the page, you would use it like any other ProcesssWire data (if you set the parse option to either WireData or Object):
$out = '';
foreach ($page->people as $person) {
$out .= "Name: {$person->name} <br>";
$out .= "Occupation: {$person->occupation} <br>";
$out .= "Age: {$person->age} <br>";
$out .= "Hobbies: <br>";
foreach ($person->hobbies as $hobby) {
$out .= "- {$hobby} <br>";
}
$out .= "--- <br>";
}
echo $out;- I've used a namespaced version of the Autoloader class from Template Data Providers
- The YAML parser is a namespaced version of Spyc
- 0.3.0 Make the module compatible with ProcessWire 3.x
- 0.2.0 add WireArray feature, parse chaching and make default
toStringoutput the name or label of the field, if WireData/-Array is selected - 0.1.0 initial version