文件操作 - blog.php

文件: /storage/v12552/jimbrandstatter/public_html/wp-content/themes/Total/inc/functions/frontend/blog.php

编辑文件内容

<?php

defined( 'ABSPATH' ) || exit;

/*-------------------------------------------------------------------------------*/
/* [ Table of contents ]
/*-------------------------------------------------------------------------------*

# Archives
	# Entry
	# Single
	# Slider
	# Related
	# Cards
	# Deprecated

/*-------------------------------------------------------------------------------*/
/* [ Archives ]
/*-------------------------------------------------------------------------------*/

/**
 * Exclude categories from the blog.
 * This function runs on pre_get_posts
 */
if ( ! function_exists( 'wpex_blog_exclude_categories' ) ) {
	function wpex_blog_exclude_categories( $deprecated = true ) {
		$cats = get_theme_mod( 'blog_cats_exclude' );
		if ( $cats && ! is_array( $cats ) ) {
			$cats = explode( ',', $cats ); // Convert to array
		}
		return $cats;
	}
}

/**
 * Returns the correct blog style.
 * @deprecated 5.0
 */
function wpex_blog_style() {
	return wpex_blog_entry_style();
}

/**
 * Returns the grid style.
 */
function wpex_blog_grid_style() {
	$style = (string) get_theme_mod( 'blog_grid_style' );

if ( $cat_meta = wpex_get_category_meta( '', 'wpex_term_grid_style' ) ) {
		$style = $cat_meta;
	}

if ( ! $style ) {
		$style = 'fit-rows';
	}

/**
	 * Filters the blog archive grid style.
	 *
	 * @param string $style
	 */
	$style = (string) apply_filters( 'wpex_blog_grid_style', $style );

return $style;
}

/**
 * Checks if it's a fit-rows style grid.
 *
 * @deprecated
 */
function wpex_blog_fit_rows() {
	$check = false;

if ( 'grid-entry-style' === wpex_blog_entry_style() ) {
		$check = true;
	}

/**
	 * Filters whether the blog archive is masonry style is set to fit-rows.
	 *
	 * @param bool $check
	 */
	$check = (bool) apply_filters( 'wpex_blog_fit_rows', $check );

return $check;
}

/**
 * Returns the correct pagination style.
 */
function wpex_blog_pagination_style() {
	$style = get_theme_mod( 'blog_pagination_style' );

if ( is_category() && $cat_meta = wpex_get_category_meta( '', 'wpex_term_pagination' ) ) {
		$style = $cat_meta;
	}

/**
	 * Filters the blog pagination style.
	 *
	 * @param string $style
	 */
	$style = (string) apply_filters( 'wpex_blog_pagination_style', $style );

return $style;
}

/**
 * Get blog wrap classes.
 */
function wpex_get_blog_wrap_classes( $classes = NULL ) {
	if ( $classes ) {
		return $classes;
	}

$classes = [
		'entries',
	];

$style = wpex_blog_entry_style();

// Grid classes.
	if ( $style === 'grid-entry-style' || 'wpex_card' === $style ) {

$classes[] = 'wpex-row';

if ( 'masonry' === wpex_blog_grid_style() ) {
			$classes[] = 'wpex-masonry-grid';
			$classes[] = 'blog-masonry-grid';
			wpex_enqueue_isotope_scripts(); // good place to load masonry scripts
		} else {
			$classes[] = 'blog-grid';
		}

$cat_meta_gap = wpex_get_category_meta( '', 'wpex_term_grid_gap' );

if ( $cat_meta_gap ) {
			$gap = $cat_meta_gap;
		} else {
			$gap = get_theme_mod( 'blog_grid_gap' );
		}

if ( $gap ) {
			$classes[] = 'gap-' . absint( $gap );
		}

}

// Left thumbs extra classes.
	if ( 'thumbnail-entry-style' === $style ) {
		$classes[] = 'left-thumbs';
	}

// Add some margin when author is enabled.
	if ( $style === 'grid-entry-style' && get_theme_mod( 'blog_entry_author_avatar' ) ) {
		$classes[] = 'grid-w-avatars';
	}

// Equal heights class.
	if ( wpex_blog_entry_equal_heights() ) {
		$classes[] = 'blog-equal-heights';
	}

// Infinite scroll classes.
	if ( 'infinite_scroll' === wpex_blog_pagination_style() ) {
		$classes[] = 'infinite-scroll-wrap';
	}

$classes[] = 'wpex-clr';

// Sanitize.
	$classes = array_map( 'esc_attr', $classes );

/**
	 * Filter the blog wrap element classes.
	 *
	 * @param array|string $classes
	 */
	$classes = apply_filters( 'wpex_blog_wrap_classes', $classes );

// Turn classes into space seperated string.
	if ( is_array( $classes ) ) {
		$classes = implode( ' ', $classes );
	}

return $classes;
}

