Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Keynote

  • Plugin Properties Options allow a

Introduction

  • Allow plugin to gather configuration data from the a plugin user.
  • Plugin properties options Properties Options should be returned in the abstract method "getPropertyOptions" of each plugin.
  • Plugin properties options Properties Options are in JSON format.

Basic Properties Options Structure 

Code Block
[
    {
        title : 'Page Title',
        properties : [
            {
                name : 'Property Name',
                label : 'Property Label',
                type : 'Property Type',
                required : 'Mandatory or Not', 
                //… more property attributes …
            }, //… more properties …
        ],
        validators : [
            //… properties custom validators …
        ]
    }, //… more properties page …
]

Properties Option Types

  1. Hidden field - hidden
  2. Read only field – readonly
  3. Text field – textfield
  4. Password field – password
  5. Text

...

  1. Area field – textarea
  2. HTML

...

  1. Editor field – htmleditor
  2. Checkbox field – checkbox
  3. Radio

...

  1. Button field – radio
  2. Select

...

  1. Box field – selectbox
  2. Multi

...

  1. Select Box field – multiselect
  2. Element (Plugin)

...

  1. Hidden field - hidden
  2. Read only field – readonly
  3. Text field – textfield
  4. Password field – password
  5. Text area field – textarea
  6. HTML editor field – htmleditor
  7. Checkbox field – checkbox
  8. Radio button field – radio
  9. Select box field – selectboxMulti select box field – multiselectElement (Plugin) select field – elementselect
  10. Grid field - grid

Properties Validator Types

  1. AJAX - ajax

...

Detail

...

Attributes of Option Types 

Common Attributes for All Properties Options

...

Types Except Hidden Field and Grid

{
    name : 'Property Name',
    label : 'Property Label',
    description : 'Property Description', //optional, default is NULL
    type : 'readonly',
    value : 'Property Value', //optional , default is empty string
    required : 'true', //optional, boolean value, default is false
}

Extra Attributes for Text Field, Password Field, Text Area and HTML Editor

{
    size : '50', //optional , integer value, default is NULL, only for text field and password field
    maxlength : '50', //optional, integer value, default is NULL, only for text field and password field
    rows : '50', //optional, integer value, default is NULL, only for text area and html editor
    cols : '50', //optional, integer value, default is NULL , only for text area and html editor
    regex_validation : '^ Wiki Markup\[a-zA-Z0-9_\|KB:a-zA-Z0-9_\]+$', //optional, default is NULL
    validation_message : 'Error!!' //optional, default is NULL
}

...

Extra Attributes for Checkbox, Radio Button, Select Box and Multi Select Box, Element Select Field

...

{
    size : '10', //optional, integer value, default is 4, only for multi select box
    options : [//is optional to use this attribute or options_ajax
        {value: 'value1', label : 'Value 1'},
        {value: 'value2', label : 'Value 2'},
        {value: 'value3', label : 'Value 3'}
    ],
    options_ajax_on_change : 'property1', //optional, this property name and value will passed as HTTP request parameter to the URL defined in the options_ajax property
    options_ajax : 'URL to load options JSON' //optional, URL which returns the JSON Array of a set of Objects that have value & label attribute
}

...

Attributes for Hidden Field

...

{
    name : 'Property Name',
    type : 'hidden',
    value : 'Property Value'
}

...

Attributes for Grid

...

{
    name : 'Property Name',
    label : 'Property Label',
    description : 'Property Description', //optional, default is NULL
    type : 'grid',
    columns : [// 2 types of column, with and without options attribute
        {key : 'col1', label : 'Col 1'},
        {key : 'col2', label : 'Col 2',
            options :[
                {value :'option1', label : 'Option 1'},
                {value :'option2', label : 'Option 2'}
            ]
        },
    ],

   value:[    //Optional. Default is null.

...

The name of each sub-object must match a key from the columns object above. (e.g. col1 below matches col1 in one of the columns:key names above)
       { col1 : 'abc', col2 : 'option1' },       

        {col1 : 'def', col2 : 'option2'}

    ],
    required : 'true', //optional, boolean value, default is false
}

...

Extra Attributes for Element Select Field

...

{
    options_ajax_on_change : 'property1', //optional, this property name and value will passed as HTTP request parameter to the URL defined in the options_ajax property
    options_ajax : '[KB:CONTEXT_PATH]/web/property/json/getElements?classname= org.joget.apps.form.model.FormLoadElementBinder', //Load plugin list based on class name given
    url : '[KB:CONTEXT_PATH]/web/property/json[KB:APP_PATH]/getPropertyOptions'//Load plugin properties
    keep_value_on_change : 'true' //optional, boolean value, default is false. To keep current configuration for the next selected element
}

Detail Attributes of Validator Type

 Attributes for AJAX

{
    type : 'ajax',
    url : 'URL to validate properties page value' , // All properties in the same page will send to this url to validate, URL return a JSON Object with status (success or fail) & message (JSONArray of String) attribute
    default_error_message : 'Error in this page!!' //optional, default is null
}