name = esc_html__( 'Image', 'et_builder' ); $this->slug = 'et_pb_image'; $this->fb_support = true; $this->whitelisted_fields = array( 'src', 'alt', 'title_text', 'show_in_lightbox', 'url', 'url_new_window', 'show_bottom_space', 'align', 'admin_label', 'module_id', 'module_class', 'force_fullwidth', 'always_center_on_mobile', 'use_overlay', 'overlay_icon_color', 'hover_overlay_color', 'hover_icon', ); $this->fields_defaults = array( 'show_in_lightbox' => array( 'off' ), 'url_new_window' => array( 'off' ), 'show_bottom_space' => array( 'on' ), 'align' => array( 'left' ), 'force_fullwidth' => array( 'off' ), 'always_center_on_mobile' => array( 'on' ), 'use_overlay' => array( 'off' ), ); $this->options_toggles = array( 'general' => array( 'toggles' => array( 'main_content' => esc_html__( 'Image', 'et_builder' ), 'link' => esc_html__( 'Link', 'et_builder' ), ), ), 'advanced' => array( 'toggles' => array( 'overlay' => esc_html__( 'Overlay', 'et_builder' ), 'alignment' => esc_html__( 'Alignment', 'et_builder' ), 'width' => array( 'title' => esc_html__( 'Sizing', 'et_builder' ), 'priority' => 65, ), ), ), 'custom_css' => array( 'toggles' => array( 'animation' => array( 'title' => esc_html__( 'Animation', 'et_builder' ), 'priority' => 90, ), 'attributes' => array( 'title' => esc_html__( 'Attributes', 'et_builder' ), 'priority' => 95, ), ), ), ); $this->advanced_options = array( 'custom_margin_padding' => array( 'css' => array( 'important' => array( 'custom_margin' ), ), ), 'background' => array(), 'max_width' => array( 'options' => array( 'max_width' => array( 'depends_show_if' => 'off', ), ), ), 'filters' => array(), ); } function get_fields() { $fields = array( 'src' => array( 'label' => esc_html__( 'Image URL', 'et_builder' ), 'type' => 'upload', 'option_category' => 'basic_option', 'upload_button_text' => esc_attr__( 'Upload an image', 'et_builder' ), 'choose_text' => esc_attr__( 'Choose an Image', 'et_builder' ), 'update_text' => esc_attr__( 'Set As Image', 'et_builder' ), 'affects' => array( 'alt', 'title_text', ), 'description' => esc_html__( 'Upload your desired image, or type in the URL to the image you would like to display.', 'et_builder' ), 'toggle_slug' => 'main_content', ), 'alt' => array( 'label' => esc_html__( 'Image Alternative Text', 'et_builder' ), 'type' => 'text', 'option_category' => 'basic_option', 'depends_default' => true, 'depends_to' => array( 'src', ), 'description' => esc_html__( 'This defines the HTML ALT text. A short description of your image can be placed here.', 'et_builder' ), 'tab_slug' => 'custom_css', 'toggle_slug' => 'attributes', ), 'title_text' => array( 'label' => esc_html__( 'Image Title Text', 'et_builder' ), 'type' => 'text', 'option_category' => 'basic_option', 'depends_default' => true, 'depends_to' => array( 'src', ), 'description' => esc_html__( 'This defines the HTML Title text.', 'et_builder' ), 'tab_slug' => 'custom_css', 'toggle_slug' => 'attributes', ), 'show_in_lightbox' => array( 'label' => esc_html__( 'Open in Lightbox', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'No', 'et_builder' ), 'on' => esc_html__( 'Yes', 'et_builder' ), ), 'affects' => array( 'url', 'url_new_window', 'use_overlay', ), 'toggle_slug' => 'link', 'description' => esc_html__( 'Here you can choose whether or not the image should open in Lightbox. Note: if you select to open the image in Lightbox, url options below will be ignored.', 'et_builder' ), ), 'url' => array( 'label' => esc_html__( 'Link URL', 'et_builder' ), 'type' => 'text', 'option_category' => 'basic_option', 'depends_show_if' => 'off', 'affects' => array( 'use_overlay', ), 'description' => esc_html__( 'If you would like your image to be a link, input your destination URL here. No link will be created if this field is left blank.', 'et_builder' ), 'toggle_slug' => 'link', ), 'url_new_window' => array( 'label' => esc_html__( 'Url Opens', 'et_builder' ), 'type' => 'select', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'In The Same Window', 'et_builder' ), 'on' => esc_html__( 'In The New Tab', 'et_builder' ), ), 'depends_show_if' => 'off', 'toggle_slug' => 'link', 'description' => esc_html__( 'Here you can choose whether or not your link opens in a new window', 'et_builder' ), ), 'use_overlay' => array( 'label' => esc_html__( 'Image Overlay', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'layout', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'affects' => array( 'overlay_icon_color', 'hover_overlay_color', 'hover_icon', ), 'depends_default' => true, 'tab_slug' => 'advanced', 'toggle_slug' => 'overlay', 'description' => esc_html__( 'If enabled, an overlay color and icon will be displayed when a visitors hovers over the image', 'et_builder' ), ), 'overlay_icon_color' => array( 'label' => esc_html__( 'Overlay Icon Color', 'et_builder' ), 'type' => 'color-alpha', 'custom_color' => true, 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'overlay', 'description' => esc_html__( 'Here you can define a custom color for the overlay icon', 'et_builder' ), ), 'hover_overlay_color' => array( 'label' => esc_html__( 'Hover Overlay Color', 'et_builder' ), 'type' => 'color-alpha', 'custom_color' => true, 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'overlay', 'description' => esc_html__( 'Here you can define a custom color for the overlay', 'et_builder' ), ), 'hover_icon' => array( 'label' => esc_html__( 'Hover Icon Picker', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'class' => array( 'et-pb-font-icon' ), 'renderer' => 'et_pb_get_font_icon_list', 'renderer_with_field' => true, 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'overlay', 'description' => esc_html__( 'Here you can define a custom icon for the overlay', 'et_builder' ), ), 'show_bottom_space' => array( 'label' => esc_html__( 'Show Space Below The Image', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'layout', 'options' => array( 'on' => esc_html__( 'Yes', 'et_builder' ), 'off' => esc_html__( 'No', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'custom_margin_padding', 'description' => esc_html__( 'Here you can choose whether or not the image should have a space below it.', 'et_builder' ), ), 'align' => array( 'label' => esc_html__( 'Image Alignment', 'et_builder' ), 'type' => 'text_align', 'option_category' => 'layout', 'options' => et_builder_get_text_orientation_options( array( 'justified' ) ), 'tab_slug' => 'advanced', 'toggle_slug' => 'alignment', 'description' => esc_html__( 'Here you can choose the image alignment.', 'et_builder' ), 'options_icon' => 'module_align', ), 'force_fullwidth' => array( 'label' => esc_html__( 'Force Fullwidth', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'layout', 'options' => array( 'off' => esc_html__( 'No', 'et_builder' ), 'on' => esc_html__( 'Yes', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'width', 'affects' => array( 'max_width', ), ), 'always_center_on_mobile' => array( 'label' => esc_html__( 'Always Center Image On Mobile', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'layout', 'options' => array( 'on' => esc_html__( 'Yes', 'et_builder' ), 'off' => esc_html__( 'No', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'alignment', ), 'disabled_on' => array( 'label' => esc_html__( 'Disable on', 'et_builder' ), 'type' => 'multiple_checkboxes', 'options' => array( 'phone' => esc_html__( 'Phone', 'et_builder' ), 'tablet' => esc_html__( 'Tablet', 'et_builder' ), 'desktop' => esc_html__( 'Desktop', 'et_builder' ), ), 'additional_att' => 'disable_on', 'option_category' => 'configuration', 'description' => esc_html__( 'This will disable the module on selected devices', 'et_builder' ), 'tab_slug' => 'custom_css', 'toggle_slug' => 'visibility', ), 'admin_label' => array( 'label' => esc_html__( 'Admin Label', 'et_builder' ), 'type' => 'text', 'description' => esc_html__( 'This will change the label of the module in the builder for easy identification.', 'et_builder' ), 'toggle_slug' => 'admin_label', ), 'module_id' => array( 'label' => esc_html__( 'CSS ID', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'tab_slug' => 'custom_css', 'toggle_slug' => 'classes', 'option_class' => 'et_pb_custom_css_regular', ), 'module_class' => array( 'label' => esc_html__( 'CSS Class', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'tab_slug' => 'custom_css', 'toggle_slug' => 'classes', 'option_class' => 'et_pb_custom_css_regular', ), ); return $fields; } public function get_alignment() { $alignment = isset( $this->shortcode_atts['align'] ) ? $this->shortcode_atts['align'] : ''; return et_pb_get_alignment( $alignment ); } function shortcode_callback( $atts, $content = null, $function_name ) { $module_id = $this->shortcode_atts['module_id']; $module_class = $this->shortcode_atts['module_class']; $src = $this->shortcode_atts['src']; $alt = $this->shortcode_atts['alt']; $title_text = $this->shortcode_atts['title_text']; $url = $this->shortcode_atts['url']; $url_new_window = $this->shortcode_atts['url_new_window']; $show_in_lightbox = $this->shortcode_atts['show_in_lightbox']; $show_bottom_space = $this->shortcode_atts['show_bottom_space']; $align = $this->get_alignment(); $force_fullwidth = $this->shortcode_atts['force_fullwidth']; $always_center_on_mobile = $this->shortcode_atts['always_center_on_mobile']; $overlay_icon_color = $this->shortcode_atts['overlay_icon_color']; $hover_overlay_color = $this->shortcode_atts['hover_overlay_color']; $hover_icon = $this->shortcode_atts['hover_icon']; $use_overlay = $this->shortcode_atts['use_overlay']; $animation_style = $this->shortcode_atts['animation_style']; $module_class = ET_Builder_Element::add_module_order_class( $module_class, $function_name ); $video_background = $this->video_background(); $parallax_image_background = $this->get_parallax_image_background(); // Handle svg image behaviour $src_pathinfo = pathinfo( $src ); $is_src_svg = isset( $src_pathinfo['extension'] ) ? 'svg' === $src_pathinfo['extension'] : false; if ( 'on' === $always_center_on_mobile ) { $module_class .= ' et_always_center_on_mobile'; } // overlay can be applied only if image has link or if lightbox enabled $is_overlay_applied = 'on' === $use_overlay && ( 'on' === $show_in_lightbox || ( 'off' === $show_in_lightbox && '' !== $url ) ) ? 'on' : 'off'; if ( 'on' === $force_fullwidth ) { ET_Builder_Element::set_style( $function_name, array( 'selector' => '%%order_class%%', 'declaration' => 'max-width: 100% !important;', ) ); ET_Builder_Element::set_style( $function_name, array( 'selector' => '%%order_class%% .et_pb_image_wrap, %%order_class%% img', 'declaration' => 'width: 100%;', ) ); } if ( $this->fields_defaults['align'][0] !== $align ) { ET_Builder_Element::set_style( $function_name, array( 'selector' => '%%order_class%%', 'declaration' => sprintf( 'text-align: %1$s;', esc_html( $align ) ), ) ); } if ( 'center' !== $align ) { ET_Builder_Element::set_style( $function_name, array( 'selector' => '%%order_class%%', 'declaration' => sprintf( 'margin-%1$s: 0;', esc_html( $align ) ), ) ); } if ( 'on' === $is_overlay_applied ) { if ( '' !== $overlay_icon_color ) { ET_Builder_Element::set_style( $function_name, array( 'selector' => '%%order_class%% .et_overlay:before', 'declaration' => sprintf( 'color: %1$s !important;', esc_html( $overlay_icon_color ) ), ) ); } if ( '' !== $hover_overlay_color ) { ET_Builder_Element::set_style( $function_name, array( 'selector' => '%%order_class%% .et_overlay', 'declaration' => sprintf( 'background-color: %1$s;', esc_html( $hover_overlay_color ) ), ) ); } $data_icon = '' !== $hover_icon ? sprintf( ' data-icon="%1$s"', esc_attr( et_pb_process_font_icon( $hover_icon ) ) ) : ''; $overlay_output = sprintf( '', ( '' !== $hover_icon ? ' et_pb_inline_icon' : '' ), $data_icon ); } // Set display block for svg image to avoid disappearing svg image if ( $is_src_svg ) { ET_Builder_Element::set_style( $function_name, array( 'selector' => '%%order_class%% .et_pb_image_wrap', 'declaration' => 'display: block;', ) ); } $output = sprintf( '%4$s', esc_url( $src ), esc_attr( $alt ), ( '' !== $title_text ? sprintf( ' title="%1$s"', esc_attr( $title_text ) ) : '' ), 'on' === $is_overlay_applied ? $overlay_output : '' ); if ( 'on' === $show_in_lightbox ) { $output = sprintf( '%2$s', esc_url( $src ), $output, esc_attr( $alt ) ); } else if ( '' !== $url ) { $output = sprintf( '%2$s', esc_url( $url ), $output, ( 'on' === $url_new_window ? ' target="_blank"' : '' ) ); } $output = sprintf( '