<?php
namespace Elementor;
use Elementor\Modules\DynamicTags\Module as TagsModule;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* Elementor Icons control.
*
* A base control for creating a Icons chooser control.
* Used to select an Icon.
*
* Usage: @see https://developers.elementor.com/elementor-controls/icons-control
*
* @since 2.6.0
*/
class Control_Icons extends Control_Base_Multiple {
/**
* Get media control type.
*
* Retrieve the control type, in this case `media`.
*
* @access public
* @since 2.6.0
* @return string Control type.
*/
public function get_type() {
return 'icons';
}
/**
* Get Icons control default values.
*
* Retrieve the default value of the Icons control. Used to return the default
* values while initializing the Icons control.
*
* @access public
* @since 2.6.0
* @return array Control default value.
*/
public function get_default_value() {
return [
'value' => '',
'library' => '',
];
}
/**
* Render Icons 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
* object.
*
* @since 2.6.0
* @access public
*/
public function content_template() {
?>
<# if ( 'inline' === data.skin ) { #>
<?php $this->render_inline_skin(); ?>
<# } else { #>
<?php $this->render_media_skin(); ?>
<# } #>
<?php
}
public function render_media_skin() {
?>
<div class="elementor-control-field elementor-control-media">
<label class="elementor-control-title">{{{ data.label }}}</label>
<div class="elementor-control-input-wrapper">
<div class="elementor-control-media__content elementor-control-tag-area elementor-control-preview-area">
<div class="elementor-control-media-upload-button elementor-control-media__content__upload-button">
<i class="eicon-plus-circle" aria-hidden="true"></i>
<span class="elementor-screen-only"><?php echo esc_html__( 'Add', 'elementor' ); ?></span>
</div>
<div class="elementor-control-media-area">
<div class="elementor-control-media__remove elementor-control-media__content__remove" title="<?php echo esc_attr__( 'Remove', 'elementor' ); ?>">
<i class="eicon-trash-o" aria-hidden="true"></i>
<span class="elementor-screen-only"><?php echo esc_html__( 'Remove', 'elementor' ); ?></span>
</div>
<div class="elementor-control-media__preview"></div>
</div>
<div class="elementor-control-media__tools elementor-control-dynamic-switcher-wrapper">
<div class="elementor-control-icon-picker elementor-control-media__tool"><?php echo esc_html__( 'Icon Library', 'elementor' ); ?></div>
<div class="elementor-control-svg-uploader elementor-control-media__tool"><?php echo esc_html__( 'Upload SVG', 'elementor' ); ?></div>
</div>
</div>
</div>
<# if ( data.description ) { #>
<div class="elementor-control-field-description">{{{ data.description }}}</div>
<# } #>
<input type="hidden" data-setting="{{ data.name }}"/>
</div>
<?php
}
public function render_inline_skin() {
?>
<#
const defaultSkinSettings = {
none: {
label: '<?php echo esc_html__( 'None', 'elementor' ); ?>',
icon: 'eicon-ban',
},
svg: {
label: '<?php echo esc_html__( 'Upload SVG', 'elementor' ); ?>',
icon: 'eicon-upload',
},
icon: {
label: '<?php echo esc_html__( 'Icon Library', 'elementor' ); ?>',
icon: 'eicon-circle',
}
};
const skinSettings = data.skin_settings.inline;
const get = ( type, key ) => {
if ( skinSettings[ type ] ) {
return skinSettings[ type ]?.[ key ] || defaultSkinSettings[ type ][ key ];
}
return defaultSkinSettings[ type ][ key ];
}
#>
<div class="elementor-control-field elementor-control-inline-icon">
<label class="elementor-control-title">{{{ data.label }}}</label>
<div class="elementor-control-input-wrapper">
<div class="elementor-choices">
<# if ( ! data.exclude_inline_options.includes( 'none' ) ) { #>
<input id="<?php $this->print_control_uid(); ?>-none" type="radio" value="none">
<label class="elementor-choices-label elementor-control-unit-1 tooltip-target elementor-control-icons--inline__none" for="<?php $this->print_control_uid(); ?>-none" data-tooltip="{{ get( 'none', 'label' ) }}" title="{{ get( 'none', 'label' ) }}">
<i class="{{ get( 'none', 'icon' ) }}" aria-hidden="true"></i>
<span class="elementor-screen-only">{{ get( 'none', 'label' ) }}</span>
</label>
<# }
if ( ! data.exclude_inline_options.includes( 'svg' ) ) { #>
<input id="<?php $this->print_control_uid(); ?>-svg" type="radio" value="svg">
<label class="elementor-choices-label elementor-control-unit-1 tooltip-target elementor-control-icons--inline__svg" for="<?php $this->print_control_uid(); ?>-svg" data-tooltip="{{ get( 'svg', 'label' ) }}" title="{{ get( 'svg', 'label' ) }}">
<i class="{{ get( 'svg', 'icon' ) }}" aria-hidden="true"></i>
<span class="elementor-screen-only">{{ get( 'svg', 'label' ) }}</span>
</label>
<# }
if ( ! data.exclude_inline_options.includes( 'icon' ) ) { #>
<input id="<?php $this->print_control_uid(); ?>-icon" type="radio" value="icon">
<label class="elementor-choices-label elementor-control-unit-1 tooltip-target elementor-control-icons--inline__icon" for="<?php $this->print_control_uid(); ?>-icon" data-tooltip="{{ get( 'icon', 'label' ) }}" title="{{ get( 'icon', 'label' ) }}">
<span class="elementor-control-icons--inline__displayed-icon">
<i class="{{ get( 'icon', 'icon' ) }}" aria-hidden="true"></i>
</span>
<span class="elementor-screen-only">{{ get( 'icon', 'label' ) }}</span>
</label>
<# } #>
</div>
</div>
</div>
<# if ( data.description ) { #>
<div class="elementor-control-field-description">{{{ data.description }}}</div>
<# } #>
<?php
}
/**
* Get Icons control default settings.
*
* Retrieve the default settings of the Icons control. Used to return the default
* settings while initializing the Icons control.
*
* @since 2.6.0
* @access protected
*
* @return array Control default settings.
*/
protected function get_default_settings() {
return [
'label_block' => true,
'dynamic' => [
'categories' => [ TagsModule::IMAGE_CATEGORY ],
'returnType' => 'object',
],
'search_bar' => true,
'recommended' => false,
'skin' => 'media',
'exclude_inline_options' => [],
'disable_initial_active_state' => false,
'skin_settings' => [
'inline' => [
'none' => [
'label' => esc_html__( 'None', 'elementor' ),
'icon' => 'eicon-ban',
],
'svg' => [
'label' => esc_html__( 'Upload SVG', 'elementor' ),
'icon' => 'eicon-upload',
],
'icon' => [
'label' => esc_html__( 'Icon Library', 'elementor' ),
'icon' => 'eicon-circle',
],
],
],
];
}
/**
* Support SVG Import
*
* @deprecated 3.5.0
*
* @param $mimes
* @return mixed
*/
public function support_svg_import( $mimes ) {
Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.5.0' );
$mimes['svg'] = 'image/svg+xml';
return $mimes;
}
public function on_import( $settings ) {
if ( empty( $settings['library'] ) || 'svg' !== $settings['library'] || empty( $settings['value']['url'] ) ) {
return $settings;
}
$imported = Plugin::$instance->templates_manager->get_import_images_instance()->import( $settings['value'] );
if ( ! $imported ) {
$settings['value'] = '';
$settings['library'] = '';
} else {
$settings['value'] = $imported;
}
return $settings;
}
}