DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:struct:bureaucracy

This is an old revision of the document!


Struct Plugin

Struct Plugin: Bureaucracy Support

The Struct Plugin supports integration with the Bureaucracy Plugin. This allows reusing the input mechanisms of the different types in bureaucracy forms and creation of structured data when pages are created through Bureaucracy's template action or saving them into lookup schemas.

Single Field

You can use any field from any defined schema as a field in a Bureaucracy form. To do so simply use the type struct_field and specify the field name in the form of <schema>.<name>.

<form>
Action template templates:product product :
struct_field "products.product" @
submit "Create new product"
</form>

The defined (translated) label will automatically be used for the field as well as all the validation rules configured in the schema.

You can use the value entered in a Struct field as any other value for templating. Eg. you can use @@products.product@@ to access the value of the example above.

All Struct values will be assigned to the resulting pages of (when using the Bureaucracy template action), provided the schema assignments match.

Complete Schema

Instead of adding individual fields to a Bureaucracy form as described above, you can also add a whole schema to the form. To do so, simply use the struct_schema command.

<form>
Action template templates:product product :
textbox name @
struct_schema "product" !
submit "Create new product"
</form>

Please note that all additional parameters given will be added to each individual field. Eg. you can only make all fields of the schema mandatory or optional.

Templates

At the moment it isn't possible to use pre-filled fields as templates in the Bureaucracy – fieldset.

Action struct_lookup

You can save data from bureaucracy forms into lookup schema, using struct_lookup form action. To do so add action struct_lookup and desired lookup fields using struct_field or struct_schema. Eg.

<form>
action struct_lookup
struct_field "someschema.name"
submit "Save into lookup"
</form>
plugin/struct/bureaucracy.1515494415.txt.gz · Last modified: 2018-01-09 11:40 by solewniczak

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki