first commit

wp-content/plugins/elementor/includes/widgets/menu-anchor.php

@@ -0,0 +1,186 @@
+<?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;
+	}
+}