In this tutorial we will create a simple form for keeping online registry of our office books, a bookshelf.
Once the form is defined it could be used on different pages and use different layouts
as modal dialog
as embedded to the page
as embedded to the page with custom layout
If you are new to ConfiForms please make sure you have read the Basic concepts (there is a video tutorial if you do not want to read )
Take a look a the screencast and see explanations below:
Start with creating a Confluence page and adding the ConfiForms Form macro. Do not change anything there, give only the name for your form.
To ConfiForms Formmacro body add the following fields (using the ConfiForms Field Definition macros)
Text field for book name
Textarea field for storing the book introduction
File type field to store the picture of the book
Smart dropdown field to store author's name
Then place a ConfiForms Registration Controlmacro on the same page, it could be inside the ConfiForms Form macro (macro body) or outside (in this case you will need to set the "Form name" parameter)
When the defaults are used for ConfiForms Registration Controlmacro the form is shown as a dialog and the layout for form fields is compiled automatically.
By using the the "Embedded or Dialog?" parameter in ConfiForms Registration Controlmacro you can change the form to be displayed either as dialog or as embedded to the page.
When standard form layout does not fit your requirements there is an option to have your own.
This is done also, through ConfiForms Registration Controlmacro and using this macro's body. You can use any layout you want, placing rich content, basically everything what Confluence editor allows you to do. Important thing is that you must have ConfiForms Field macro(s) which correspond to your ConfiForms Field Definition macros (have the same field name(s) as your field definitions)