226 lines
8.2 KiB
PHP
226 lines
8.2 KiB
PHP
<?php
|
|
/**
|
|
* Partial: Showcase
|
|
*
|
|
* This template part renders a showcase of posts and can be called with the
|
|
* [fictioneer_showcase for="post_type" count order orderby author post_ids]
|
|
* shortcode. Posts are displayed as grid with a maximum of three columns,
|
|
* collapsing to one on mobile.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Fictioneer
|
|
* @since 4.0.0
|
|
*
|
|
* @internal $args['uid'] Unique ID of the shortcode. Pattern: shortcode-id-{id}.
|
|
* @internal $args['post_type'] Post type if the showcase.
|
|
* @internal $args['count'] Maximum number of items. Default 8.
|
|
* @internal $args['order'] Order direction. Default 'DESC'.
|
|
* @internal $args['orderby'] Order argument. Default 'date'.
|
|
* @internal $args['author'] Author provided by the shortcode.
|
|
* @internal $args['post_ids'] Array of post IDs. Default empty.
|
|
* @internal $args['author_ids'] Array of author IDs. Default empty.
|
|
* @internal $args['excluded_authors'] Array of author IDs to exclude. Default empty.
|
|
* @internal $args['excluded_cats'] Array of category IDs to exclude. Default empty.
|
|
* @internal $args['excluded_tags'] Array of tag IDs to exclude. Default empty.
|
|
* @internal $args['ignore_protected'] Whether to ignore protected posts. Default false.
|
|
* @internal $args['only_protected'] Whether to query only protected posts. Default false.
|
|
* @internal $args['taxonomies'] Array of taxonomy arrays. Default empty.
|
|
* @internal $args['relation'] Relationship between taxonomies.
|
|
* @internal $args['classes'] String of additional CSS classes. Default empty.
|
|
* @internal $args['splide'] Configuration JSON for the Splide slider. Default empty.
|
|
* @internal $args['aspect_ratio'] Aspect ratio of the item.
|
|
* @internal $args['height'] Override the item height. Default empty.
|
|
* @internal $args['min_width'] Override the item minimum width. Default empty.
|
|
* @internal $args['aspect_ratio'] Aspect ratio of the item. Default empty.
|
|
* @internal $args['quality'] Size of the images. Default 'medium'.
|
|
*/
|
|
|
|
|
|
// No direct access!
|
|
defined( 'ABSPATH' ) OR exit;
|
|
|
|
// Setup
|
|
$splide = $args['splide'] ?? 0;
|
|
|
|
// Prepare query
|
|
$query_args = array (
|
|
'fictioneer_query_name' => 'showcase',
|
|
'post_type' => $args['post_type'],
|
|
'post_status' => 'publish',
|
|
'post__in' => $args['post_ids'], // May be empty!
|
|
'order' => $args['order'],
|
|
'orderby' => $args['orderby'],
|
|
'posts_per_page' => $args['count'],
|
|
'update_post_term_cache' => false,
|
|
'no_found_rows' => true
|
|
);
|
|
|
|
// Author?
|
|
if ( ! empty( $args['author'] ) ) {
|
|
$query_args['author_name'] = $args['author'];
|
|
}
|
|
|
|
// Author IDs?
|
|
if ( ! empty( $args['author_ids'] ) ) {
|
|
$query_args['author__in'] = $args['author_ids'];
|
|
}
|
|
|
|
// Taxonomies?
|
|
if ( ! empty( $args['taxonomies'] ) ) {
|
|
$query_args['tax_query'] = fictioneer_get_shortcode_tax_query( $args );
|
|
}
|
|
|
|
// Excluded tags?
|
|
if ( ! empty( $args['excluded_tags'] ) ) {
|
|
$query_args['tag__not_in'] = $args['excluded_tags'];
|
|
}
|
|
|
|
// Excluded categories?
|
|
if ( ! empty( $args['excluded_cats'] ) ) {
|
|
$query_args['category__not_in'] = $args['excluded_cats'];
|
|
}
|
|
|
|
// Excluded authors?
|
|
if ( ! empty( $args['excluded_authors'] ) ) {
|
|
$query_args['author__not_in'] = $args['excluded_authors'];
|
|
}
|
|
|
|
// Ignore protected?
|
|
if ( $args['ignore_protected'] ) {
|
|
$query_args['has_password'] = false;
|
|
}
|
|
|
|
// Only protected?
|
|
if ( $args['only_protected'] ) {
|
|
$query_args['has_password'] = true;
|
|
}
|
|
|
|
// Apply filters
|
|
$query_args = apply_filters( 'fictioneer_filter_shortcode_showcase_query_args', $query_args, $args );
|
|
|
|
// Query collections
|
|
$query = fictioneer_shortcode_query( $query_args );
|
|
|
|
// Extra attributes
|
|
$attributes = [];
|
|
|
|
if ( $splide ) {
|
|
$attributes[] = "data-splide='{$splide}'";
|
|
}
|
|
|
|
if ( $args['min_width'] ) {
|
|
$attributes[] .= "style='--showcase-item-min-width: {$args['min_width']};'";
|
|
$args['classes'] .= ' _custom-min-width';
|
|
}
|
|
|
|
?>
|
|
|
|
<?php if ( $query->have_posts() ) : ?>
|
|
<section class="showcase container-inline-size <?php echo $args['classes']; ?>" <?php echo implode( ' ', $attributes ); ?>>
|
|
<?php
|
|
if ( $args['splide'] === false ) {
|
|
echo '<div class="shortcode-json-invalid">' . __( 'Splide JSON is invalid and has been ignored.', 'fictioneer' ) . '</div>';
|
|
}
|
|
|
|
if ( $splide ) {
|
|
echo '<div class="splide__track">';
|
|
}
|
|
|
|
// Classes
|
|
$classes = '';
|
|
|
|
if ( $args['aspect_ratio'] ) {
|
|
$classes .= ' _aspect-ratio';
|
|
}
|
|
|
|
if ( $args['height'] ) {
|
|
$classes .= ' _custom-height';
|
|
}
|
|
|
|
if ( $splide ) {
|
|
$classes .= ' splide__slide';
|
|
}
|
|
|
|
// Style attribute
|
|
$style = '';
|
|
|
|
if ( $args['aspect_ratio'] ) {
|
|
$style .= "--showcase-item-aspect-ratio: {$args['aspect_ratio']};";
|
|
}
|
|
|
|
if ( $args['height'] ) {
|
|
$style .= "--showcase-item-height: {$args['height']};";
|
|
}
|
|
|
|
if ( ! empty( $style ) ) {
|
|
$style = "style='{$style}'";
|
|
}
|
|
?>
|
|
|
|
<ul class="showcase__list <?php if ( $splide ) { echo 'splide__list'; } ?>">
|
|
<?php while ( $query->have_posts() ) : $query->the_post(); ?>
|
|
<li class="showcase__list-item <?php echo $classes; ?>" data-post-id="<?php echo $post->ID; ?>" <?php echo $style; ?>>
|
|
<a class="showcase__list-item-link polygon" href="<?php the_permalink(); ?>">
|
|
<figure class="showcase__list-item-figure">
|
|
<?php
|
|
// Setup
|
|
$post_id = $post->ID;
|
|
$list_title = '';
|
|
$story_id = null;
|
|
$landscape_image_id = get_post_meta( $post_id, 'fictioneer_landscape_image', true );
|
|
|
|
// Get list title and story ID (if any)
|
|
switch ( $args['post_type'] ) {
|
|
case 'fcn_collection':
|
|
$list_title = get_post_meta( $post_id, 'fictioneer_collection_list_title', true );
|
|
break;
|
|
case 'fcn_chapter':
|
|
$list_title = get_post_meta( $post_id, 'fictioneer_chapter_list_title', true );
|
|
$story_id = get_post_meta( $post_id, 'fictioneer_chapter_story', true );
|
|
|
|
if ( empty( $landscape_image_id ) ) {
|
|
$landscape_image_id = get_post_meta( $story_id, 'fictioneer_landscape_image', true );
|
|
}
|
|
|
|
break;
|
|
}
|
|
|
|
// Prepare titles
|
|
$list_title = trim( wp_strip_all_tags( $list_title ) );
|
|
$title = empty( $list_title ) ? fictioneer_get_safe_title( $post_id, 'shortcode-showcase' ) : $list_title;
|
|
|
|
// Prepare image arguments
|
|
$image_args = array(
|
|
'alt' => sprintf( __( '%s Cover', 'fictioneer' ), $title ),
|
|
'class' => 'no-auto-lightbox showcase__image'
|
|
);
|
|
|
|
// Output image or placeholder
|
|
$ratio = fictioneer_get_split_aspect_ratio( $args['aspect_ratio'] ?: '4/2' );
|
|
$quality = $args['quality'] ?? 'medium';
|
|
|
|
if ( ! empty( $landscape_image_id ) && $ratio[0] - $ratio[1] > 1 ) {
|
|
echo wp_get_attachment_image( $landscape_image_id, $quality, false, $image_args );
|
|
} elseif ( has_post_thumbnail() ) {
|
|
the_post_thumbnail( $quality, $image_args );
|
|
} elseif ( $story_id && has_post_thumbnail( $story_id ) ) {
|
|
echo get_the_post_thumbnail( $story_id, $quality, $image_args );
|
|
} elseif ( $default_cover_id = get_theme_mod( 'default_story_cover', 0 ) ) {
|
|
echo wp_get_attachment_image( $default_cover_id, $quality, false, $image_args );
|
|
} else {
|
|
echo '<div class="showcase__image _no-cover"></div>';
|
|
}
|
|
?>
|
|
<?php if ( ! $args['no_cap'] ) : ?>
|
|
<figcaption class="showcase__list-item-figcaption"><?php echo $title; ?></figcaption>
|
|
<?php endif; ?>
|
|
</figure>
|
|
</a>
|
|
</li>
|
|
<?php endwhile; ?>
|
|
</ul>
|
|
|
|
<?php if ( $splide ) { echo '</div>'; } ?>
|
|
</section>
|
|
<?php endif; wp_reset_postdata(); ?>
|