User Tools

Site Tools


fpanels_designer_panel_settings_filterpanel

Filter Panel

A Filter Panel allows the user to filter the contents of its Referred Panel based on the value of specified fields. Any number of fields may be specified and the user may select more than one value from each to include in the Referred Panel's display.

If the Referred Panel controls others then those panels will be filtered by this panel's selections.

Each field in the filter may be turned on or off by the user, activating the selections.

Select the Referred Panel. This is the panel whose content will be filtered by this panel. Only panels using the same data as this may be filtered.

The current filter fields are displayed. Click one to edit. Drag and drop them in the list to arrange them in the order you want them displayed.

For each field you wish to filter on, select the field from those in the panel's data. This may not be changed once you have added the field, although the field may be removed from the filter.

Give the filter field a name, which appears in the panel above the selectable values.

The In View value specifies how many values are to be shown in the multi-select box. The box will be scrollable but this lets you specify how big the box is displayed as.

The values in the select list will, by default, be in alphabetical order. However, you may wish to put certain values at the top of the list if they are the most likely values to be selected. Enter these values in the Order entry (separated by commas). These will always be shown at the top of the select list.

The Parent option lets you effectively filter the filter. By selecting another filter field, this filter field will show only those that have the value(s) selected in the parent field. This helps users by only showing relevant values.

Other than the Order entered above, you can choose to order all other fields by text, number or rank (the number of occurrences in the data). You can also specify this as in descending order. The Order list entered above is unaffected by this option.

Note that when editing a filter field it is not updated in your design immediately; you must click “Update” to apply the changes.

Optionally you can specify a list of field values to be preset when the panel is displayed. On initial loading of the page the filter will automatically be applied to these values.