TIP JQSelect2Contrib is not installed on Foswiki.org.


Select2 jQuery widget for Foswiki

This extension adds support for the Select2 jQuery widget to Foswiki.

Select2 magically turns an existing select tag into a widget that supports type-ahead find, but it can do much more: selecting multiple values, remote data sources, infinite scrolling... you name it.

For more information about the widget and how to customize it, see its homepage.


Use %JQREQUIRE{"select2"}% to make use of Select2 on a wiki page. Add the jqSelect2 CSS class to a select tag to make it turn into a Select2 widget.



<select class='jqSelect2' data-placeholder='Select a burger' data-width='element'>
<option>Hamburger deluxe with gold plating</option>

If Select2 is enabled, you will see the result below:

No such plugin select2

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. "Extensions Operation and Maintenance" Tab -> "Install, Update or Remove extensions" Tab. Click the "Search for Extensions" button. Enter part of the extension name or description and press search. Select the desired extension(s) and click install. If an extension is already installed, it will not show up in the search results.

You can also install from the shell by running the extension installer as the web server user: (Be sure to run as the webserver user, not as root!)
cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See https://foswiki.org/Support/ManuallyInstallingExtensions for more help.



Change History

26 Oct 2020: compatibility with jquery-3
02 Sep 2016: add .ui-dialog class to drop-down window for proper base css (Foswiki:Main/MichaelDaum)
09 Mar 2015: initial release on foswiki.org (Foswiki:Main/MichaelDaum)
04 Oct 2012: initial check-in of select2 3.2 (Foswiki:Main/JanKrueger)

PackageForm edit

Author Jan Krueger
Version 2.00
Release 26 Oct 2020
Description Select2 jQuery widget for Foswiki
Copyright © 2012 Modell Aachen GmbH, http://modell-aachen.de/; © 2012-2020 Foswiki Contributors
License GPL (GNU General Public License)
Home Foswiki:Extensions/JQSelect2Contrib
Support Foswiki:Support/JQSelect2Contrib
Repository https://github.com/foswiki/JQSelect2Contrib
ExtensionClassification User interactivity
ExtensionType ContribPackage
DemoUrl http://
SupportUrl JQSelect2Contrib
ModificationPolicy PleaseFeelFreeToModify
I Attachment Action Size Date Who Comment
JQSelect2Contrib.md5md5 JQSelect2Contrib.md5 manage 171 bytes 26 Oct 2020 - 07:59 MichaelDaum  
JQSelect2Contrib.sha1sha1 JQSelect2Contrib.sha1 manage 195 bytes 26 Oct 2020 - 07:59 MichaelDaum  
JQSelect2Contrib.tgztgz JQSelect2Contrib.tgz manage 56 K 26 Oct 2020 - 07:59 MichaelDaum  
JQSelect2Contrib.zipzip JQSelect2Contrib.zip manage 60 K 26 Oct 2020 - 07:58 MichaelDaum  
JQSelect2Contrib_installerEXT JQSelect2Contrib_installer manage 5 K 26 Oct 2020 - 07:59 MichaelDaum  
Topic revision: r3 - 26 Oct 2020, MichaelDaum
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy