fictioneer/partials/_showcase.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 fictioneer_get_splide_loading_style( $splide, $args['uid'] );
        echo fictioneer_get_splide_placeholders( $args['uid'] );
        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(); ?>