Community Documentation

Improved Multi Select

Last updated December 13, 2012. Created by herd45 on December 10, 2012.
Edited by rooby. Log in to edit this page.

User Interface

Note: A lot of this functionality is only available in the 2.x version.

The Improved Multi Select module replace the default multi-select boxes with two panel list and search. The first panel holds the options that are available, and the second panel holds the options that have been selected. Two panels are separated by "add" and "remove" buttons. You can select an item from the first box, click the "add" button, and add it to the second box. Likewise, you can select an item from the second box, click the "remove" button, and it goes back into the unselected box. Re-Ordering buttons allow users to move items that have been selected up and down.
Improved Multi Select

A search box allows users to quickly filter the left column to find items. Admins can decide how precise users need to be when entering searches. Options include Exact Match, All Words, and Any Words. For each option, admins can decide if they want to allow partial words.
Search

Grouping allows users to drill down by category to find items. This is especially useful when the user has a large list of items to select from.
Grouping

Grouping works with search to enable cross-filtering.
Cross Filtering

Admin Interface

Choose between "Replace all multi-select lists" or "Replace multi-select lists on specific page." Enter one path per line to specify pages.
Replace Multi Select lists

"Filter functionality" allows admins to decide how precise users need to be when entering searches. Options include Exact Match, All Words, and Any Words. For each option, admins can decide if they want to allow partial words.
Filter Functionality

If "Allow re-ordering of selected items" is unchecked, the "Move up" and "Move Down" buttons will be removed. Also, if this box is unchecked, items will be added in the same order as they appear in the left column, as opposed to being added in the order they were selected.
Re-Ordering

When "Reset filter when selecting a group" is checked, the search box and groups will work independently of one another. If checked, clicking on a group will clear the current search. If unchecked, the search box and groups can be used together for cross-filtering.
Reset filter when selecting a group

"Button Text" allows admins to customize the text or symbols for Add/Remove and re-ordering buttons
Button Text

AttachmentSize
IMSai1.PNG21.12 KB
IMSai2.PNG27.2 KB
IMSai3.PNG7.68 KB
IMSai4.PNG6.29 KB
IMSai5.PNG15.56 KB
improvedselect.gif17.32 KB
IMSsearch.PNG43.14 KB
IMSgroups.png27.2 KB
IMSpartialmatch.PNG33.62 KB

Page status

No known problems

Log in to edit this page

About this page

Drupal version
Drupal 7.x
Audience
Programmers, Site administrators, Site builders
Keywords
multi select fields, select

Site Building Guide

Drupal’s online documentation is © 2000-2013 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License. Comments on documentation pages are used to improve content and then deleted.
nobody click here