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