174 lines
3.2 KiB
PHP
174 lines
3.2 KiB
PHP
|
<?php
|
||
|
namespace Elementor;
|
||
|
|
||
|
if ( ! defined( 'ABSPATH' ) ) {
|
||
|
exit; // Exit if accessed directly.
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Elementor spacer widget.
|
||
|
*
|
||
|
* Elementor widget that inserts a space that divides various elements.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
*/
|
||
|
class Widget_Spacer extends Widget_Base {
|
||
|
|
||
|
/**
|
||
|
* Get widget name.
|
||
|
*
|
||
|
* Retrieve spacer widget name.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access public
|
||
|
*
|
||
|
* @return string Widget name.
|
||
|
*/
|
||
|
public function get_name() {
|
||
|
return 'spacer';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Get widget title.
|
||
|
*
|
||
|
* Retrieve spacer widget title.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access public
|
||
|
*
|
||
|
* @return string Widget title.
|
||
|
*/
|
||
|
public function get_title() {
|
||
|
return esc_html__( 'Spacer', 'elementor' );
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Get widget icon.
|
||
|
*
|
||
|
* Retrieve spacer widget icon.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access public
|
||
|
*
|
||
|
* @return string Widget icon.
|
||
|
*/
|
||
|
public function get_icon() {
|
||
|
return 'eicon-spacer';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Get widget categories.
|
||
|
*
|
||
|
* Retrieve the list of categories the spacer widget belongs to.
|
||
|
*
|
||
|
* Used to determine where to display the widget in the editor.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access public
|
||
|
*
|
||
|
* @return array Widget categories.
|
||
|
*/
|
||
|
public function get_categories() {
|
||
|
return [ 'basic' ];
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Get widget keywords.
|
||
|
*
|
||
|
* Retrieve the list of keywords the widget belongs to.
|
||
|
*
|
||
|
* @since 2.1.0
|
||
|
* @access public
|
||
|
*
|
||
|
* @return array Widget keywords.
|
||
|
*/
|
||
|
public function get_keywords() {
|
||
|
return [ 'space' ];
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Register spacer widget controls.
|
||
|
*
|
||
|
* Adds different input fields to allow the user to change and customize the widget settings.
|
||
|
*
|
||
|
* @since 3.1.0
|
||
|
* @access protected
|
||
|
*/
|
||
|
protected function register_controls() {
|
||
|
$this->start_controls_section(
|
||
|
'section_spacer',
|
||
|
[
|
||
|
'label' => esc_html__( 'Spacer', 'elementor' ),
|
||
|
]
|
||
|
);
|
||
|
|
||
|
$this->add_responsive_control(
|
||
|
'space',
|
||
|
[
|
||
|
'label' => esc_html__( 'Space', 'elementor' ),
|
||
|
'type' => Controls_Manager::SLIDER,
|
||
|
'default' => [
|
||
|
'size' => 50,
|
||
|
],
|
||
|
'size_units' => [ 'px', 'em', 'rem', 'vh', 'custom' ],
|
||
|
'range' => [
|
||
|
'px' => [
|
||
|
'max' => 600,
|
||
|
],
|
||
|
'em' => [
|
||
|
'max' => 20,
|
||
|
],
|
||
|
],
|
||
|
'render_type' => 'template',
|
||
|
'selectors' => [
|
||
|
'{{WRAPPER}}' => '--spacer-size: {{SIZE}}{{UNIT}};',
|
||
|
],
|
||
|
]
|
||
|
);
|
||
|
|
||
|
$this->end_controls_section();
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Render spacer widget output on the frontend.
|
||
|
*
|
||
|
* Written in PHP and used to generate the final HTML.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access protected
|
||
|
*/
|
||
|
protected function render() {
|
||
|
$settings = $this->get_settings_for_display();
|
||
|
|
||
|
if ( empty( $settings['space'] ) || empty( $settings['space']['size'] ) || 0 === $settings['space']['size'] ) {
|
||
|
return;
|
||
|
}
|
||
|
?>
|
||
|
<div class="elementor-spacer">
|
||
|
<div class="elementor-spacer-inner"></div>
|
||
|
</div>
|
||
|
<?php
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Render spacer widget output in the editor.
|
||
|
*
|
||
|
* Written as a Backbone JavaScript template and used to generate the live preview.
|
||
|
*
|
||
|
* @since 2.9.0
|
||
|
* @access protected
|
||
|
*/
|
||
|
protected function content_template() {
|
||
|
?>
|
||
|
<#
|
||
|
if ( '' === settings.space || '' === settings.space.size || 0 === settings.space.size ) {
|
||
|
return;
|
||
|
}
|
||
|
#>
|
||
|
<div class="elementor-spacer">
|
||
|
<div class="elementor-spacer-inner"></div>
|
||
|
</div>
|
||
|
<?php
|
||
|
}
|
||
|
}
|