/**
 * Adds main classes to blog post entries
 */
function wpex_blog_wrap_classes( $classes = NULL ) {
	echo wpex_get_blog_wrap_classes();
}

/*-------------------------------------------------------------------------------*/
/* [ Entries ]
/*-------------------------------------------------------------------------------*/

/**
 * Returns blog entry style.
 */
function wpex_blog_entry_style() {
	if ( wpex_blog_entry_card_style() ) {
		return 'wpex_card';
	}

$style = get_theme_mod( 'blog_style' );

// Category meta check.
	$cat_meta = wpex_get_category_meta( '', 'wpex_term_style' );
	if ( $cat_meta ) {
		$cat_meta_safe = sanitize_html_class( $cat_meta );
		$style = "{$cat_meta_safe}-entry-style";
	}

if ( ! $style ) {
		$style = 'large-image-entry-style';
	}

/**
	 * Filters the blog entry style.
	 *
	 * @param string $style
	 * @deprecated 5.0
	 */
	$style = apply_filters( 'wpex_blog_style', $style );

/**
	 * Filters the blog entry style.
	 *
	 * @param string $style
	 */
	$style = (string) apply_filters( 'wpex_blog_entry_style', $style );

return $style;
}

/**
 * Blog Entry media type.
 */
function wpex_blog_entry_media_type() {
	$format = get_post_format();

$type = 'thumbnail';

switch ( $format ) {

case 'video':

if ( ! post_password_required()
				&& get_theme_mod( 'blog_entry_video_output', true )
				&& wpex_has_post_video()
			) {
				$type = 'video';
			}

break;

case 'audio':

if ( apply_filters( 'wpex_blog_entry_audio_embed', get_theme_mod( 'blog_entry_audio_output', false ) )
				&& ! post_password_required()
				&& wpex_has_post_audio()
			) {
				$type = 'audio';
			}

break;

case 'gallery':

if ( wpex_blog_entry_slider_enabled() && wpex_has_post_gallery() ) {
				$type = 'gallery';
			}

break;

case 'link':

if ( wpex_has_post_redirection() ) {
				$type = 'link';
			}

break;

}

// Check for thumbnail existense so we don't end up with empty media div
	if ( ( 'thumbnail' === $type || 'link' === $type ) && ! has_post_thumbnail() ) {
		$type = '';
	}

/**
	 * Filters the blog entry media type.
	 *
	 * @param string $type
	 */
	$type = (string) apply_filters( 'wpex_blog_entry_media_type', $type );

return $type;
}

/**
 * Check if blog entry has an avatar enabled.
 */
function wpex_has_blog_entry_avatar() {
	$check = get_theme_mod( 'blog_entry_author_avatar', false );

/**
	 * Checks whether the blog entry should display the author avatar or not.
	 *
	 * @param bool $check
	 */
	$check = (bool) apply_filters( 'wpex_has_blog_entry_avatar', $check );

return $check;
}

/**
 * Blog entry divider.
 */
function wpex_blog_entry_divider() {
	$divider = '';

$entry_style = wpex_blog_entry_style();

switch ( $entry_style ) {
		case 'large-image-entry-style':
			$divider = 'wpex-divider wpex-my-40';
			break;
		case 'thumbnail-entry-style':
			$divider = 'wpex-divider wpex-my-30';
			break;
	}

if ( $divider ) {
		$divider = '<div class="entry-divider ' . esc_attr( $divider ) . '"></div>';
	}

/**
	 * Filters the blog entry divider html.
	 *
	 * @param string $divider
	 */
	echo apply_filters( 'wpex_blog_entry_divider', $divider );
}

/**
 * Checks if the blog entries should have equal heights.
 */
function wpex_blog_entry_equal_heights() {
	$check = ( get_theme_mod( 'blog_archive_grid_equal_heights', false ) && 'grid-entry-style' === wpex_blog_entry_style() && 'masonry' !== wpex_blog_grid_style() );

/*** deprecated ***/
	$check = apply_filters( 'wpex_blog_entry_equal_heights', $check );

return (bool) $check;
}

/**
 * Returns columns for the blog entries.
 */
