Home

Install the Preside extension (Static)

1. Add extensions folder if not already
2. Install the submodule from project root: git submodule add -b stable https://github.com/pixl8/preside-ext-multiselect.git static/extensions/preside-ext-multiselect
3. Within Application.cfc, add the following lines:
4. • this.mappings[ "/extensions" ] = ExpandPath( "/extensions" );
5. • sticker.addBundle( "/extensions/preside-ext-multiselect/assets", "/extensions/preside-ext-multiselect/assets" );
6. Anywhere within .cfm file that uses multiple select field, define sticker.include( "ext-custom-chosen" ); at the top of the file

Install the Preside extension (Web)

1. Install and enable the extension

Ajax filtering setup

Sample usage for form field xml definition

<field name="parent_field_name" control="multiSelect" object="parent_db_object" filterChildId="related_child_select_field_name" ajax="/formcontrols/MultiSelect/refreshChildOptions/" extraClass="select-filter-by"/>

<field name="related_child_select_field_name"  control="multiSelect" object="child_db_object" filterBy="db_field_link_to_parent" objectFilters="activeOnly" />

Form attributes definition

Attribute name	Value	Usage
control	multiSelect
object	Variable: DB object name
filterChildId		Required for parent field. This could be a list of child field names
ajax	/formcontrols/MultiSelect/refreshChildOptions/	Ajax URL to post to
extraClass	select-filter-by	Required for parent field.
filterBy	Variable: FK within child DB object	Required for child field. FK within the child DB object that links to the parent table

Ajax type-to-search setup

Useful for select with huge list of options to limit a fix number of result on load, and type-to-search to bring up further matching options

Sample usage for form field xml definition

<field name="field_custom" ... />
<field name="field_with_long_options" control="multiSelect" ...  ajaxMaxRows="10" ajaxTextSearch="1" ajaxSearchCustomFilter="..." ajaxSearchUrl="..." />

Form attributes definition

Attribute name	Value	Usage
control	multiSelect
ajaxMaxRows	/formcontrols/MultiSelect/refreshChildOptions/	Max rows of options to be loaded (pre-selected values are not counted in this number)
ajaxTextSearch	1	Flag control to use Ajax text search
ajaxSearchCustomFilter	field_custom	Additional form control ID for type-to-search custom filtering (other than filterChildId / filterBy relationship). Could be a comma-separated list
ajaxSearchUrl		Custom type-to-search post URL - to be used together with ajaxSearchCustomFilter. If not specified, the default value is /formcontrols/MultiSelect/getObjectRecordsForAjaxSelectControl/