name = esc_html__( 'Post Title', 'et_builder' ); $this->plural = esc_html__( 'Post Titles', 'et_builder' ); $this->slug = 'et_pb_post_title'; $this->vb_support = 'on'; $this->defaults = array(); $this->featured_image_background = true; $this->main_css_element = '%%order_class%%'; $this->settings_modal_toggles = array( 'general' => array( 'toggles' => array( 'elements' => et_builder_i18n( 'Elements' ), ), ), 'advanced' => array( 'toggles' => array( 'text' => array( 'title' => et_builder_i18n( 'Text' ), 'priority' => 49, ), 'image_settings' => et_builder_i18n( 'Image' ), ), ), ); $this->advanced_fields = array( 'borders' => array( 'default' => array( 'css' => array( 'main' => array( 'border_radii' => "{$this->main_css_element}.et_pb_featured_bg, {$this->main_css_element}", 'border_styles' => "{$this->main_css_element}.et_pb_featured_bg, {$this->main_css_element}", ), ), ), ), 'margin_padding' => array( 'css' => array( 'main' => ".et_pb_section {$this->main_css_element}.et_pb_post_title", 'margin' => ".et_pb_section {$this->main_css_element}.et_pb_post_title", 'important' => 'all', ), ), 'fonts' => array( 'title' => array( 'label' => et_builder_i18n( 'Title' ), 'use_all_caps' => true, 'css' => array( 'main' => "{$this->main_css_element} .et_pb_title_container h1.entry-title, {$this->main_css_element} .et_pb_title_container h2.entry-title, {$this->main_css_element} .et_pb_title_container h3.entry-title, {$this->main_css_element} .et_pb_title_container h4.entry-title, {$this->main_css_element} .et_pb_title_container h5.entry-title, {$this->main_css_element} .et_pb_title_container h6.entry-title", ), 'header_level' => array( 'default' => 'h1', ), ), 'meta' => array( 'label' => esc_html__( 'Meta', 'et_builder' ), 'css' => array( 'main' => "{$this->main_css_element} .et_pb_title_container .et_pb_title_meta_container, {$this->main_css_element} .et_pb_title_container .et_pb_title_meta_container a", 'limited_main' => "{$this->main_css_element} .et_pb_title_container .et_pb_title_meta_container, {$this->main_css_element} .et_pb_title_container .et_pb_title_meta_container a, {$this->main_css_element} .et_pb_title_container .et_pb_title_meta_container span", ), ), ), 'background' => array( 'css' => array( 'main' => "{$this->main_css_element}, {$this->main_css_element}.et_pb_featured_bg", ), ), 'max_width' => array( 'css' => array( 'module_alignment' => '.et_pb_section %%order_class%%.et_pb_post_title.et_pb_module', ), ), 'text' => array( 'options' => array( 'text_orientation' => array( 'default' => 'left', ), ), 'css' => array( 'main' => implode( ', ', array( '%%order_class%% .entry-title', '%%order_class%% .et_pb_title_meta_container', ) ), ), ), 'button' => false, ); $this->custom_css_fields = array( 'post_title' => array( 'label' => et_builder_i18n( 'Title' ), 'selector' => 'h1', ), 'post_meta' => array( 'label' => esc_html__( 'Meta', 'et_builder' ), 'selector' => '.et_pb_title_meta_container', ), 'post_image' => array( 'label' => esc_html__( 'Featured Image', 'et_builder' ), 'selector' => '.et_pb_title_featured_container', ), ); $this->help_videos = array( array( 'id' => 'wb8c06U0uCU', 'name' => esc_html__( 'An introduction to the Post Title module', 'et_builder' ), ), ); } function get_fields() { $fields = array( 'title' => array( 'label' => esc_html__( 'Show Title', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'on' => et_builder_i18n( 'Yes' ), 'off' => et_builder_i18n( 'No' ), ), 'default_on_front' => 'on', 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can choose whether or not display the Post Title', 'et_builder' ), 'mobile_options' => true, 'hover' => 'tabs', ), 'meta' => array( 'label' => esc_html__( 'Show Meta', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'on' => et_builder_i18n( 'Yes' ), 'off' => et_builder_i18n( 'No' ), ), 'default_on_front' => 'on', 'affects' => array( 'author', 'date', 'comments', ), 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can choose whether or not display the Post Meta', 'et_builder' ), 'mobile_options' => true, 'hover' => 'tabs', ), 'author' => array( 'label' => esc_html__( 'Show Author', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'on' => et_builder_i18n( 'Yes' ), 'off' => et_builder_i18n( 'No' ), ), 'default_on_front' => 'on', 'depends_show_if' => 'on', 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can choose whether or not display the Author Name in Post Meta', 'et_builder' ), 'mobile_options' => true, 'hover' => 'tabs', ), 'date' => array( 'label' => esc_html__( 'Show Date', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'on' => et_builder_i18n( 'Yes' ), 'off' => et_builder_i18n( 'No' ), ), 'default_on_front' => 'on', 'depends_show_if' => 'on', 'affects' => array( 'date_format', ), 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can choose whether or not display the Date in Post Meta', 'et_builder' ), 'mobile_options' => true, 'hover' => 'tabs', ), 'date_format' => array( 'label' => esc_html__( 'Date Format', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'default_on_front' => 'M j, Y', 'depends_show_if' => 'on', 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can define the Date Format in Post Meta. Default is \'M j, Y\'', 'et_builder' ), ), 'categories' => array( 'label' => esc_html__( 'Show Post Categories', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'on' => et_builder_i18n( 'Yes' ), 'off' => et_builder_i18n( 'No' ), ), 'default_on_front' => 'on', 'show_if' => array( 'meta' => 'on', 'function.isPostOrTBLayout' => 'on', ), 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can choose whether or not display the Categories in Post Meta. Note: This option doesn\'t work with custom post types.', 'et_builder' ), 'mobile_options' => true, 'hover' => 'tabs', ), 'comments' => array( 'label' => esc_html__( 'Show Comments Count', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'on' => et_builder_i18n( 'Yes' ), 'off' => et_builder_i18n( 'No' ), ), 'default_on_front' => 'on', 'depends_show_if' => 'on', 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can choose whether or not display the Comments Count in Post Meta.', 'et_builder' ), 'mobile_options' => true, 'hover' => 'tabs', ), 'featured_image' => array( 'label' => esc_html__( 'Show Featured Image', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'on' => et_builder_i18n( 'Yes' ), 'off' => et_builder_i18n( 'No' ), ), 'default_on_front' => 'on', 'affects' => array( 'featured_placement', ), 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can choose whether or not display the Featured Image', 'et_builder' ), 'mobile_options' => true, 'hover' => 'tabs', ), 'featured_placement' => array( 'label' => esc_html__( 'Featured Image Placement', 'et_builder' ), 'type' => 'select', 'option_category' => 'configuration', 'options' => array( 'below' => esc_html__( 'Below Title', 'et_builder' ), 'above' => esc_html__( 'Above Title', 'et_builder' ), 'background' => esc_html__( 'Title/Meta Background Image', 'et_builder' ), ), 'default_on_front' => 'below', 'depends_show_if' => 'on', 'toggle_slug' => 'elements', 'description' => esc_html__( 'Here you can choose where to place the Featured Image', 'et_builder' ), ), 'force_fullwidth' => array( 'label' => esc_html__( 'Force Fullwidth', 'et_builder' ), 'description' => esc_html__( "When enabled, this will force your image to extend 100% of the width of the column it's in.", 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'layout', 'options' => array( 'off' => et_builder_i18n( 'No' ), 'on' => et_builder_i18n( 'Yes' ), ), 'default' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'width', 'show_if' => array( 'featured_image' => 'on', 'featured_placement' => array( 'below', 'above' ), ), ), 'image_width' => array( 'label' => esc_html__( 'Featured Image Width', 'et_builder' ), 'description' => esc_html__( 'Adjust the width of the featured image.', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'tab_slug' => 'advanced', 'toggle_slug' => 'width', 'allowed_values' => et_builder_get_acceptable_css_string_values( 'width' ), 'default' => '100%', 'default_unit' => '%', 'range_settings' => array( 'min' => '0', 'max' => '100', 'step' => '1', ), 'responsive' => true, 'show_if' => array( 'featured_image' => 'on', 'featured_placement' => array( 'below', 'above' ), 'force_fullwidth' => 'off', ), 'sticky' => true, ), 'image_max_width' => array( 'label' => esc_html__( 'Featured Image Max Width', 'et_builder' ), 'description' => esc_html__( 'Adjust the max width of the featured image.', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'tab_slug' => 'advanced', 'toggle_slug' => 'width', 'allowed_values' => et_builder_get_acceptable_css_string_values( 'max-width' ), 'default' => 'none', 'default_unit' => '%', 'range_settings' => array( 'min' => '0', 'max' => '100', 'step' => '1', ), 'responsive' => true, 'show_if' => array( 'featured_image' => 'on', 'featured_placement' => array( 'below', 'above' ), 'force_fullwidth' => 'off', ), 'sticky' => true, ), 'image_height' => array( 'label' => esc_html__( 'Featured Image Height', 'et_builder' ), 'description' => esc_html__( 'Adjust the height of the featured image.', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'tab_slug' => 'advanced', 'toggle_slug' => 'width', 'allowed_values' => et_builder_get_acceptable_css_string_values( 'height' ), 'default' => 'auto', 'default_unit' => 'px', 'range_settings' => array( 'min' => '0', 'max' => '1000', 'step' => '1', ), 'responsive' => true, 'show_if' => array( 'featured_image' => 'on', 'featured_placement' => array( 'below', 'above' ), ), 'sticky' => true, ), 'image_max_height' => array( 'label' => esc_html__( 'Featured Image Max Height', 'et_builder' ), 'description' => esc_html__( 'Adjust the max height of the featured image.', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'tab_slug' => 'advanced', 'toggle_slug' => 'width', 'allowed_values' => et_builder_get_acceptable_css_string_values( 'max-height' ), 'default' => 'none', 'default_unit' => 'px', 'range_settings' => array( 'min' => '0', 'max' => '1000', 'step' => '1', ), 'responsive' => true, 'show_if' => array( 'featured_image' => 'on', 'featured_placement' => array( 'below', 'above' ), ), 'sticky' => true, ), 'image_alignment' => array( 'label' => esc_html__( 'Image Alignment', 'et_builder' ), 'description' => esc_html__( 'Align image to the left, right or center.', 'et_builder' ), 'type' => 'align', 'option_category' => 'layout', 'options' => et_builder_get_text_orientation_options( array( 'justified' ) ), 'tab_slug' => 'advanced', 'toggle_slug' => 'image_settings', 'default' => 'center', 'responsive' => true, 'show_if' => array( 'featured_image' => 'on', 'featured_placement' => array( 'below', 'above' ), 'force_fullwidth' => 'off', ), ), 'text_color' => array( 'label' => esc_html__( 'Text Color', 'et_builder' ), 'type' => 'select', 'option_category' => 'color_option', 'options' => array( 'dark' => et_builder_i18n( 'Dark' ), 'light' => et_builder_i18n( 'Light' ), ), 'default_on_front' => 'dark', 'tab_slug' => 'advanced', 'toggle_slug' => 'text', 'hover' => 'tabs', 'description' => esc_html__( 'Here you can choose the color for the Title/Meta text', 'et_builder' ), ), 'text_background' => array( 'label' => esc_html__( 'Use Text Background Color', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'color_option', 'options' => array( 'off' => et_builder_i18n( 'No' ), 'on' => et_builder_i18n( 'Yes' ), ), 'default_on_front' => 'off', 'affects' => array( 'text_bg_color', ), 'tab_slug' => 'advanced', 'toggle_slug' => 'text', 'description' => esc_html__( 'Here you can choose whether or not use the background color for the Title/Meta text', 'et_builder' ), ), 'text_bg_color' => array( 'default' => 'rgba(255,255,255,0.9)', 'label' => esc_html__( 'Text Background Color', 'et_builder' ), 'description' => esc_html__( "Pick a color to use behind the post title text. Reducing the color's opacity will allow the background image to show through while still increasing text readability.", 'et_builder' ), 'type' => 'color-alpha', 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'text', 'hover' => 'tabs', 'mobile_options' => true, 'sticky' => true, ), ); return $fields; } public function get_transition_fields_css_props() { $fields = parent::get_transition_fields_css_props(); $fields['text_color'] = array( 'color' => implode( ', ', array( '%%order_class%% .entry-title', '%%order_class%% .et_pb_title_meta_container', ) ), ); $fields['text_bg_color'] = array( 'background-color' => '%%order_class%% .et_pb_title_container' ); $fields['image_height'] = array( 'height' => '%%order_class%% .et_pb_title_featured_container img' ); $fields['image_max_height'] = array( 'max-height' => '%%order_class%% .et_pb_title_featured_container img' ); $fields['image_width'] = array( 'width' => '%%order_class%% .et_pb_title_featured_container' ); $fields['image_max_width'] = array( 'max-width' => '%%order_class%% .et_pb_title_featured_container' ); return $fields; } /** * Renders the module output. * * @param array $attrs List of attributes. * @param string $content Content being processed. * @param string $render_slug Slug of module that is used for rendering output. * * @return string */ public function render( $attrs, $content, $render_slug ) { $multi_view = et_pb_multi_view_options( $this ); $featured_placement = $this->props['featured_placement']; $text_color = $this->props['text_color']; $text_color_hover = et_pb_hover_options()->get_value( 'text_color', $this->props ); $text_background = $this->props['text_background']; $header_level = $this->props['title_level']; $post_id = get_the_ID(); // display the shortcode only on singlular pages if ( ! is_singular() && ! is_et_pb_preview() ) { $post_id = 0; } $output = ''; $featured_image_output = ''; $parallax_image_background = $this->get_parallax_image_background(); if ( $post_id && $multi_view->has_value( 'featured_image', 'on' ) && ( 'above' === $featured_placement || 'below' === $featured_placement ) ) { $post_thumbnail_id = get_post_thumbnail_id( $post_id ); $featured_image_src = et_()->array_get( wp_get_attachment_image_src( $post_thumbnail_id, 'full' ), 0 ); $featured_image_alt = get_post_meta( $post_thumbnail_id, '_wp_attachment_image_alt', true ); $featured_image_title = get_the_title( $post_thumbnail_id ); $featured_image_class = et_pb_media_options()->get_image_attachment_class( $this->props, '', $post_thumbnail_id ); $featured_image_attrs = array( 'src' => $featured_image_src, 'alt' => $featured_image_alt, 'title' => $featured_image_title, ); if ( ! empty( $featured_image_class ) ) { $featured_image_attrs['class'] = esc_attr( $featured_image_class ); } $featured_image_content = $multi_view->render_element( array( 'tag' => 'img', 'attrs' => $featured_image_attrs, ) ); $featured_image_output = $multi_view->render_element( array( 'tag' => 'div', 'content' => sprintf( '%1$s', $featured_image_content ), 'attrs' => array( 'class' => 'et_pb_title_featured_container', ), 'visibility' => array( 'featured_image' => 'on', ), ) ); // Image height. $this->generate_styles( array( 'hover' => false, 'base_attr_name' => 'image_height', 'selector' => '%%order_class%% .et_pb_title_featured_container img', 'css_property' => 'height', 'render_slug' => $render_slug, 'type' => 'range', ) ); // Image max height. $this->generate_styles( array( 'hover' => false, 'base_attr_name' => 'image_max_height', 'selector' => '%%order_class%% .et_pb_title_featured_container img', 'css_property' => 'max-height', 'render_slug' => $render_slug, 'type' => 'range', ) ); if ( 'off' === $this->props['force_fullwidth'] ) { // Image width. $this->generate_styles( array( 'hover' => false, 'base_attr_name' => 'image_width', 'selector' => '%%order_class%% .et_pb_title_featured_container', 'css_property' => 'width', 'render_slug' => $render_slug, 'type' => 'range', ) ); // Image max width. $this->generate_styles( array( 'hover' => false, 'base_attr_name' => 'image_max_width', 'selector' => '%%order_class%% .et_pb_title_featured_container', 'css_property' => 'max-width', 'render_slug' => $render_slug, 'type' => 'range', ) ); // Image alignment style $image_alignment_values = et_pb_responsive_options()->get_property_values( $this->props, 'image_alignment', 'none' ); et_pb_responsive_options()->generate_responsive_css( $image_alignment_values, '%%order_class%% .et_pb_title_featured_container', 'text-align', $render_slug, '', 'align' ); $image_alignments = array( 'left' => 'auto auto auto 0', 'center' => 'auto', 'right' => 'auto 0 auto auto', ); foreach ( $image_alignment_values as $breakpoint => $alignment ) { $image_alignment_values[ $breakpoint ] = et_()->array_get( $image_alignments, $alignment, '' ); } et_pb_responsive_options()->generate_responsive_css( $image_alignment_values, '%%order_class%% .et_pb_title_featured_container', 'margin', $render_slug, '', 'align' ); ET_Builder_Element::set_style( $render_slug, array( 'selector' => '%%order_class%% .et_pb_image_wrap', 'declaration' => 'width: auto;', ) ); } } if ( $multi_view->has_value( 'title', 'on' ) ) { if ( is_et_pb_preview() && isset( $_POST['post_title'] ) && wp_verify_nonce( $_POST['et_pb_preview_nonce'], 'et_pb_preview_nonce' ) ) { $post_title = sanitize_text_field( wp_unslash( $_POST['post_title'] ) ); } else { // Unescaped for backwards compat reasons. $post_title = et_core_intentionally_unescaped( et_builder_get_current_title(), 'html' ); } $output .= $multi_view->render_element( array( 'tag' => et_pb_process_header_level( $header_level, 'h1' ), 'content' => $post_title, 'attrs' => array( 'class' => 'entry-title', ), 'visibility' => array( 'title' => 'on', ), ) ); } if ( $post_id && $multi_view->has_value( 'meta', 'on' ) ) { $post_meta_keys = array( 'author', 'date', 'categories', 'comments', ); $post_metas = array( 'desktop' => array(), 'tablet' => array(), 'phone' => array(), 'hover' => array(), ); foreach ( $post_metas as $mode => $post_meta ) { foreach ( $post_meta_keys as $post_meta_key ) { if ( $multi_view->has_value( $post_meta_key, 'on', $mode, true ) ) { $post_meta[ $post_meta_key ] = $post_meta_key; } } $post_metas[ $mode ] = implode( ',', $post_meta ); } $multi_view->set_custom_prop( 'post_metas', $post_metas ); $output .= $multi_view->render_element( array( 'tag' => 'p', 'content' => '{{post_metas}}', 'attrs' => array( 'class' => 'et_pb_title_meta_container', ), 'visibility' => array( 'meta' => 'on', ), ) ); } if ( 'on' === $text_background ) { // Text Background Color. $this->generate_styles( array( 'base_attr_name' => 'text_bg_color', 'selector' => '%%order_class%% .et_pb_title_container', 'css_property' => 'background-color', 'render_slug' => $render_slug, 'type' => 'color', 'additional_css' => 'padding: 1em 1.5em;', ) ); } $video_background = $this->video_background(); $background_layout = 'dark' === $text_color ? 'light' : 'dark'; $data_background_layout = ''; $data_background_layout_hover = ''; if ( et_pb_hover_options()->is_enabled( 'text_color', $this->props ) && ! empty( $text_color_hover ) && $text_color !== $text_color_hover ) { $data_background_layout = sprintf( ' data-background-layout="%1$s"', esc_attr( $text_color_hover ) ); $data_background_layout_hover = sprintf( ' data-background-layout-hover="%1$s"', esc_attr( $text_color ) ); } // Module classnames $this->add_classname( array( "et_pb_bg_layout_{$background_layout}", $this->get_text_orientation_classname(), ) ); if ( 'on' === $multi_view->get_value( 'featured_image' ) && 'background' === $featured_placement ) { $this->add_classname( 'et_pb_featured_bg' ); } $muti_view_data_attr = $multi_view->render_attrs( array( 'classes' => array( 'et_pb_featured_bg' => array( 'featured_image' => 'on', 'featured_placement' => 'background', ), ), ) ); $output = sprintf( ' %4$s %7$s %5$s
%1$s
%6$s ', $output, $this->module_classname( $render_slug ), $this->module_id(), $parallax_image_background, 'above' === $featured_placement ? $featured_image_output : '', // #5 'below' === $featured_placement ? $featured_image_output : '', $video_background, et_core_esc_previously( $data_background_layout ), et_core_esc_previously( $data_background_layout_hover ), et_core_esc_previously( $muti_view_data_attr ) // #10 ); return $output; } /** * Filter multi view value. * * @since 3.27.1 * * @see ET_Builder_Module_Helper_MultiViewOptions::filter_value * * @param mixed $raw_value Props raw value. * @param array $args { * Context data. * * @type string $context Context param: content, attrs, visibility, classes. * @type string $name Module options props name. * @type string $mode Current data mode: desktop, hover, tablet, phone. * @type string $attr_key Attribute key for attrs context data. Example: src, class, etc. * @type string $attr_sub_key Attribute sub key that availabe when passing attrs value as array such as styes. Example: padding-top, margin-botton, etc. * } * * @return mixed */ public function multi_view_filter_value( $raw_value, $args ) { $name = isset( $args['name'] ) ? $args['name'] : ''; $context = isset( $args['context'] ) ? $args['context'] : ''; if ( $raw_value && 'post_metas' === $name && 'content' === $context ) { $post_metas = array(); foreach ( explode( ',', $raw_value ) as $post_meta ) { if ( 'categories' === $post_meta && ! is_singular( 'post' ) ) { continue; } $post_metas[] = $post_meta; } $raw_value = et_pb_postinfo_meta( $post_metas, $this->props['date_format'], esc_html__( '0 comments', 'et_builder' ), esc_html__( '1 comment', 'et_builder' ), '% ' . esc_html__( 'comments', 'et_builder' ) ); } return $raw_value; } } if ( et_builder_should_load_all_module_data() ) { new ET_Builder_Module_Post_Title(); }