true,
], 'names' );
if ( function_exists( 'wpex_get_ptu_tax_mod' ) ) {
foreach ( $taxonomies as $taxonomy ) {
$ptu_check = wpex_get_ptu_tax_mod( $taxonomy, 'term_thumbnails', true );
if ( isset( $ptu_check ) && ! wp_validate_boolean( $ptu_check ) ) {
unset( $taxonomies[ $taxonomy ] );
}
}
}
$taxonomies = apply_filters( 'wpex_thumbnail_taxonomies', $taxonomies ); // @deprecated
return (array) apply_filters( 'totalthemecore/term_thumbnails/supported_taxonomies', $taxonomies );
}
/**
* Get things started in the backend to add/save the settings.
*/
public static function on_admin_init(): void {
foreach ( self::supported_taxonomies() as $taxonomy ) {
if ( self::page_header_image_enabled() || 'product_cat' !== $taxonomy ) {
add_action( "wpex_{$taxonomy}_form_fields_top", [ self::class, 'on_wpex_form_fields_top' ] );
}
if ( 'product_cat' !== $taxonomy ) {
add_action( "{$taxonomy}_add_form_fields", [ self::class, 'add_form_fields'], 10 );
add_filter( "manage_edit-{$taxonomy}_columns", [ self::class, 'admin_columns' ] );
add_filter( "manage_{$taxonomy}_custom_column", [ self::class, 'admin_column' ], 10, 3 );
}
add_action( "created_{$taxonomy}", [ self::class, 'on_term_created' ] );
add_action( "edit_{$taxonomy}", [ self::class, 'on_term_edit' ] );
}
}
/**
* Add Thumbnail field to add form fields.
*/
public static function add_form_fields( $taxonomy ): void {
wp_nonce_field( 'wpex_term_thumbnail_meta_nonce', 'wpex_term_thumbnail_meta_nonce' );
self::enqueue_admin_scripts();
?>
taxonomy ?? '';
$term_id = $term->term_id ?? 0;
if ( ! $term_id || ! in_array( $taxonomy, self::supported_taxonomies() ) ) {
return;
}
// Options not needed for Woo.
if ( 'product_cat' !== $taxonomy ) :
// Get thumbnail.
$thumbnail_id = self::get_term_thumbnail_id( $term_id, false );
if ( $thumbnail_id ) {
$thumbnail_src = wp_get_attachment_image_src( $thumbnail_id, 'thumbnail', false );
$thumbnail_url = $thumbnail_src[0] ?? '';
}
self::enqueue_admin_scripts();
?>
|
|
|
|
',
''
); ?>
|
';
} else {
$columns .= '—';
}
}
return $columns;
}
/**
* Get term meta with fallback.
*/
private static function get_term_meta( $term_id = null, $key = '', $single = true ) {
if ( ! $term_id ) {
$term_id = get_queried_object()->term_id;
}
$value = '';
if ( $term_id ) {
$value = get_term_meta( $term_id, $key, $single );
if ( isset( $value ) ) {
return $value;
}
$term_data = get_option( 'wpex_term_data' );
$term_data = $term_data[ $term_id ] ?? '';
if ( $term_data && ! empty( $term_data[ $key ] ) ) {
return $term_data[ $key ];
}
}
return $value;
}
/**
* Check if the term page header should have a background image.
*/
public static function filter_page_header_style( $style ) {
if ( 'hidden' !== $style
&& self::is_tax_archive()
&& self::term_page_header_image_enabled()
&& self::get_term_thumbnail_id()
) {
$style = 'background-image';
}
return $style;
}
/**
* Filters the page header background image.
*/
public static function filter_page_header_bg( $image ) {
if ( self::is_tax_archive() && self::term_page_header_image_enabled() ) {
$term_thumbnail = self::get_term_thumbnail_id();
if ( $term_thumbnail ) {
$image_url = wp_get_attachment_image_url( $term_thumbnail, 'full' );
if ( $image_url ) {
$image = $image_url;
}
}
}
return $image;
}
/**
* Retrieve term thumbnail for admin panel.
*/
public static function get_term_thumbnail_id( $term_id = null, $apply_filters = true ) {
$thumbnail_id = '';
$term_id = $term_id ?: get_queried_object_id();
if ( $term_id ) {
if ( is_object( $term_id ) && is_a( $term_id, 'WP_Term' ) ) {
$term_id = $term_id->term_id;
}
$thumbnail_id = get_term_meta( $term_id, 'thumbnail_id', true );
// Check old options
if ( empty( $thumbnail_id ) ) {
$term_data = get_option( 'wpex_term_data' );
$term_data = $term_data[ $term_id ] ?? '';
if ( $term_data && ! empty( $term_data[ 'thumbnail' ] ) ) {
return $term_data[ 'thumbnail' ];
}
}
}
/**
* Filters the term thumbnail id.
*
* @param int $thumbnail_id
* @param int $term_id
*/
if ( $apply_filters ) {
$thumbnail_id = apply_filters( 'wpex_get_term_thumbnail_id', $thumbnail_id );
}
return $thumbnail_id;
}
/**
* Checks that the functionality is enabled.
*/
public static function page_header_image_enabled(): bool {
return (bool) apply_filters( 'wpex_enable_term_page_header_image', get_theme_mod( 'term_page_header_image_enable', true ) );
}
/**
* Check if on a tax archive.
*/
private static function is_tax_archive(): bool {
return ( ! is_search() && ( is_tax() || is_category() || is_tag() ) );
}
/**
* Check if the term page header image is enabled.
*/
private static function term_page_header_image_enabled(): bool {
return ( function_exists( 'wpex_term_page_header_image_enabled' )
&& wpex_term_page_header_image_enabled()
&& in_array( self::get_current_taxonomy(), self::supported_taxonomies() )
);
}
/**
* Returns the current taxonomy name.
*/
private static function get_current_taxonomy(): string {
if ( is_category() ) {
return 'category';
} elseif ( is_tag() ) {
return 'post_tag';
} else {
return (string) get_query_var( 'taxonomy' ) ?: '';
}
}
}