187 lines
3.5 KiB
PHP
187 lines
3.5 KiB
PHP
|
<?php
|
||
|
namespace Elementor;
|
||
|
|
||
|
if ( ! defined( 'ABSPATH' ) ) {
|
||
|
exit; // Exit if accessed directly.
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Elementor menu anchor widget.
|
||
|
*
|
||
|
* Elementor widget that allows to link and menu to a specific position on the
|
||
|
* page.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
*/
|
||
|
class Widget_Menu_Anchor extends Widget_Base {
|
||
|
|
||
|
/**
|
||
|
* Get widget name.
|
||
|
*
|
||
|
* Retrieve menu anchor widget name.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access public
|
||
|
*
|
||
|
* @return string Widget name.
|
||
|
*/
|
||
|
public function get_name() {
|
||
|
return 'menu-anchor';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Get widget title.
|
||
|
*
|
||
|
* Retrieve menu anchor widget title.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access public
|
||
|
*
|
||
|
* @return string Widget title.
|
||
|
*/
|
||
|
public function get_title() {
|
||
|
return esc_html__( 'Menu Anchor', 'elementor' );
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Get widget icon.
|
||
|
*
|
||
|
* Retrieve menu anchor widget icon.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access public
|
||
|
*
|
||
|
* @return string Widget icon.
|
||
|
*/
|
||
|
public function get_icon() {
|
||
|
return 'eicon-anchor';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* 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 [ 'menu', 'anchor', 'link' ];
|
||
|
}
|
||
|
|
||
|
protected function is_dynamic_content(): bool {
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Register menu anchor 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_anchor',
|
||
|
[
|
||
|
'label' => esc_html__( 'Menu Anchor', 'elementor' ),
|
||
|
]
|
||
|
);
|
||
|
|
||
|
$this->add_control(
|
||
|
'anchor',
|
||
|
[
|
||
|
'label' => esc_html__( 'The ID of Menu Anchor.', 'elementor' ),
|
||
|
'type' => Controls_Manager::TEXT,
|
||
|
'ai' => [
|
||
|
'active' => false,
|
||
|
],
|
||
|
'placeholder' => esc_html__( 'For Example: About', 'elementor' ),
|
||
|
'description' => esc_html__( 'This ID will be the CSS ID you will have to use in your own page, Without #.', 'elementor' ),
|
||
|
'label_block' => true,
|
||
|
'dynamic' => [
|
||
|
'active' => true,
|
||
|
],
|
||
|
]
|
||
|
);
|
||
|
|
||
|
$this->add_control(
|
||
|
'anchor_note',
|
||
|
[
|
||
|
'type' => Controls_Manager::ALERT,
|
||
|
'alert_type' => 'warning',
|
||
|
'content' => sprintf(
|
||
|
/* translators: %s: Accepted chars. */
|
||
|
esc_html__( 'Note: The ID link ONLY accepts these chars: %s', 'elementor' ),
|
||
|
'`A-Z, a-z, 0-9, _ , -`'
|
||
|
),
|
||
|
]
|
||
|
);
|
||
|
|
||
|
$this->end_controls_section();
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Render menu anchor widget output on the frontend.
|
||
|
*
|
||
|
* Written in PHP and used to generate the final HTML.
|
||
|
*
|
||
|
* @since 1.0.0
|
||
|
* @access protected
|
||
|
*/
|
||
|
protected function render() {
|
||
|
$anchor = $this->get_settings_for_display( 'anchor' );
|
||
|
|
||
|
if ( empty( $anchor ) ) {
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
$this->add_render_attribute(
|
||
|
'inner',
|
||
|
[
|
||
|
'class' => 'elementor-menu-anchor',
|
||
|
'id' => sanitize_html_class( $anchor ),
|
||
|
]
|
||
|
);
|
||
|
?>
|
||
|
<div <?php $this->print_render_attribute_string( 'inner' ); ?>></div>
|
||
|
<?php
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Render menu anchor 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.anchor ) {
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
view.addRenderAttribute(
|
||
|
'inner',
|
||
|
{
|
||
|
'class': 'elementor-menu-anchor',
|
||
|
'id': settings.anchor,
|
||
|
}
|
||
|
);
|
||
|
#>
|
||
|
<div {{{ view.getRenderAttributeString( 'inner' ) }}}></div>
|
||
|
<?php
|
||
|
}
|
||
|
|
||
|
protected function on_save( array $settings ) {
|
||
|
$settings['anchor'] = sanitize_html_class( $settings['anchor'] );
|
||
|
|
||
|
return $settings;
|
||
|
}
|
||
|
}
|