stuttter/wp-chosen

Makes long, unwieldy select boxes much more user-friendly

6.1.1 2021-03-10 19:01 UTC

Requires

• php: >=7.0
• composer/installers: ^1.0

GPL-2.0-or-later

• John James Jacoby

README

WP Chosen implements the Chosen jQuery Plugin for WordPress.

Chosen makes long, unwieldy select boxes much more user-friendly.

Installation

• Download and install using the built in WordPress plugin installer.
• Activate in the "Plugins" area of your admin by clicking the "Activate" link.
• Consider sponsoring future development by clicking "Sponsor".
• No further setup or configuration is necessary.

Development

npm install

Use this command to install PostCSS and all other development dependencies

npm run remap

Use this command to remap colors to the latest WordPress palette

npm run dev

Use this command to compile human-readable and unminified CSS files

npm run prod

Use this command to compile minified CSS files for production environments

FAQ

What dropdowns does this target?

/* Options */
var chosen_options = {
	disable_search_threshold: 13,
	search_contains: true
};

/* Targets */
var chosen_selects = ' select:not(#metakeyselect, [name^=acf_], [name^=edd], [name^=_edd], [name^=sc], [name=wc_order_action], [class*=chosen], [class*=select2], [class*=wc-enhanced-select], [class*=wc-product-search], [class*=wc-enhanced-select-nostd], [class*=wc-customer-search], [class*=wc-category-search], [class=learndash-binary-selector-items], [class=sendgrid-settings-select])',
	chosen_targets =
	'.wp-pretty-filters'         + chosen_selects
	+ ', .wp-filter'             + chosen_selects
	+ ', .media-toolbar'         + chosen_selects
	+ ', .postbox .inside'       + chosen_selects
	+ ', .tablenav'              + chosen_selects
	+ ', .form-table'            + chosen_selects
	+ ', .form-wrap'             + chosen_selects
	+ ', .customize-pane-parent' + chosen_selects;

Where can I get support?

• Community: https://wordpress.org/support/plugin/wp-chosen
• Development: https://github.com/stuttter/wp-chosen/discussions

Contributing

Please open a new issue to discuss whether the feature is a good fit for the project. Once you've decided to work on a pull request, please follow the WordPress Coding Standards.