function wpex_blog_entry_columns( $entry_style = '' ) {
	if ( ! $entry_style ) {
		$entry_style = wpex_blog_entry_style();
	}

if ( ! in_array( $entry_style, [ 'grid-entry-style', 'wpex_card' ] ) ) {
		return 1; // always 1 unless it's a grid
	}

// Get columns from customizer setting.
	$columns = get_theme_mod( 'blog_grid_columns', '2' );

// Category meta check.
	$cat_meta = wpex_get_category_meta( '', 'wpex_term_grid_cols' );
	if ( $cat_meta ) {
		$columns = $cat_meta;
	}

// Set default columns to 2 if a value isn't set.
	if ( is_array( $columns ) ) {
		if ( empty( $columns['d'] ) ) {
			$columns['d'] = '2';
		}
	} elseif ( ! $columns ) {
		$columns = '2';
	}

/**
	 * Filters the number of columns used for the blog entries.
	 *
	 * @param int|string $columns
	 */
	$columns = apply_filters( 'wpex_blog_entry_columns', $columns );

return $columns;
}

/**
 * Blog Entry Class.
 */
function wpex_blog_entry_class() {
	$classes = wpex_blog_entry_classes();

/**
	 * Filters the blog entry class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_class', $classes );

post_class( $classes );
}

/**
 * Returns blog entry classes.
 */
function wpex_blog_entry_classes() {
	$entry_style = wpex_blog_entry_style();

$classes = [
		'blog-entry',
	];

if ( 'masonry' === wpex_blog_grid_style() ) {
		$classes[] = 'wpex-masonry-col';
	}

if ( 'grid-entry-style' === $entry_style || 'wpex_card' === $entry_style ) {

$grid_class = wpex_row_column_width_class( wpex_blog_entry_columns( $entry_style ) );

if ( $grid_class ) {
			$classes[] = 'col';
			$classes[] = $grid_class;
		}

$counter = wpex_get_loop_counter();

if ( $counter ) {
			$classes[] = 'col-' . sanitize_html_class( $counter );
		}

}

if ( 'wpex_card' !== $entry_style ) {
		$classes[] = sanitize_html_class( $entry_style );
	}

if ( $avatar_enabled = get_theme_mod( 'blog_entry_author_avatar' ) ) {
		$classes[] = 'entry-has-avatar';
	}

$classes[] = 'wpex-relative';
	$classes[] = 'wpex-clr';

// Sanitize classes.
	$classes = array_map( 'esc_attr', $classes );

/**
	 * Filters the blog entry element classes.
	 *
	 * @param array $class
	 * @todo deprecate
	 */
	$classes = apply_filters( 'wpex_blog_entry_classes', $classes );

return $classes;
}

/**
 * Blog Entry Inner Class.
 */
function wpex_blog_entry_inner_class() {
	$classes = [
		'blog-entry-inner',
		'entry-inner',
	];

$entry_style = wpex_blog_entry_style();

if ( 'grid-entry-style' === $entry_style ) {
		$classes[] = 'wpex-px-20';
		$classes[] = 'wpex-pb-20';
		$classes[] = 'wpex-border';
		$classes[] = 'wpex-border-solid';
		$classes[] = 'wpex-border-main';

if ( wpex_blog_entry_equal_heights() ) {
			// Can't do this because elements have top/bottom margins
			// and the spacing won't collapse.
		//	$classes[] = 'wpex-flex';
		//	$classes[] = 'wpex-flex-col';
			$classes[] = 'wpex-flex-grow';
		}
	}

$classes[] = 'wpex-last-mb-0';

$classes[] = 'wpex-clr';

/**
	 * Filters the blog entry inner element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_inner_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Entry Quote Class.
 */
function wpex_blog_entry_quote_class() {
	$classes = [
		'post-quote-entry-inner',
		'wpex-boxed',
		'wpex-relative',
		'wpex-z-5',
		'wpex-text-lg',
		'wpex-italic',
		'wpex-last-mb-0',
	];

if ( is_singular() ) {
		$classes[] = 'wpex-mb-40';
	}

$classes[] = 'wpex-clr';

/**
	 * Filters the blog entry quote format element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_quote_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Entry Quote Class.
 */
function wpex_blog_entry_quote_icon_class() {
	$class = [
		'ticon',
		is_rtl() ? 'ticon-quote-left' : 'ticon-quote-right',
		//'wpex-text-7xl', // ticons overrides the font size.
		'wpex-opacity-10',
		'wpex-absolute',
		'wpex-right-0',
		'wpex-bottom-0',
		'wpex-mb-20',
		'wpex-mr-20',
		'wpex-z-1',
	];

/**
	 * Filters the blog entry quote format icon class.
	 *
	 * @param string $class
	 */
	$class = (array) apply_filters( 'wpex_blog_entry_quote_icon_class', $class );

if ( $class ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $class ) ) ) . '"';
	}
}

/**
 * Blog Entry Media Class.
 */
