<?php
namespace Elementor;
use Elementor\Core\Utils\Hints;
use Elementor\Modules\DynamicTags\Module as TagsModule;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* Elementor gallery control.
*
* A base control for creating gallery chooser control. Based on the WordPress
* media library galleries. Used to select images from the WordPress media library.
*
* @since 1.0.0
*/
class Control_Gallery extends Base_Data_Control {
/**
* Get gallery control type.
*
* Retrieve the control type, in this case `gallery`.
*
* @since 1.0.0
* @access public
*
* @return string Control type.
*/
public function get_type() {
return 'gallery';
}
public function on_export( $settings ) {
foreach ( $settings as $attachment ) {
if ( ! empty( $attachment['url'] ) ) {
do_action( 'elementor/templates/collect_media_url', $attachment['url'], $attachment );
}
}
return $settings;
}
/**
* Import gallery images.
*
* Used to import gallery control files from external sites while importing
* Elementor template JSON file, and replacing the old data.
*
* @since 1.0.0
* @access public
*
* @param array $settings Control settings.
*
* @return array Control settings.
*/
public function on_import( $settings ) {
foreach ( $settings as &$attachment ) {
if ( empty( $attachment['url'] ) ) {
continue;
}
$local_file_path = \Elementor\TemplateLibrary\Classes\Media_Mapper::get_local_file_path( $attachment['url'] );
$imported_attachment = false;
if ( $local_file_path !== $attachment['url'] && file_exists( $local_file_path ) ) {
$imported_attachment = Plugin::$instance->templates_manager->get_import_images_instance()->import_local_file( $local_file_path );
}
if ( ! $imported_attachment ) {
$imported_attachment = Plugin::$instance->templates_manager->get_import_images_instance()->import( $attachment );
}
$attachment = $imported_attachment;
}
// Filter out attachments that don't exist
$settings = array_filter( $settings );
return $settings;
}
/**
* Render gallery 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 1.0.0
* @access public
*/
public function content_template() {
?>
<div class="elementor-control-field">
<div class="elementor-control-title">{{{ data.label }}}</div>
<div class="elementor-control-input-wrapper">
<# if ( data.description ) { #>
<div class="elementor-control-field-description">{{{ data.description }}}</div>
<# } #>
<div class="elementor-control-media__content elementor-control-tag-area">
<div class="elementor-control-gallery-status elementor-control-dynamic-switcher-wrapper">
<span class="elementor-control-gallery-status-title"></span>
<button class="elementor-control-gallery-clear elementor-control-unit-1 tooltip-target" data-tooltip="<?php echo esc_attr__( 'Clear gallery', 'elementor' ); ?>" aria-label="<?php echo esc_attr__( 'Clear gallery', 'elementor' ); ?>">
<i class="eicon-trash-o" aria-hidden="true"></i>
</button>
</div>
<div class="elementor-control-gallery-content">
<div class="elementor-control-gallery-thumbnails" tabindex="0"></div>
<div class="elementor-control-gallery-edit">
<span><i class="eicon-pencil" aria-hidden="true"></i></span>
<span class="elementor-screen-only"><?php echo esc_html__( 'Edit gallery', 'elementor' ); ?></span>
</div>
<button class="elementor-button elementor-control-gallery-add tooltip-target" data-tooltip="<?php echo esc_attr__( 'Add Images', 'elementor' ); ?>" aria-label="<?php echo esc_attr__( 'Add Images', 'elementor' ); ?>">
<i class="eicon-plus-circle" aria-hidden="true"></i>
</button>
</div>
</div>
<?php
/*
?>
<div class="elementor-control-media__warnings" role="alert" style="display: none;">
<?php
Hints::get_notice_template( [
'type' => 'warning',
'content' => esc_html__( 'This image doesn’t contain ALT text - which is necessary for accessibility and SEO.', 'elementor' ),
'icon' => true,
] );
?>
</div>
<?php
*/ ?>
<?php $this->maybe_display_io_hints(); ?>
</div>
</div>
<?php
}
private function maybe_display_io_hints() {
$plugin_slug = 'image-optimization';
if ( ! Hints::should_display_hint( $plugin_slug ) ) {
return;
}
$one_subscription = Hints::is_plugin_connected_to_one_subscription();
$is_installed = Hints::is_plugin_installed( 'image-optimization' );
$is_active = Hints::is_plugin_active( 'image-optimization' );
if ( $is_active ) {
return;
}
if ( $one_subscription ) {
if ( ! $is_installed ) {
$content = esc_html__( 'Optimize your images to improve site speed and performance. Image Optimization is included in your ONE subscription.', 'elementor' );
$button_text = esc_html__( 'Install now', 'elementor' );
$button_url = Hints::get_plugin_install_url( $plugin_slug );
$source = 'io-editor-gallery-one-install';
} elseif ( ! $is_active ) {
$content = esc_html__( 'Image Optimization is installed and included in your ONE subscription. Activate it to optimize images and improve site performance.', 'elementor' );
$button_text = esc_html__( 'Activate now', 'elementor' );
$button_url = Hints::get_plugin_activate_url( $plugin_slug );
$source = 'io-editor-gallery-one-activate';
}
} else {
$content = esc_html__( 'Optimize your images to enhance site performance by using Image Optimization.', 'elementor' );
if ( ! $is_installed ) {
$button_text = esc_html__( 'Install now', 'elementor' );
$button_url = Hints::get_plugin_install_url( $plugin_slug );
$source = 'io-editor-gallery-install';
} elseif ( ! $is_active ) {
$button_text = esc_html__( 'Activate now', 'elementor' );
$button_url = Hints::get_plugin_activate_url( $plugin_slug );
$source = 'io-editor-gallery-activate';
}
}
?>
<div class="elementor-control-media__promotions" role="alert">
<?php
Hints::get_notice_template( [
'display' => ! Hints::is_dismissed( $plugin_slug ),
'type' => 'info',
'icon' => true,
'heading' => '',
'content' => $content,
'dismissible' => 'image_optimizer_hint',
'button_text' => $button_text,
'button_event' => 'image_optimizer_hint',
'button_data' => [
'action_url' => $button_url,
'source' => $source,
],
] );
?>
</div>
<?php
}
/**
* Get gallery control default settings.
*
* Retrieve the default settings of the gallery control. Used to return the
* default settings while initializing the gallery control.
*
* @since 1.0.0
* @access protected
*
* @return array Control default settings.
*/
protected function get_default_settings() {
return [
'label_block' => true,
'dynamic' => [
'categories' => [ TagsModule::GALLERY_CATEGORY ],
'returnType' => 'object',
],
];
}
/**
* Get gallery control default values.
*
* Retrieve the default value of the gallery control. Used to return the default
* values while initializing the gallery control.
*
* @since 1.0.0
* @access public
*
* @return array Control default value.
*/
public function get_default_value() {
return [];
}
}