| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543 |
- <?php
- namespace Elementor;
- if ( ! defined( 'ABSPATH' ) ) {
- exit; // Exit if accessed directly.
- }
- /**
- * Elementor button widget.
- *
- * Elementor widget that displays a button with the ability to control every
- * aspect of the button design.
- *
- * @since 1.0.0
- */
- class Widget_Button extends Widget_Base {
- /**
- * Get widget name.
- *
- * Retrieve button widget name.
- *
- * @since 1.0.0
- * @access public
- *
- * @return string Widget name.
- */
- public function get_name() {
- return 'button';
- }
- /**
- * Get widget title.
- *
- * Retrieve button widget title.
- *
- * @since 1.0.0
- * @access public
- *
- * @return string Widget title.
- */
- public function get_title() {
- return __( 'Button', 'elementor' );
- }
- /**
- * Get widget icon.
- *
- * Retrieve button widget icon.
- *
- * @since 1.0.0
- * @access public
- *
- * @return string Widget icon.
- */
- public function get_icon() {
- return 'eicon-button';
- }
- /**
- * Get widget categories.
- *
- * Retrieve the list of categories the button widget belongs to.
- *
- * Used to determine where to display the widget in the editor.
- *
- * @since 2.0.0
- * @access public
- *
- * @return array Widget categories.
- */
- public function get_categories() {
- return [ 'basic' ];
- }
- /**
- * Get button sizes.
- *
- * Retrieve an array of button sizes for the button widget.
- *
- * @since 1.0.0
- * @access public
- * @static
- *
- * @return array An array containing button sizes.
- */
- public static function get_button_sizes() {
- return [
- 'xs' => __( 'Extra Small', 'elementor' ),
- 'sm' => __( 'Small', 'elementor' ),
- 'md' => __( 'Medium', 'elementor' ),
- 'lg' => __( 'Large', 'elementor' ),
- 'xl' => __( 'Extra Large', 'elementor' ),
- ];
- }
- /**
- * Register button widget controls.
- *
- * Adds different input fields to allow the user to change and customize the widget settings.
- *
- * @since 1.0.0
- * @access protected
- */
- protected function _register_controls() {
- $this->start_controls_section(
- 'section_button',
- [
- 'label' => __( 'Button', 'elementor' ),
- ]
- );
- $this->add_control(
- 'button_type',
- [
- 'label' => __( 'Type', 'elementor' ),
- 'type' => Controls_Manager::SELECT,
- 'default' => '',
- 'options' => [
- '' => __( 'Default', 'elementor' ),
- 'info' => __( 'Info', 'elementor' ),
- 'success' => __( 'Success', 'elementor' ),
- 'warning' => __( 'Warning', 'elementor' ),
- 'danger' => __( 'Danger', 'elementor' ),
- ],
- 'prefix_class' => 'elementor-button-',
- ]
- );
- $this->add_control(
- 'text',
- [
- 'label' => __( 'Text', 'elementor' ),
- 'type' => Controls_Manager::TEXT,
- 'dynamic' => [
- 'active' => true,
- ],
- 'default' => __( 'Click here', 'elementor' ),
- 'placeholder' => __( 'Click here', 'elementor' ),
- ]
- );
- $this->add_control(
- 'link',
- [
- 'label' => __( 'Link', 'elementor' ),
- 'type' => Controls_Manager::URL,
- 'dynamic' => [
- 'active' => true,
- ],
- 'placeholder' => __( 'https://your-link.com', 'elementor' ),
- 'default' => [
- 'url' => '#',
- ],
- ]
- );
- $this->add_responsive_control(
- 'align',
- [
- 'label' => __( 'Alignment', 'elementor' ),
- 'type' => Controls_Manager::CHOOSE,
- 'options' => [
- 'left' => [
- 'title' => __( 'Left', 'elementor' ),
- 'icon' => 'fa fa-align-left',
- ],
- 'center' => [
- 'title' => __( 'Center', 'elementor' ),
- 'icon' => 'fa fa-align-center',
- ],
- 'right' => [
- 'title' => __( 'Right', 'elementor' ),
- 'icon' => 'fa fa-align-right',
- ],
- 'justify' => [
- 'title' => __( 'Justified', 'elementor' ),
- 'icon' => 'fa fa-align-justify',
- ],
- ],
- 'prefix_class' => 'elementor%s-align-',
- 'default' => '',
- ]
- );
- $this->add_control(
- 'size',
- [
- 'label' => __( 'Size', 'elementor' ),
- 'type' => Controls_Manager::SELECT,
- 'default' => 'sm',
- 'options' => self::get_button_sizes(),
- 'style_transfer' => true,
- ]
- );
- $this->add_control(
- 'icon',
- [
- 'label' => __( 'Icon', 'elementor' ),
- 'type' => Controls_Manager::ICON,
- 'label_block' => true,
- 'default' => '',
- ]
- );
- $this->add_control(
- 'icon_align',
- [
- 'label' => __( 'Icon Position', 'elementor' ),
- 'type' => Controls_Manager::SELECT,
- 'default' => 'left',
- 'options' => [
- 'left' => __( 'Before', 'elementor' ),
- 'right' => __( 'After', 'elementor' ),
- ],
- 'condition' => [
- 'icon!' => '',
- ],
- ]
- );
- $this->add_control(
- 'icon_indent',
- [
- 'label' => __( 'Icon Spacing', 'elementor' ),
- 'type' => Controls_Manager::SLIDER,
- 'range' => [
- 'px' => [
- 'max' => 50,
- ],
- ],
- 'condition' => [
- 'icon!' => '',
- ],
- 'selectors' => [
- '{{WRAPPER}} .elementor-button .elementor-align-icon-right' => 'margin-left: {{SIZE}}{{UNIT}};',
- '{{WRAPPER}} .elementor-button .elementor-align-icon-left' => 'margin-right: {{SIZE}}{{UNIT}};',
- ],
- ]
- );
- $this->add_control(
- 'view',
- [
- 'label' => __( 'View', 'elementor' ),
- 'type' => Controls_Manager::HIDDEN,
- 'default' => 'traditional',
- ]
- );
- $this->add_control(
- 'button_css_id',
- [
- 'label' => __( 'Button ID', 'elementor' ),
- 'type' => Controls_Manager::TEXT,
- 'default' => '',
- 'title' => __( 'Add your custom id WITHOUT the Pound key. e.g: my-id', 'elementor' ),
- 'label_block' => false,
- 'description' => __( 'Please make sure the ID is unique and not used elsewhere on the page this form is displayed. This field allows <code>A-z 0-9</code> & underscore chars without spaces.', 'elementor' ),
- 'separator' => 'before',
- ]
- );
- $this->end_controls_section();
- $this->start_controls_section(
- 'section_style',
- [
- 'label' => __( 'Button', 'elementor' ),
- 'tab' => Controls_Manager::TAB_STYLE,
- ]
- );
- $this->add_group_control(
- Group_Control_Typography::get_type(),
- [
- 'name' => 'typography',
- 'scheme' => Scheme_Typography::TYPOGRAPHY_4,
- 'selector' => '{{WRAPPER}} a.elementor-button, {{WRAPPER}} .elementor-button',
- ]
- );
- $this->start_controls_tabs( 'tabs_button_style' );
- $this->start_controls_tab(
- 'tab_button_normal',
- [
- 'label' => __( 'Normal', 'elementor' ),
- ]
- );
- $this->add_control(
- 'button_text_color',
- [
- 'label' => __( 'Text Color', 'elementor' ),
- 'type' => Controls_Manager::COLOR,
- 'default' => '',
- 'selectors' => [
- '{{WRAPPER}} a.elementor-button, {{WRAPPER}} .elementor-button' => 'color: {{VALUE}};',
- ],
- ]
- );
- $this->add_control(
- 'background_color',
- [
- 'label' => __( 'Background Color', 'elementor' ),
- 'type' => Controls_Manager::COLOR,
- 'scheme' => [
- 'type' => Scheme_Color::get_type(),
- 'value' => Scheme_Color::COLOR_4,
- ],
- 'selectors' => [
- '{{WRAPPER}} a.elementor-button, {{WRAPPER}} .elementor-button' => 'background-color: {{VALUE}};',
- ],
- ]
- );
- $this->end_controls_tab();
- $this->start_controls_tab(
- 'tab_button_hover',
- [
- 'label' => __( 'Hover', 'elementor' ),
- ]
- );
- $this->add_control(
- 'hover_color',
- [
- 'label' => __( 'Text Color', 'elementor' ),
- 'type' => Controls_Manager::COLOR,
- 'selectors' => [
- '{{WRAPPER}} a.elementor-button:hover, {{WRAPPER}} .elementor-button:hover' => 'color: {{VALUE}};',
- ],
- ]
- );
- $this->add_control(
- 'button_background_hover_color',
- [
- 'label' => __( 'Background Color', 'elementor' ),
- 'type' => Controls_Manager::COLOR,
- 'selectors' => [
- '{{WRAPPER}} a.elementor-button:hover, {{WRAPPER}} .elementor-button:hover' => 'background-color: {{VALUE}};',
- ],
- ]
- );
- $this->add_control(
- 'button_hover_border_color',
- [
- 'label' => __( 'Border Color', 'elementor' ),
- 'type' => Controls_Manager::COLOR,
- 'condition' => [
- 'border_border!' => '',
- ],
- 'selectors' => [
- '{{WRAPPER}} a.elementor-button:hover, {{WRAPPER}} .elementor-button:hover' => 'border-color: {{VALUE}};',
- ],
- ]
- );
- $this->add_control(
- 'hover_animation',
- [
- 'label' => __( 'Hover Animation', 'elementor' ),
- 'type' => Controls_Manager::HOVER_ANIMATION,
- ]
- );
- $this->end_controls_tab();
- $this->end_controls_tabs();
- $this->add_group_control(
- Group_Control_Border::get_type(),
- [
- 'name' => 'border',
- 'placeholder' => '1px',
- 'default' => '1px',
- 'selector' => '{{WRAPPER}} .elementor-button',
- 'separator' => 'before',
- ]
- );
- $this->add_control(
- 'border_radius',
- [
- 'label' => __( 'Border Radius', 'elementor' ),
- 'type' => Controls_Manager::DIMENSIONS,
- 'size_units' => [ 'px', '%' ],
- 'selectors' => [
- '{{WRAPPER}} a.elementor-button, {{WRAPPER}} .elementor-button' => 'border-radius: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
- ],
- ]
- );
- $this->add_group_control(
- Group_Control_Box_Shadow::get_type(),
- [
- 'name' => 'button_box_shadow',
- 'selector' => '{{WRAPPER}} .elementor-button',
- ]
- );
- $this->add_responsive_control(
- 'text_padding',
- [
- 'label' => __( 'Padding', 'elementor' ),
- 'type' => Controls_Manager::DIMENSIONS,
- 'size_units' => [ 'px', 'em', '%' ],
- 'selectors' => [
- '{{WRAPPER}} a.elementor-button, {{WRAPPER}} .elementor-button' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
- ],
- 'separator' => 'before',
- ]
- );
- $this->end_controls_section();
- }
- /**
- * Render button widget output on the frontend.
- *
- * Written in PHP and used to generate the final HTML.
- *
- * @since 1.0.0
- * @access protected
- */
- protected function render() {
- $settings = $this->get_settings_for_display();
- $this->add_render_attribute( 'wrapper', 'class', 'elementor-button-wrapper' );
- if ( ! empty( $settings['link']['url'] ) ) {
- $this->add_render_attribute( 'button', 'href', $settings['link']['url'] );
- $this->add_render_attribute( 'button', 'class', 'elementor-button-link' );
- if ( $settings['link']['is_external'] ) {
- $this->add_render_attribute( 'button', 'target', '_blank' );
- }
- if ( $settings['link']['nofollow'] ) {
- $this->add_render_attribute( 'button', 'rel', 'nofollow' );
- }
- }
- $this->add_render_attribute( 'button', 'class', 'elementor-button' );
- $this->add_render_attribute( 'button', 'role', 'button' );
- if ( ! empty( $settings['button_css_id'] ) ) {
- $this->add_render_attribute( 'button', 'id', $settings['button_css_id'] );
- }
- if ( ! empty( $settings['size'] ) ) {
- $this->add_render_attribute( 'button', 'class', 'elementor-size-' . $settings['size'] );
- }
- if ( $settings['hover_animation'] ) {
- $this->add_render_attribute( 'button', 'class', 'elementor-animation-' . $settings['hover_animation'] );
- }
- ?>
- <div <?php echo $this->get_render_attribute_string( 'wrapper' ); ?>>
- <a <?php echo $this->get_render_attribute_string( 'button' ); ?>>
- <?php $this->render_text(); ?>
- </a>
- </div>
- <?php
- }
- /**
- * Render button widget output in the editor.
- *
- * Written as a Backbone JavaScript template and used to generate the live preview.
- *
- * @since 1.0.0
- * @access protected
- */
- protected function _content_template() {
- ?>
- <#
- view.addRenderAttribute( 'text', 'class', 'elementor-button-text' );
- view.addInlineEditingAttributes( 'text', 'none' );
- #>
- <div class="elementor-button-wrapper">
- <a id="{{ settings.button_css_id }}" class="elementor-button elementor-size-{{ settings.size }} elementor-animation-{{ settings.hover_animation }}" href="{{ settings.link.url }}" role="button">
- <span class="elementor-button-content-wrapper">
- <# if ( settings.icon ) { #>
- <span class="elementor-button-icon elementor-align-icon-{{ settings.icon_align }}">
- <i class="{{ settings.icon }}" aria-hidden="true"></i>
- </span>
- <# } #>
- <span {{{ view.getRenderAttributeString( 'text' ) }}}>{{{ settings.text }}}</span>
- </span>
- </a>
- </div>
- <?php
- }
- /**
- * Render button text.
- *
- * Render button widget text.
- *
- * @since 1.5.0
- * @access protected
- */
- protected function render_text() {
- $settings = $this->get_settings_for_display();
- $this->add_render_attribute( [
- 'content-wrapper' => [
- 'class' => 'elementor-button-content-wrapper',
- ],
- 'icon-align' => [
- 'class' => [
- 'elementor-button-icon',
- 'elementor-align-icon-' . $settings['icon_align'],
- ],
- ],
- 'text' => [
- 'class' => 'elementor-button-text',
- ],
- ] );
- $this->add_inline_editing_attributes( 'text', 'none' );
- ?>
- <span <?php echo $this->get_render_attribute_string( 'content-wrapper' ); ?>>
- <?php if ( ! empty( $settings['icon'] ) ) : ?>
- <span <?php echo $this->get_render_attribute_string( 'icon-align' ); ?>>
- <i class="<?php echo esc_attr( $settings['icon'] ); ?>" aria-hidden="true"></i>
- </span>
- <?php endif; ?>
- <span <?php echo $this->get_render_attribute_string( 'text' ); ?>><?php echo $settings['text']; ?></span>
- </span>
- <?php
- }
- }
|