function wpex_blog_entry_media_class() {
	$entry_style = wpex_blog_entry_style();

$classes = [
		'blog-entry-media',
		'entry-media',
	];

if ( 'thumbnail-entry-style' !== $entry_style ) {
		$classes[] = 'wpex-mb-20';
	}

if ( 'grid-entry-style' === $entry_style ) {
		$classes[] = '-wpex-mx-20';
	}

$media_type = wpex_blog_entry_media_type();

if ( 'thumbnail' === $media_type || 'link' === $media_type ) {
		$overlay = totaltheme_call_static(
			'Overlays',
			'get_entry_image_overlay_style',
			'post'
		);
		if ( $overlay ) {
			$overlay_class = (string) totaltheme_call_static(
				'Overlays',
				'get_parent_class',
				(string) $overlay
			);
			if ( $overlay_class ) {
				$classes[] = $overlay_class;
			}
		}
		if ( $animation_classes = wpex_get_entry_image_animation_classes() ) {
			$classes[] = $animation_classes;
		}
	}

/**
	 * Filters the blog entry media element class.
	 *
	 * @param string $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_media_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( trim( implode( ' ', array_unique( $classes ) ) ) ) . '"';
	}
}

/**
 * Blog Entry Header Class.
 */
function wpex_blog_entry_header_class() {
	$classes = [
		'blog-entry-header',
		'entry-header',
	];

if ( wpex_has_blog_entry_avatar() ) {
		$classes[] = 'wpex-flex';
		$classes[] = 'wpex-items-center';
	}

$entry_style = wpex_blog_entry_style();

switch ( $entry_style ) {

case 'grid-entry-style':
			if ( ! wpex_post_has_media() ) {
				$classes[] = 'wpex-mt-20'; // prevent issues when there isn't any media
			}
			$classes[] = 'wpex-mb-10';
			break;

default:
			$classes[] = 'wpex-mb-10';
			break;

}

/**
	 * Filters the blog entry header element class.
	 *
	 * @param string $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_header_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Entry Title Class.
 */
function wpex_blog_entry_title_class() {
	$classes = [
		'blog-entry-title',
		'entry-title',
	];

if ( wpex_has_blog_entry_avatar() ) {
		$classes[] = 'wpex-flex-grow';
	}

$entry_style = wpex_blog_entry_style();

switch ( $entry_style ) {
		case 'grid-entry-style':
			$classes[] = 'wpex-text-lg';
			break;
		case 'thumbnail-entry-style':
			$classes[] = 'wpex-text-2xl';
			break;
		default:
			$classes[] = 'wpex-text-3xl';
			break;
	}

/**
	 * Filters the blog entry title element class.
	 *
	 * @param string $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_title_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Entry Avatar Class.
 */
function wpex_blog_entry_avatar_class() {
	$classes = [
		'blog-entry-author-avatar',
		'wpex-flex-shrink-0',
		'wpex-mr-20',
	//	'wpex-mb-5', // deprecated in 5.3.1
	];

/**
	 * Filters the blog entry avatar element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_avatar_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Entry Content Class | used for left/right layouts.
 */
function wpex_blog_entry_content_class() {
	$classes = [
		'blog-entry-content',
		'entry-details',
		'wpex-last-mb-0',
		'wpex-clr',
	];

/**
	 * Filters the blog entry content element class.
	 *
	 * @param string $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_content_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Entry Excerpt Class.
 */
function wpex_blog_entry_excerpt_class() {
	$classes = [
		'blog-entry-excerpt',
		'entry-excerpt',
	];

$entry_style = wpex_blog_entry_style();

switch ( $entry_style ) {
		case 'grid-entry-style':
			$classes[] = 'wpex-my-15';
			break;
		default:
			$classes[] = 'wpex-my-20';
			break;
	}

$classes[] = 'wpex-last-mb-0';

$classes[] = 'wpex-clr';

/**
	 * Filters the blog entry excerpt element class.
	 *
	 * @param string $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_excerpt_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Entry Button Wrap Class.
 */
function wpex_blog_entry_button_wrap_class() {
	$classes = [
		'blog-entry-readmore',
		'entry-readmore-wrap',
	];

$entry_style = wpex_blog_entry_style();

switch ( $entry_style ) {
		case 'grid-entry-style':
			$classes[] = 'wpex-my-15';
			break;
		default:
			$classes[] = 'wpex-my-20';
			break;
	}

$classes[] = 'wpex-clr';

/**
	 * Filters the blog entry button wrap element class.
	 *
	 * @param string $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_button_wrap_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Entry Button Class.
 */
function wpex_blog_entry_button_class() {
	$args = [
		'style' => '',
		'color' => '',
	];

/**
	 * Filters the blog entry button args.
	 *
	 * @param array $args
	 */
	$args = (array) apply_filters( 'wpex_blog_entry_button_args', $args );

$button_class = wpex_get_button_classes( $args );

if ( is_array( $button_class ) ) {
		$classes = $button_class;
	} else {
		$classes = explode( ' ', $button_class );
	}

/**
	 * Filters the blog entry button element class.
	 *
	 * @param string $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_entry_button_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Returns the blog entry thumbnail.
 */
function wpex_blog_entry_thumbnail( $args = '' ) {
	echo wpex_get_blog_entry_thumbnail( $args );
}

/**
 * Returns the blog entry thumbnail args.
 */
function wpex_get_blog_entry_thumbnail_args( $args = '' ) {
	if ( $args && ! is_array( $args ) ) {
		$args = [
			'attachment' => $args,
		];
	}

// Define thumbnail args
	$defaults = [
		'attachment'    => get_post_thumbnail_id(),
		'size'          => 'blog_entry',
		'class'         => 'blog-entry-media-img wpex-align-middle',
		'apply_filters' => 'wpex_blog_entry_thumbnail_args',
	];

// Parse arguments
	$args = wp_parse_args( $args, $defaults );

// Check category image width meta
	$cat_meta_image_width = wpex_get_category_meta( '', 'wpex_term_image_width' );
	if ( $cat_meta_image_width ) {
		$args['size']  = 'wpex_custom';
		$args['width'] = $cat_meta_image_width;
	}

// Check category image height meta
	$cat_meta_image_height = wpex_get_category_meta( '', 'wpex_term_image_height' );
	if ( $cat_meta_image_height ) {
		$args['size']  = 'wpex_custom';
		$args['height'] = $cat_meta_image_height;
	}

return $args;
}

/**
 * Returns the blog entry thumbnail.
 */
function wpex_get_blog_entry_thumbnail( $args = '' ) {
	$thumbnail = wpex_get_post_thumbnail( wpex_get_blog_entry_thumbnail_args( $args ) );

/**
	 * Filters the blog entry thumbnail html.
	 *
	 * @param string $thumbnail
	 */
	$thumbnail = apply_filters( 'wpex_blog_entry_thumbnail', $thumbnail );

return $thumbnail;
}

/**
 * Check if the blog slider is disabled.
 */
function wpex_blog_entry_slider_enabled() {
	$check = get_theme_mod( 'blog_entry_gallery_output', true );
	if ( apply_filters( 'wpex_disable_entry_slider', false ) || post_password_required() ) {
		$check = false;
	}
	return $check;
}

/*-------------------------------------------------------------------------------*/
/* [ Single ]
/*-------------------------------------------------------------------------------*/

/**
 * Blog Single media type.
 */
function wpex_blog_single_media_type() {
	$type = '';

switch ( get_post_format() ) {
		case 'video':
			if ( ! post_password_required()
				&& wpex_has_post_video()
			) {
				$type = 'video';
			} else {
				$type = 'thumbnail';
			}
			break;
		case 'audio':
			if ( ! post_password_required() && wpex_has_post_audio() ) {
				$type = 'audio';
			} else {
				$type = 'thumbnail';
			}
			break;
		case 'gallery':
			$type = ( wpex_has_post_gallery() ) ? 'gallery' : 'thumbnail';
			break;
		case 'link':
			$type = 'link';
			break;
		default:
			$type = 'thumbnail';
			break;
	}

// Check for thumbnail existense so we don't end up with empty media div
	if ( ( 'thumbnail' === $type || 'link' === $type ) && ! has_post_thumbnail() ) {
		$type = '';
	}

/**
	 * Filters the blog post media type.
	 *
	 * @param string $type
	 */
	$type = (string) apply_filters( 'wpex_blog_single_media_type', $type );

return $type;
}

/**
 * Blog Single lightbox check.
 */
function wpex_has_blog_single_thumbnail_lightbox() {
	$check = get_theme_mod( 'blog_post_image_lightbox', false );

/**
	 * Filters whether the blog post thumbnail should open in lightbox.
	 *
	 * @param bool $check
	 */
	$check = (bool) apply_filters( 'wpex_has_blog_single_thumbnail_lightbox', $check );

return $check;
}

/**
 * Blog Single caption.
 * @todo include support for custom post types?
 */
function wpex_blog_single_thumbnail_caption() {
	if ( ! get_theme_mod( 'blog_thumbnail_caption' ) ) {
		return;
	}

$caption     = wpex_featured_image_caption();
	$has_caption = (bool) $caption;

if ( ! $has_caption ) {
		return;
	}

$classes = [
		'post-media-caption',
		'wpex-absolute',
		'wpex-inset-x-0',
		'wpex-bottom-0',
		'wpex-p-15',
		'wpex-text-white',
		'wpex-child-inherit-color',
		'wpex-text-sm',
		'wpex-text-center',
		'wpex-last-mb-0',
		'wpex-clr',
	];

/**
	 * Filters the blog single thumbnail caption element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_single_thumbnail_caption_class', $classes );

<?php }

/**
 * Returns the blog entry thumbnail args.
 *
 * @todo rename to wpex_get_blog_single_thumbnail_args?
 */
function wpex_get_blog_post_thumbnail_args( $args = '' ) {
	if ( ! is_array( $args ) && ! empty( $args ) ) {
		$args = [
			'attachment' => $args,
		];
	}

$defaults = [
		'size'          => 'blog_post',
		'class'         => 'blog-single-media-img wpex-align-middle',
		'apply_filters' => 'wpex_blog_post_thumbnail_args',
	];

$args = wp_parse_args( $args, $defaults );

if ( 'above' === wpex_get_custom_post_media_position() ) {
		$args['size'] = 'blog_post_full';
	}

return $args;
}

/**
 * Displays the blog post thumbnail.
 */
function wpex_blog_post_thumbnail( $args = '' ) {
	echo wpex_get_blog_post_thumbnail( $args );
}

/**
 * Returns the blog post thumbnail.
 */
function wpex_get_blog_post_thumbnail( $args = '' ) {
	$supports_thumbnail = ( 'audio' === get_post_format() ) ? false : true;

if ( apply_filters( 'wpex_blog_post_supports_thumbnail', $supports_thumbnail ) ) {

$thumbnail_args = wpex_get_blog_post_thumbnail_args( $args );
		$thumbnail_html = wpex_get_post_thumbnail( $thumbnail_args );

if ( shortcode_exists( 'featured_revslider' ) ) {
			$thumbnail_html = do_shortcode( '[featured_revslider]' . $thumbnail_html . '[/featured_revslider]' );
		}

$thumbnail_html = apply_filters( 'wpex_blog_post_thumbnail', $thumbnail_html );

return $thumbnail_html;
	}
}

/**
 * Blog Single Content Class.
 */
function wpex_blog_single_content_class() {
	$classes = [
		'single-blog-content',
		'single-content',
		'entry',
		'wpex-mt-20',
		'wpex-mb-40',
		'wpex-clr',
	];

/**
	 * Filters the blog single content element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_single_content_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', array_unique( $classes ) ) ) . '"';
	}
}

/**
 * Blog Single Header Class.
 */
function wpex_blog_single_header_class() {
	$classes = [
		'single-blog-header',
		'wpex-mb-10',
	];

/**
	 * Filters the blog single header element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_single_header_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', $classes ) ) . '"';
	}
}

/**
 * Blog Single Title Class.
 */
function wpex_blog_single_title_class() {
	$classes = [
		'single-post-title',
		'entry-title',
		'wpex-text-3xl',
	];

/**
	 * Filters the blog single title element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_single_title_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', $classes ) ) . '"';
	}
}

/**
 * Blog single media class.
 */
function wpex_blog_single_media_class() {
	$classes = [
		'single-blog-media',
		'single-media',
		'wpex-relative',
		'wpex-mb-20',
	];

if ( 'above' === wpex_get_custom_post_media_position() ) {
		$classes[] = 'wpex-md-mb-30';
	}

/**
	 * Filters the blog single media element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_single_media_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', $classes ) ) . '"';
	}
}

/*-------------------------------------------------------------------------------*/
/* [ Related ]
/*-------------------------------------------------------------------------------*/

/**
 * Blog single related query.
 */
function wpex_blog_single_related_query() {
	$post_id = get_the_ID();

if ( wpex_validate_boolean( get_post_meta( $post_id, 'wpex_disable_related_items', true ) ) ) {
		return false;
	}

$posts_count = absint( get_theme_mod( 'blog_related_count', 3 ) );

if ( empty( $posts_count ) ) {
		return false;
	}

$args = [
		'posts_per_page'      => $posts_count,
		'order'               => get_theme_mod( 'blog_related_order', 'desc' ),
		'orderby'             => get_theme_mod( 'blog_related_orderby', 'date' ),
		'post__not_in'        => [ $post_id ],
		'no_found_rows'       => true,
		'ignore_sticky_posts' => true,

// exclude quote and link formats from related items
		'tax_query'           => [
			'relation'  => 'AND',
			[
				'taxonomy' => 'post_format',
				'field'    => 'slug',
				'terms'    => [ 'post-format-quote', 'post-format-link' ],
				'operator' => 'NOT IN',
			],
		],

];

// Related by taxonomy.
	if ( apply_filters( 'wpex_related_in_same_cat', true ) ) {

// Add categories to query
		$related_taxonomy = get_theme_mod( 'blog_related_taxonomy', 'category' );

// Generate related by taxonomy args
		if ( 'null' !== $related_taxonomy && taxonomy_exists( $related_taxonomy ) ) {

$terms = '';

$primary_term = wpex_get_post_primary_term( $post_id, $related_taxonomy );

if ( $primary_term ) {

$terms = [ $primary_term->term_id ];

} else {

$get_terms = get_the_terms( $post_id, $related_taxonomy );

if ( $get_terms && ! is_wp_error( $get_terms ) ) {
					$terms = wp_list_pluck( $get_terms, 'term_id' );
				}

}

if ( $terms ) {
				$args['tax_query'][] = [
					'taxonomy' => $related_taxonomy,
					'field'    => 'term_id',
					'terms'    => $terms,
				];
			}

}

// If content is disabled make sure items have featured images.
	if ( ! get_theme_mod( 'blog_related_excerpt', true ) ) {
		$args['meta_key'] = '_thumbnail_id';
	}

/**
	 * Filters the blog post related query args.
	 *
	 * @param array $args
	 * @todo deprecate
	 */
	$args = (array) apply_filters( 'wpex_blog_post_related_query_args', $args );

if ( $args ) {
		return new wp_query( $args );
	}
}

/**
 * Gets correct heading for the related blog items
 */
function wpex_blog_related_heading() {
	$heading = wpex_get_translated_theme_mod( 'blog_related_title' );
	if ( ! $heading ) {
		$heading = esc_html__( 'Related Posts', 'total' );
	}
	return $heading;
}

/**
 * Blog single related class.
 */
function wpex_blog_single_related_class() {
	$classes = [
		'related-posts',
		'wpex-overflow-hidden', // for the negative margins on the row
		'wpex-mb-40',
	];

if ( 'full-screen' === wpex_content_area_layout() ) {
		$classes[] = 'container';
	}

$classes[] = 'wpex-clr';

/**
	 * Filters the related blog section element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_single_related_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', $classes ) ) . '"';
	}
}

/**
 * Blog single related row class.
 */
function wpex_blog_single_related_row_class() {
	$classes = [
		'wpex-row',
		'wpex-clr',
	];

if ( $gap = get_theme_mod( 'blog_related_gap' ) ) {
		$classes[] = 'gap-' . sanitize_html_class( $gap );
	}

/**
	 * Filters the blog single related row element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_single_related_row_class', $classes );

if ( $classes ) {
		echo 'class="' . esc_attr( implode( ' ', $classes ) ) . '"';
	}
}

/**
 * Blog single related entry class.
 */
function wpex_blog_single_related_entry_class() {
	$classes = [
		'related-post',
		'col',
	];

$columns = wpex_blog_single_related_columns();

if ( $columns ) {
		$classes[] = wpex_row_column_width_class( $columns );
	}

$counter = wpex_get_loop_counter();

if ( $counter ) {
		$classes[] = 'col-' . sanitize_html_class( $counter );
	}

$classes[] = 'wpex-clr';

/**
	 * Filters the blog single related entry element class.
	 *
	 * @param array $class
	 */
	$classes = (array) apply_filters( 'wpex_blog_single_related_entry_class', $classes );

post_class( $classes );
}

/**
 * Returns columns for the blog single related entries.
 * @todo rename filter to wpex_blog_single_related_columns
 */
function wpex_blog_single_related_columns() {
	$columns = get_theme_mod( 'blog_related_columns', '3' );

/**
	 * Filters the blog single related entry columns.
	 *
	 * @param int|string $columns
	 */
	$columns = apply_filters( 'wpex_related_blog_posts_columns', $columns );

return $columns;
}

/*-------------------------------------------------------------------------------*/
/* [ Slider ]
/*-------------------------------------------------------------------------------*/

/**
 * Returns data attributes for the blog gallery slider.
 */
function wpex_blog_slider_data_atrributes() {
	echo wpex_get_slider_data( [
		'filter_tag' => 'wpex_blog_slider_data_atrributes',
	] );
}

/**
 * Returns blog slider video embed code.
 */
function wpex_blog_slider_video( $attachment ) {
	$video = get_post_meta( $attachment, '_video_url', true );
	if ( $video ) {
		$video_oembed = wp_oembed_get( esc_url( $video ) );
		if ( $video_oembed ) {
			return wpex_add_sp_video_to_oembed( $video_oembed );
		}
	}
}

/*-------------------------------------------------------------------------------*/
/* [ Cards ]
/*-------------------------------------------------------------------------------*/

/**
 * Blog entry card style.
 */
function wpex_blog_entry_card_style() {
	$instance = wpex_get_loop_instance();
	$style = get_query_var( 'card_style' );
	if ( empty( $style ) ) {
		switch ( $instance ) {
			case 'related':
				$style = get_theme_mod( 'blog_related_entry_card_style' );
				break;
			default:
				$style = get_theme_mod( 'blog_entry_card_style' );
				$cat_meta_check = wpex_get_term_meta( '', 'wpex_entry_card_style', true );
				if ( $cat_meta_check ) {
					$style = $cat_meta_check;
				}
				break;
		}
	}

/**
	 * Filters the blog entry card style.
	 *
	 * @param string $style
	 */
	$style = (string) apply_filters( 'wpex_blog_entry_card_style', $style );

return $style;
}

/**
 * Blog entry card.
 */
function wpex_blog_entry_card() {
	$instance   = wpex_get_loop_instance();
	$card_style = wpex_blog_entry_card_style();

if ( ! $card_style ) {
		return false;
	}

if ( 'related' === $instance ) {
		$thumbnail_size = 'blog_related';
		$excerpt_length = get_theme_mod( 'blog_related_excerpt_length', '15' );
	} else {
		$thumbnail_size = 'blog_entry';
		$excerpt_length = wpex_excerpt_length();

// Check category image size meta options
		$cat_meta_image_width = wpex_get_category_meta( '', 'wpex_term_image_width' );
		$cat_meta_image_height = wpex_get_category_meta( '', 'wpex_term_image_height' );

if ( $cat_meta_image_width || $cat_meta_image_height ) {
			$thumbnail_size = [ $cat_meta_image_width, $cat_meta_image_height ];
		}

}

$args = [
		'style'          => $card_style,
		'post_id'        => get_the_ID(),
		'thumbnail_size' => $thumbnail_size,
		'excerpt_length' => $excerpt_length,
	];

$overlay = totaltheme_call_static(
		'Overlays',
		'get_entry_image_overlay_style',
		'post'
	);

if ( $overlay ) {
		$args['thumbnail_overlay_style'] = $overlay;
	}

if ( $hover_style = get_theme_mod( 'blog_entry_image_hover_animation', null ) ) {
		$args['thumbnail_hover'] = $hover_style;
	}

/**
	 * Filters the blog entry card args.
	 *
	 * @param array $args
	 */
	$args = (array) apply_filters( 'wpex_blog_entry_card_args', $args, $card_style );

wpex_card( $args );

return true;
}

/*-------------------------------------------------------------------------------*/
/* [ Deprecated ]
/*-------------------------------------------------------------------------------*/

/**
 * Returns post video URL.
 */
function wpex_post_video_url( $post_id = '' ) {
	if ( ! $post_id ) {
		$post_id = get_the_ID();
	}

// Oembed video.
	if ( $meta = get_post_meta( $post_id, 'wpex_post_oembed', true ) ) {
		return esc_url( $meta );
	}

// Self Hosted redux video.
	$video = get_post_meta( $post_id, 'wpex_post_self_hosted_shortcode_redux', true );
	if ( is_array( $video ) && ! empty( $video['url'] ) ) {
		return $video['url'];
	}

// Self Hosted old - Thunder theme compatibility.
	if ( $meta = get_post_meta( $post_id, 'wpex_post_self_hosted_shortcode', true ) ) {
		return $meta;
	}
}

/**
 * Returns post audio URL.
 */
function wpex_post_audio_url( $post_id = '' ) {
	if ( ! $post_id ) {
		$post_id = get_the_ID();
	}

// Oembed audio url.
	if ( $meta = get_post_meta( $post_id, 'wpex_post_oembed', true ) ) {
		return $meta;
	}

// Self Hosted redux audio url.
	$audio = get_post_meta( $post_id, 'wpex_post_self_hosted_shortcode_redux', true );
	if ( is_array( $audio ) && ! empty( $audio['url'] ) ) {
		return $audio['url'];
	}

// Self Hosted old - Thunder theme compatibility.
	if ( $meta = get_post_meta( $post_id, 'wpex_post_self_hosted_shortcode', true ) ) {
		return $meta;
	}
}

文件操作 - blog.php

文件: /storage/v12552/jimbrandstatter/public_html/wp-content/themes/Total/inc/functions/frontend/blog.php

编辑文件内容

修改文件时间

删除文件