Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt Include
Creating a simple form in Confluence with ConfiForms
Creating a simple form in Confluence with ConfiForms
nopaneltrue

There is a way to override some defaults of ConfiForms Register macro. You can override form mode (embedded or dialog), as well as set default parameters from the URL (query string) or using the ConfiForms Registration Control macro parameter

 


Using ConfiForms Registration Control macro parameter

...

  • cf_name - expects form name (as you might have multiple ConfiForms Register macros on the page, this is a way to reference one particular form)
  • cf_embedded - expects true or false for the form mode, true means the form will be shown in embedded mode, and false will show the form in dialog mode
  • cf_values - expect a key:value pairs separated by ; where key is the name of the field you want to set the values for and value is the value you want to set. Support is somewhat limited to text fields and fields with simple values (dropdowns expect ids, smart fields actually expect internal guids, fiel types are NOT supported)

...


Let's have a simple form of 3 fields (all are of text type), which uses default ConfiForms Register macro

Form name is "f". The form is created in space named MYTEST and page name is "Simple registration" 


The form looks like this when in page view mode (admin user):

 


To override form mode, one will do the following:

...

Here we set field t1 to Hello and field t2 to world

 


Info

With ConfiForms version 1.51.6+ you can use the URL parameter called "cf_showonload" to open the form dialog automatically

HTML
<a href="<URL_TO_PAGE_WITH_FORMVIEW>?cf_name=f&cf_showonload=true">auto open form</a>

In this example our form's name is "f", which is mandatory parameter when you want to use "cf_showonload" parameter, and must point at the form you want to enable this dialog "auto-open"