| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659 |
- <?php
- namespace Elementor;
- if ( ! defined( 'ABSPATH' ) ) {
- exit; // Exit if accessed directly.
- }
- /**
- * Elementor image box widget.
- *
- * Elementor widget that displays an image, a headline and a text.
- *
- * @since 1.0.0
- */
- class Widget_Image_Box extends Widget_Base {
- /**
- * Get widget name.
- *
- * Retrieve image box widget name.
- *
- * @since 1.0.0
- * @access public
- *
- * @return string Widget name.
- */
- public function get_name() {
- return 'image-box';
- }
- /**
- * Get widget title.
- *
- * Retrieve image box widget title.
- *
- * @since 1.0.0
- * @access public
- *
- * @return string Widget title.
- */
- public function get_title() {
- return __( 'Image Box', 'elementor' );
- }
- /**
- * Get widget icon.
- *
- * Retrieve image box widget icon.
- *
- * @since 1.0.0
- * @access public
- *
- * @return string Widget icon.
- */
- public function get_icon() {
- return 'eicon-image-box';
- }
- /**
- * 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 [ 'image', 'photo', 'visual', 'box' ];
- }
- /**
- * Register image box 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_image',
- [
- 'label' => __( 'Image Box', 'elementor' ),
- ]
- );
- $this->add_control(
- 'image',
- [
- 'label' => __( 'Choose Image', 'elementor' ),
- 'type' => Controls_Manager::MEDIA,
- 'dynamic' => [
- 'active' => true,
- ],
- 'default' => [
- 'url' => Utils::get_placeholder_image_src(),
- ],
- ]
- );
- $this->add_group_control(
- Group_Control_Image_Size::get_type(),
- [
- 'name' => 'thumbnail', // Usage: `{name}_size` and `{name}_custom_dimension`, in this case `thumbnail_size` and `thumbnail_custom_dimension`.
- 'default' => 'full',
- 'separator' => 'none',
- ]
- );
- $this->add_control(
- 'title_text',
- [
- 'label' => __( 'Title & Description', 'elementor' ),
- 'type' => Controls_Manager::TEXT,
- 'dynamic' => [
- 'active' => true,
- ],
- 'default' => __( 'This is the heading', 'elementor' ),
- 'placeholder' => __( 'Enter your title', 'elementor' ),
- 'label_block' => true,
- ]
- );
- $this->add_control(
- 'description_text',
- [
- 'label' => __( 'Content', 'elementor' ),
- 'type' => Controls_Manager::TEXTAREA,
- 'dynamic' => [
- 'active' => true,
- ],
- 'default' => __( 'Click edit button to change this text. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit tellus, luctus nec ullamcorper mattis, pulvinar dapibus leo.', 'elementor' ),
- 'placeholder' => __( 'Enter your description', 'elementor' ),
- 'separator' => 'none',
- 'rows' => 10,
- 'show_label' => false,
- ]
- );
- $this->add_control(
- 'link',
- [
- 'label' => __( 'Link to', 'elementor' ),
- 'type' => Controls_Manager::URL,
- 'dynamic' => [
- 'active' => true,
- ],
- 'placeholder' => __( 'https://your-link.com', 'elementor' ),
- 'separator' => 'before',
- ]
- );
- $this->add_control(
- 'position',
- [
- 'label' => __( 'Image Position', 'elementor' ),
- 'type' => Controls_Manager::CHOOSE,
- 'default' => 'top',
- 'options' => [
- 'left' => [
- 'title' => __( 'Left', 'elementor' ),
- 'icon' => 'fa fa-align-left',
- ],
- 'top' => [
- 'title' => __( 'Top', 'elementor' ),
- 'icon' => 'fa fa-align-center',
- ],
- 'right' => [
- 'title' => __( 'Right', 'elementor' ),
- 'icon' => 'fa fa-align-right',
- ],
- ],
- 'prefix_class' => 'elementor-position-',
- 'toggle' => false,
- ]
- );
- $this->add_control(
- 'title_size',
- [
- 'label' => __( 'Title HTML Tag', 'elementor' ),
- 'type' => Controls_Manager::SELECT,
- 'options' => [
- 'h1' => 'H1',
- 'h2' => 'H2',
- 'h3' => 'H3',
- 'h4' => 'H4',
- 'h5' => 'H5',
- 'h6' => 'H6',
- 'div' => 'div',
- 'span' => 'span',
- 'p' => 'p',
- ],
- 'default' => 'h3',
- ]
- );
- $this->add_control(
- 'view',
- [
- 'label' => __( 'View', 'elementor' ),
- 'type' => Controls_Manager::HIDDEN,
- 'default' => 'traditional',
- ]
- );
- $this->end_controls_section();
- $this->start_controls_section(
- 'section_style_image',
- [
- 'label' => __( 'Image', 'elementor' ),
- 'tab' => Controls_Manager::TAB_STYLE,
- ]
- );
- $this->add_responsive_control(
- 'image_space',
- [
- 'label' => __( 'Spacing', 'elementor' ),
- 'type' => Controls_Manager::SLIDER,
- 'default' => [
- 'size' => 15,
- ],
- 'range' => [
- 'px' => [
- 'min' => 0,
- 'max' => 100,
- ],
- ],
- 'selectors' => [
- '{{WRAPPER}}.elementor-position-right .elementor-image-box-img' => 'margin-left: {{SIZE}}{{UNIT}};',
- '{{WRAPPER}}.elementor-position-left .elementor-image-box-img' => 'margin-right: {{SIZE}}{{UNIT}};',
- '{{WRAPPER}}.elementor-position-top .elementor-image-box-img' => 'margin-bottom: {{SIZE}}{{UNIT}};',
- '(mobile){{WRAPPER}} .elementor-image-box-img' => 'margin-bottom: {{SIZE}}{{UNIT}};',
- ],
- ]
- );
- $this->add_responsive_control(
- 'image_size',
- [
- 'label' => __( 'Width', 'elementor' ),
- 'type' => Controls_Manager::SLIDER,
- 'default' => [
- 'size' => 30,
- 'unit' => '%',
- ],
- 'tablet_default' => [
- 'unit' => '%',
- ],
- 'mobile_default' => [
- 'unit' => '%',
- ],
- 'size_units' => [ '%' ],
- 'range' => [
- '%' => [
- 'min' => 5,
- 'max' => 100,
- ],
- ],
- 'selectors' => [
- '{{WRAPPER}} .elementor-image-box-wrapper .elementor-image-box-img' => 'width: {{SIZE}}{{UNIT}};',
- ],
- ]
- );
- $this->add_control(
- 'hover_animation',
- [
- 'label' => __( 'Hover Animation', 'elementor' ),
- 'type' => Controls_Manager::HOVER_ANIMATION,
- ]
- );
- $this->start_controls_tabs( 'image_effects' );
- $this->start_controls_tab( 'normal',
- [
- 'label' => __( 'Normal', 'elementor' ),
- ]
- );
- $this->add_group_control(
- Group_Control_Css_Filter::get_type(),
- [
- 'name' => 'css_filters',
- 'selector' => '{{WRAPPER}} .elementor-image-box-img img',
- ]
- );
- $this->add_control(
- 'image_opacity',
- [
- 'label' => __( 'Opacity', 'elementor' ),
- 'type' => Controls_Manager::SLIDER,
- 'range' => [
- 'px' => [
- 'max' => 1,
- 'min' => 0.10,
- 'step' => 0.01,
- ],
- ],
- 'selectors' => [
- '{{WRAPPER}} .elementor-image-box-img img' => 'opacity: {{SIZE}};',
- ],
- ]
- );
- $this->add_control(
- 'background_hover_transition',
- [
- 'label' => __( 'Transition Duration', 'elementor' ),
- 'type' => Controls_Manager::SLIDER,
- 'default' => [
- 'size' => 0.3,
- ],
- 'range' => [
- 'px' => [
- 'max' => 3,
- 'step' => 0.1,
- ],
- ],
- 'selectors' => [
- '{{WRAPPER}} .elementor-image-box-img img' => 'transition-duration: {{SIZE}}s',
- ],
- ]
- );
- $this->end_controls_tab();
- $this->start_controls_tab( 'hover',
- [
- 'label' => __( 'Hover', 'elementor' ),
- ]
- );
- $this->add_group_control(
- Group_Control_Css_Filter::get_type(),
- [
- 'name' => 'css_filters_hover',
- 'selector' => '{{WRAPPER}}:hover .elementor-image-box-img img',
- ]
- );
- $this->add_control(
- 'image_opacity_hover',
- [
- 'label' => __( 'Opacity', 'elementor' ),
- 'type' => Controls_Manager::SLIDER,
- 'range' => [
- 'px' => [
- 'max' => 1,
- 'min' => 0.10,
- 'step' => 0.01,
- ],
- ],
- 'selectors' => [
- '{{WRAPPER}}:hover .elementor-image-box-img img' => 'opacity: {{SIZE}};',
- ],
- ]
- );
- $this->end_controls_tab();
- $this->end_controls_tabs();
- $this->end_controls_section();
- $this->start_controls_section(
- 'section_style_content',
- [
- 'label' => __( 'Content', 'elementor' ),
- 'tab' => Controls_Manager::TAB_STYLE,
- ]
- );
- $this->add_responsive_control(
- 'text_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',
- ],
- ],
- 'selectors' => [
- '{{WRAPPER}} .elementor-image-box-wrapper' => 'text-align: {{VALUE}};',
- ],
- ]
- );
- $this->add_control(
- 'content_vertical_alignment',
- [
- 'label' => __( 'Vertical Alignment', 'elementor' ),
- 'type' => Controls_Manager::SELECT,
- 'options' => [
- 'top' => __( 'Top', 'elementor' ),
- 'middle' => __( 'Middle', 'elementor' ),
- 'bottom' => __( 'Bottom', 'elementor' ),
- ],
- 'default' => 'top',
- 'prefix_class' => 'elementor-vertical-align-',
- ]
- );
- $this->add_control(
- 'heading_title',
- [
- 'label' => __( 'Title', 'elementor' ),
- 'type' => Controls_Manager::HEADING,
- 'separator' => 'before',
- ]
- );
- $this->add_responsive_control(
- 'title_bottom_space',
- [
- 'label' => __( 'Spacing', 'elementor' ),
- 'type' => Controls_Manager::SLIDER,
- 'range' => [
- 'px' => [
- 'min' => 0,
- 'max' => 100,
- ],
- ],
- 'selectors' => [
- '{{WRAPPER}} .elementor-image-box-title' => 'margin-bottom: {{SIZE}}{{UNIT}};',
- ],
- ]
- );
- $this->add_control(
- 'title_color',
- [
- 'label' => __( 'Color', 'elementor' ),
- 'type' => Controls_Manager::COLOR,
- 'default' => '',
- 'selectors' => [
- '{{WRAPPER}} .elementor-image-box-content .elementor-image-box-title' => 'color: {{VALUE}};',
- ],
- 'scheme' => [
- 'type' => Scheme_Color::get_type(),
- 'value' => Scheme_Color::COLOR_1,
- ],
- ]
- );
- $this->add_group_control(
- Group_Control_Typography::get_type(),
- [
- 'name' => 'title_typography',
- 'selector' => '{{WRAPPER}} .elementor-image-box-content .elementor-image-box-title',
- 'scheme' => Scheme_Typography::TYPOGRAPHY_1,
- ]
- );
- $this->add_control(
- 'heading_description',
- [
- 'label' => __( 'Description', 'elementor' ),
- 'type' => Controls_Manager::HEADING,
- 'separator' => 'before',
- ]
- );
- $this->add_control(
- 'description_color',
- [
- 'label' => __( 'Color', 'elementor' ),
- 'type' => Controls_Manager::COLOR,
- 'default' => '',
- 'selectors' => [
- '{{WRAPPER}} .elementor-image-box-content .elementor-image-box-description' => 'color: {{VALUE}};',
- ],
- 'scheme' => [
- 'type' => Scheme_Color::get_type(),
- 'value' => Scheme_Color::COLOR_3,
- ],
- ]
- );
- $this->add_group_control(
- Group_Control_Typography::get_type(),
- [
- 'name' => 'description_typography',
- 'selector' => '{{WRAPPER}} .elementor-image-box-content .elementor-image-box-description',
- 'scheme' => Scheme_Typography::TYPOGRAPHY_3,
- ]
- );
- $this->end_controls_section();
- }
- /**
- * Render image box 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();
- $has_content = ! empty( $settings['title_text'] ) || ! empty( $settings['description_text'] );
- $html = '<div class="elementor-image-box-wrapper">';
- if ( ! empty( $settings['link']['url'] ) ) {
- $this->add_render_attribute( 'link', 'href', $settings['link']['url'] );
- if ( $settings['link']['is_external'] ) {
- $this->add_render_attribute( 'link', 'target', '_blank' );
- }
- if ( ! empty( $settings['link']['nofollow'] ) ) {
- $this->add_render_attribute( 'link', 'rel', 'nofollow' );
- }
- }
- if ( ! empty( $settings['image']['url'] ) ) {
- $this->add_render_attribute( 'image', 'src', $settings['image']['url'] );
- $this->add_render_attribute( 'image', 'alt', Control_Media::get_image_alt( $settings['image'] ) );
- $this->add_render_attribute( 'image', 'title', Control_Media::get_image_title( $settings['image'] ) );
- if ( $settings['hover_animation'] ) {
- $this->add_render_attribute( 'image', 'class', 'elementor-animation-' . $settings['hover_animation'] );
- }
- $image_html = Group_Control_Image_Size::get_attachment_image_html( $settings, 'thumbnail', 'image' );
- if ( ! empty( $settings['link']['url'] ) ) {
- $image_html = '<a ' . $this->get_render_attribute_string( 'link' ) . '>' . $image_html . '</a>';
- }
- $html .= '<figure class="elementor-image-box-img">' . $image_html . '</figure>';
- }
- if ( $has_content ) {
- $html .= '<div class="elementor-image-box-content">';
- if ( ! empty( $settings['title_text'] ) ) {
- $this->add_render_attribute( 'title_text', 'class', 'elementor-image-box-title' );
- $this->add_inline_editing_attributes( 'title_text', 'none' );
- $title_html = $settings['title_text'];
- if ( ! empty( $settings['link']['url'] ) ) {
- $title_html = '<a ' . $this->get_render_attribute_string( 'link' ) . '>' . $title_html . '</a>';
- }
- $html .= sprintf( '<%1$s %2$s>%3$s</%1$s>', $settings['title_size'], $this->get_render_attribute_string( 'title_text' ), $title_html );
- }
- if ( ! empty( $settings['description_text'] ) ) {
- $this->add_render_attribute( 'description_text', 'class', 'elementor-image-box-description' );
- $this->add_inline_editing_attributes( 'description_text' );
- $html .= sprintf( '<p %1$s>%2$s</p>', $this->get_render_attribute_string( 'description_text' ), $settings['description_text'] );
- }
- $html .= '</div>';
- }
- $html .= '</div>';
- echo $html;
- }
- /**
- * Render image box 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() {
- ?>
- <#
- var html = '<div class="elementor-image-box-wrapper">';
- if ( settings.image.url ) {
- var image = {
- id: settings.image.id,
- url: settings.image.url,
- size: settings.thumbnail_size,
- dimension: settings.thumbnail_custom_dimension,
- model: view.getEditModel()
- };
- var image_url = elementor.imagesManager.getImageUrl( image );
- var imageHtml = '<img src="' + image_url + '" class="elementor-animation-' + settings.hover_animation + '" />';
- if ( settings.link.url ) {
- imageHtml = '<a href="' + settings.link.url + '">' + imageHtml + '</a>';
- }
- html += '<figure class="elementor-image-box-img">' + imageHtml + '</figure>';
- }
- var hasContent = !! ( settings.title_text || settings.description_text );
- if ( hasContent ) {
- html += '<div class="elementor-image-box-content">';
- if ( settings.title_text ) {
- var title_html = settings.title_text;
- if ( settings.link.url ) {
- title_html = '<a href="' + settings.link.url + '">' + title_html + '</a>';
- }
- view.addRenderAttribute( 'title_text', 'class', 'elementor-image-box-title' );
- view.addInlineEditingAttributes( 'title_text', 'none' );
- html += '<' + settings.title_size + ' ' + view.getRenderAttributeString( 'title_text' ) + '>' + title_html + '</' + settings.title_size + '>';
- }
- if ( settings.description_text ) {
- view.addRenderAttribute( 'description_text', 'class', 'elementor-image-box-description' );
- view.addInlineEditingAttributes( 'description_text' );
- html += '<p ' + view.getRenderAttributeString( 'description_text' ) + '>' + settings.description_text + '</p>';
- }
- html += '</div>';
- }
- html += '</div>';
- print( html );
- #>
- <?php
- }
- }
|