680 lines
13 KiB
PHP
680 lines
13 KiB
PHP
<?php
|
|
|
|
namespace Elementor\Modules\Shapes\Widgets;
|
|
|
|
use Elementor\Controls_Manager;
|
|
use Elementor\Core\Kits\Documents\Tabs\Global_Typography;
|
|
use Elementor\Group_Control_Typography;
|
|
use Elementor\Modules\Shapes\Module as Shapes_Module;
|
|
use Elementor\Utils;
|
|
use Elementor\Widget_Base;
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
|
exit; // Exit if accessed directly.
|
|
}
|
|
|
|
/**
|
|
* Elementor WordArt widget.
|
|
*
|
|
* Elementor widget that displays text along SVG path.
|
|
*
|
|
*/
|
|
class TextPath extends Widget_Base {
|
|
|
|
const DEFAULT_PATH_FILL = '#E8178A';
|
|
|
|
/**
|
|
* Get widget name.
|
|
*
|
|
* Retrieve Text Path widget name.
|
|
*
|
|
* @return string Widget name.
|
|
* @access public
|
|
*
|
|
*/
|
|
public function get_name() {
|
|
return 'text-path';
|
|
}
|
|
|
|
/**
|
|
* Get widget title.
|
|
*
|
|
* Retrieve Text Path widget title.
|
|
*
|
|
* @return string Widget title.
|
|
* @access public
|
|
*
|
|
*/
|
|
public function get_title() {
|
|
return __( 'Text Path', 'elementor' );
|
|
}
|
|
|
|
/**
|
|
* Get widget icon.
|
|
*
|
|
* Retrieve Text Path widget icon.
|
|
*
|
|
* @return string Widget icon.
|
|
* @access public
|
|
*
|
|
*/
|
|
public function get_icon() {
|
|
return 'eicon-wordart';
|
|
}
|
|
|
|
/**
|
|
* Get widget keywords.
|
|
*
|
|
* Retrieve the list of keywords the widget belongs to.
|
|
*
|
|
* @return array Widget keywords.
|
|
* @access public
|
|
*
|
|
*/
|
|
public function get_keywords() {
|
|
return [ 'text path', 'word path', 'text on path', 'wordart', 'word art' ];
|
|
}
|
|
|
|
/**
|
|
* Register content controls under content tab.
|
|
*/
|
|
protected function register_content_tab() {
|
|
$this->start_controls_section(
|
|
'section_content_text_path',
|
|
[
|
|
'label' => __( 'Text Path', 'elementor' ),
|
|
'tab' => Controls_Manager::TAB_CONTENT,
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'text',
|
|
[
|
|
'label' => __( 'Text', 'elementor' ),
|
|
'type' => Controls_Manager::TEXT,
|
|
'label_block' => true,
|
|
'default' => __( 'Add Your Curvy Text Here', 'elementor' ),
|
|
'frontend_available' => true,
|
|
'render_type' => 'none',
|
|
'dynamic' => [
|
|
'active' => true,
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'path',
|
|
[
|
|
'label' => __( 'Path Type', 'elementor' ),
|
|
'type' => Controls_Manager::SELECT,
|
|
'options' => Shapes_Module::get_paths(),
|
|
'default' => 'wave',
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'custom_path',
|
|
[
|
|
'label' => __( 'SVG', 'elementor' ),
|
|
'type' => Controls_Manager::MEDIA,
|
|
'media_types' => [
|
|
'svg',
|
|
],
|
|
'condition' => [
|
|
'path' => 'custom',
|
|
],
|
|
'dynamic' => [
|
|
'active' => true,
|
|
],
|
|
'description' => sprintf( __( 'Want to create custom text paths with SVG? <a target="_blank" href="%s">Learn More</a>', 'elementor' ), 'https://go.elementor.com/text-path-create-paths' ),
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'link',
|
|
[
|
|
'label' => __( 'Link', 'elementor' ),
|
|
'type' => Controls_Manager::URL,
|
|
'label_block' => true,
|
|
'dynamic' => [
|
|
'active' => true,
|
|
],
|
|
'placeholder' => __( 'Paste URL or type', 'elementor' ),
|
|
'frontend_available' => true,
|
|
]
|
|
);
|
|
|
|
$this->add_responsive_control(
|
|
'align',
|
|
[
|
|
'label' => __( 'Alignment', 'elementor' ),
|
|
'type' => Controls_Manager::CHOOSE,
|
|
'default' => '',
|
|
'options' => [
|
|
'left' => [
|
|
'title' => __( 'Left', 'elementor' ),
|
|
'icon' => 'eicon-text-align-left',
|
|
],
|
|
'center' => [
|
|
'title' => __( 'Center', 'elementor' ),
|
|
'icon' => 'eicon-text-align-center',
|
|
],
|
|
'right' => [
|
|
'title' => __( 'Right', 'elementor' ),
|
|
'icon' => 'eicon-text-align-right',
|
|
],
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--alignment: {{VALUE}}',
|
|
],
|
|
'frontend_available' => true,
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'text_path_direction',
|
|
[
|
|
'label' => __( 'Text Direction', 'elementor' ),
|
|
'type' => Controls_Manager::SELECT,
|
|
'default' => '',
|
|
'options' => [
|
|
'' => __( 'Default', 'elementor' ),
|
|
'rtl' => __( 'RTL', 'elementor' ),
|
|
'ltr' => __( 'LTR', 'elementor' ),
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--direction: {{VALUE}}',
|
|
],
|
|
'frontend_available' => true,
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'show_path',
|
|
[
|
|
'label' => __( 'Show Path', 'elementor' ),
|
|
'type' => Controls_Manager::SWITCHER,
|
|
'label_on' => __( 'On', 'elementor' ),
|
|
'label_off' => __( 'Off', 'elementor' ),
|
|
'return_value' => self::DEFAULT_PATH_FILL,
|
|
'separator' => 'before',
|
|
'default' => '',
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--path-stroke: {{VALUE}}; --path-fill: transparent;',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->end_controls_section();
|
|
}
|
|
|
|
/**
|
|
* Register style controls under style tab.
|
|
*/
|
|
protected function register_style_tab() {
|
|
/**
|
|
* Text Path styling section.
|
|
*/
|
|
$this->start_controls_section(
|
|
'section_style_text_path',
|
|
[
|
|
'label' => __( 'Text Path', 'elementor' ),
|
|
'tab' => Controls_Manager::TAB_STYLE,
|
|
]
|
|
);
|
|
|
|
$this->add_responsive_control(
|
|
'size',
|
|
[
|
|
'label' => __( 'Size', 'elementor' ),
|
|
'type' => Controls_Manager::SLIDER,
|
|
'size_units' => [ '%', 'px' ],
|
|
'range' => [
|
|
'%' => [
|
|
'min' => 0,
|
|
'max' => 100,
|
|
'step' => 10,
|
|
],
|
|
'px' => [
|
|
'min' => 0,
|
|
'max' => 800,
|
|
'step' => 50,
|
|
],
|
|
],
|
|
'default' => [
|
|
'unit' => 'px',
|
|
'size' => 500,
|
|
],
|
|
'tablet_default' => [
|
|
'unit' => 'px',
|
|
'size' => 500,
|
|
],
|
|
'mobile_default' => [
|
|
'unit' => 'px',
|
|
'size' => 500,
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--width: {{SIZE}}{{UNIT}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_responsive_control(
|
|
'rotation',
|
|
[
|
|
'label' => __( 'Rotate', 'elementor' ),
|
|
'type' => Controls_Manager::SLIDER,
|
|
'size_units' => [ 'deg' ],
|
|
'range' => [
|
|
'deg' => [
|
|
'min' => 0,
|
|
'max' => 360,
|
|
'step' => 1,
|
|
],
|
|
],
|
|
'default' => [
|
|
'unit' => 'deg',
|
|
'size' => '',
|
|
],
|
|
'tablet_default' => [
|
|
'unit' => 'deg',
|
|
'size' => '',
|
|
],
|
|
'mobile_default' => [
|
|
'unit' => 'deg',
|
|
'size' => '',
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--rotate: {{SIZE}}{{UNIT}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'text_heading',
|
|
[
|
|
'label' => __( 'Text', 'elementor' ),
|
|
'type' => Controls_Manager::HEADING,
|
|
]
|
|
);
|
|
|
|
$this->add_group_control(
|
|
Group_Control_Typography::get_type(),
|
|
[
|
|
'name' => 'text_typography',
|
|
'selector' => '{{WRAPPER}}',
|
|
'global' => [
|
|
'default' => Global_Typography::TYPOGRAPHY_TEXT,
|
|
],
|
|
'fields_options' => [
|
|
'font_size' => [
|
|
'default' => [
|
|
'size' => '20',
|
|
'unit' => 'px',
|
|
],
|
|
'size_units' => [ 'px' ],
|
|
],
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_responsive_control(
|
|
'word_spacing',
|
|
[
|
|
'label' => __( 'Word Spacing', 'elementor' ),
|
|
'type' => Controls_Manager::SLIDER,
|
|
'size_units' => [ 'px' ],
|
|
'range' => [
|
|
'px' => [
|
|
'min' => -20,
|
|
'max' => 20,
|
|
'step' => 1,
|
|
],
|
|
],
|
|
'default' => [
|
|
'unit' => 'px',
|
|
'size' => '',
|
|
],
|
|
'tablet_default' => [
|
|
'unit' => 'px',
|
|
'size' => '',
|
|
],
|
|
'mobile_default' => [
|
|
'unit' => 'px',
|
|
'size' => '',
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--word-spacing: {{SIZE}}{{UNIT}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'start_point',
|
|
[
|
|
'label' => __( 'Starting Point', 'elementor' ),
|
|
'type' => Controls_Manager::SLIDER,
|
|
'size_units' => [ '%' ],
|
|
'range' => [
|
|
'px' => [
|
|
'min' => -100,
|
|
'max' => 100,
|
|
'step' => 1,
|
|
],
|
|
],
|
|
'default' => [
|
|
'unit' => '%',
|
|
'size' => 0,
|
|
],
|
|
'frontend_available' => true,
|
|
'render_type' => 'none',
|
|
]
|
|
);
|
|
|
|
$this->start_controls_tabs( 'text_style' );
|
|
|
|
/**
|
|
* Normal tab.
|
|
*/
|
|
$this->start_controls_tab(
|
|
'text_normal',
|
|
[
|
|
'label' => __( 'Normal', 'elementor' ),
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'text_color_normal',
|
|
[
|
|
'label' => __( 'Color', 'elementor' ),
|
|
'type' => Controls_Manager::COLOR,
|
|
'default' => '',
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--text-color: {{VALUE}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->end_controls_tab();
|
|
|
|
/**
|
|
* Hover tab.
|
|
*/
|
|
$this->start_controls_tab(
|
|
'text_hover',
|
|
[
|
|
'label' => __( 'Hover', 'elementor' ),
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'text_color_hover',
|
|
[
|
|
'label' => __( 'Color', 'elementor' ),
|
|
'type' => Controls_Manager::COLOR,
|
|
'default' => '',
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--text-color-hover: {{VALUE}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'hover_animation',
|
|
[
|
|
'label' => __( 'Hover Animation', 'elementor' ),
|
|
'type' => Controls_Manager::HOVER_ANIMATION,
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'hover_transition',
|
|
[
|
|
'label' => __( 'Transition Duration', 'elementor' ),
|
|
'type' => Controls_Manager::SLIDER,
|
|
'default' => [
|
|
'size' => 0.3,
|
|
'unit' => 's',
|
|
],
|
|
'range' => [
|
|
's' => [
|
|
'min' => 0,
|
|
'max' => 3,
|
|
'step' => 0.1,
|
|
],
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--transition: {{SIZE}}{{UNIT}}',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->end_controls_tab();
|
|
|
|
$this->end_controls_tabs();
|
|
|
|
$this->end_controls_section();
|
|
|
|
/**
|
|
* Path styling section.
|
|
*/
|
|
$this->start_controls_section(
|
|
'section_style_path',
|
|
[
|
|
'label' => __( 'Path', 'elementor' ),
|
|
'tab' => Controls_Manager::TAB_STYLE,
|
|
'condition' => [
|
|
'show_path!' => '',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->start_controls_tabs( 'path_style' );
|
|
|
|
/**
|
|
* Normal tab.
|
|
*/
|
|
$this->start_controls_tab(
|
|
'path_normal',
|
|
[
|
|
'label' => __( 'Normal', 'elementor' ),
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'path_fill_normal',
|
|
[
|
|
'label' => __( 'Color', 'elementor' ),
|
|
'type' => Controls_Manager::COLOR,
|
|
'default' => '',
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--path-fill: {{VALUE}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'stroke_heading_normal',
|
|
[
|
|
'label' => __( 'Stroke', 'elementor' ),
|
|
'type' => Controls_Manager::HEADING,
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'stroke_color_normal',
|
|
[
|
|
'label' => __( 'Color', 'elementor' ),
|
|
'type' => Controls_Manager::COLOR,
|
|
'default' => self::DEFAULT_PATH_FILL,
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--stroke-color: {{VALUE}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'stroke_width_normal',
|
|
[
|
|
'label' => __( 'Width', 'elementor' ),
|
|
'type' => Controls_Manager::SLIDER,
|
|
'default' => [
|
|
'size' => 1,
|
|
'unit' => 'px',
|
|
],
|
|
'range' => [
|
|
'px' => [
|
|
'min' => 0,
|
|
'max' => 20,
|
|
'step' => 1,
|
|
],
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--stroke-width: {{SIZE}}{{UNIT}}',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->end_controls_tab();
|
|
|
|
/**
|
|
* Hover tab.
|
|
*/
|
|
$this->start_controls_tab(
|
|
'path_hover',
|
|
[
|
|
'label' => __( 'Hover', 'elementor' ),
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'path_fill_hover',
|
|
[
|
|
'label' => __( 'Color', 'elementor' ),
|
|
'type' => Controls_Manager::COLOR,
|
|
'default' => '',
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--path-fill-hover: {{VALUE}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'stroke_heading_hover',
|
|
[
|
|
'label' => __( 'Stroke', 'elementor' ),
|
|
'type' => Controls_Manager::HEADING,
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'stroke_color_hover',
|
|
[
|
|
'label' => __( 'Color', 'elementor' ),
|
|
'type' => Controls_Manager::COLOR,
|
|
'default' => '',
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--stroke-color-hover: {{VALUE}};',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'stroke_width_hover',
|
|
[
|
|
'label' => __( 'Width', 'elementor' ),
|
|
'type' => Controls_Manager::SLIDER,
|
|
'default' => [
|
|
'size' => '',
|
|
'unit' => 'px',
|
|
],
|
|
'range' => [
|
|
'px' => [
|
|
'min' => 0,
|
|
'max' => 20,
|
|
'step' => 1,
|
|
],
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--stroke-width-hover: {{SIZE}}{{UNIT}}',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->add_control(
|
|
'stroke_transition',
|
|
[
|
|
'label' => __( 'Transition Duration', 'elementor' ),
|
|
'type' => Controls_Manager::SLIDER,
|
|
'default' => [
|
|
'size' => 0.3,
|
|
'unit' => 's',
|
|
],
|
|
'range' => [
|
|
's' => [
|
|
'min' => 0,
|
|
'max' => 3,
|
|
'step' => 0.1,
|
|
],
|
|
],
|
|
'selectors' => [
|
|
'{{WRAPPER}}' => '--stroke-transition: {{SIZE}}{{UNIT}}',
|
|
],
|
|
]
|
|
);
|
|
|
|
$this->end_controls_tab();
|
|
|
|
$this->end_controls_tabs();
|
|
|
|
$this->end_controls_section();
|
|
}
|
|
|
|
/**
|
|
* Register Text Path widget controls.
|
|
*
|
|
* Adds different input fields to allow the user to change and customize the widget settings.
|
|
*
|
|
* @access protected
|
|
*/
|
|
protected function register_controls() {
|
|
$this->register_content_tab();
|
|
$this->register_style_tab();
|
|
}
|
|
|
|
/**
|
|
* Render Text Path widget output on the frontend.
|
|
*
|
|
* Written in PHP and used to generate the final HTML.
|
|
*
|
|
* @access protected
|
|
*/
|
|
protected function render() {
|
|
$settings = $this->get_settings_for_display();
|
|
|
|
// Get the shape SVG markup.
|
|
if ( 'custom' !== $settings['path'] ) {
|
|
$path_svg = Shapes_Module::get_path_svg( $settings['path'] );
|
|
} else {
|
|
$url = $settings['custom_path']['url'];
|
|
// Get the file contents only if it's svg.
|
|
$path_svg = ( 'svg' === pathinfo( $url, PATHINFO_EXTENSION ) ) ? file_get_contents( $url ) : '';
|
|
}
|
|
|
|
// Add Text Path text.
|
|
$this->add_render_attribute( 'text_path', 'class', 'e-text-path' );
|
|
|
|
// Add hover animation.
|
|
if ( ! empty( $settings['hover_animation'] ) ) {
|
|
$this->add_render_attribute( 'text_path', 'class', 'elementor-animation-' . $settings['hover_animation'] );
|
|
}
|
|
|
|
// Render.
|
|
?>
|
|
<div <?php echo $this->get_render_attribute_string( 'text_path' ); ?>>
|
|
<?php echo $path_svg; ?>
|
|
</div>
|
|
<?php
|
|
}
|
|
}
|