<?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;
}
}