if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
* Elementor select2 control.
* A base control for creating select2 control. Displays a select box control
* based on select2 jQuery plugin @see https://select2.github.io/ .
* It accepts an array in which the `key` is the value and the `value` is the
* option name. Set `multiple` to `true` to allow multiple value selection.
class Control_Select2 extends Base_Data_Control {
* Get select2 control type.
* Retrieve the control type, in this case `select2`.
* @return string Control type.
public function get_type() {
* Get select2 control default settings.
* Retrieve the default settings of the select2 control. Used to return the
* default settings while initializing the select2 control.
* @return array Control default settings.
protected function get_default_settings() {
// Select2 library options
// the lockedOptions array can be passed option keys. The passed option keys will be non-deletable.
* Render select2 control output in the editor.
* Used to generate the control HTML in the editor using Underscore JS
* template. The variables for the class are available using `data` JS
public function content_template() {
<div class="elementor-control-field">
<label for="<?php $this->print_control_uid(); ?>" class="elementor-control-title">{{{ data.label }}}</label>
<div class="elementor-control-input-wrapper elementor-control-unit-5">
<# var multiple = ( data.multiple ) ? 'multiple' : ''; #>
<select id="<?php $this->print_control_uid(); ?>" class="elementor-select2" type="select2" {{ multiple }} data-setting="{{ data.name }}">
<# _.each( data.options, function( option_title, option_value ) {
var value = data.controlValue;
if ( typeof value == 'string' ) {
var selected = ( option_value === value ) ? 'selected' : '';
} else if ( null !== value ) {
var value = _.values( value );
var selected = ( -1 !== value.indexOf( option_value ) ) ? 'selected' : '';
<option {{ selected }} value="{{ _.escape( option_value ) }}">{{{ _.escape( option_title ) }}}</option>
<# if ( data.description ) { #>
<div class="elementor-control-field-description">{{{ data.description }}}</div>