malhuda/fictioneer
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases 112 Wiki Activity

Add footer_* params to Article Cards shortcode

Browse Source
This commit is contained in:
Tetrakern 2024-08-18 22:39:22 +02:00
parent 9df2c35bfc
commit 8935606d0c
3 changed files with 50 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
DOCUMENTATION.md
View File

@ -831,6 +831,10 @@ Renders a multi-column grid of paginated medium cards ordered by publishing date
* **seamless:** Whether to remove the gap between the image and frame. Default `false` (Customizer setting).
* **thumbnail:** Whether to show the thumbnail/cover image. Default `true` (Customizer setting).
* **lightbox:** Whether clicking on the thumbnail/cover image opens the lightbox or post link. Default `true`.
* **footer:** Whether to show the footer (if any). Default `true`.
* **footer_author:** Whether to show the post author. Default `true`.
* **footer_date:** Whether to show the post date. Default `true`.
* **footer_comments:** Whether to show the post comment count. Default `true`.
* **aspect_ratio:** CSS [aspect-ratio](https://developer.mozilla.org/en-US/docs/Web/CSS/aspect-ratio) value for the image (X/Y). Default `3/1`.
* **class:** Additional CSS classes, separated by whitespace.

2
includes/functions/_setup-shortcodes.php
View File

@ -203,6 +203,8 @@ function fictioneer_get_default_shortcode_args( $attr, $def_count = -1 ) {
'lightbox' => filter_var( $attr['lightbox'] ?? 1, FILTER_VALIDATE_BOOLEAN ),
'words' => filter_var( $attr['words'] ?? 1, FILTER_VALIDATE_BOOLEAN ),
'date' => filter_var( $attr['date'] ?? 1, FILTER_VALIDATE_BOOLEAN ),
'footer' => filter_var( $attr['footer'] ?? 1, FILTER_VALIDATE_BOOLEAN ),
'footer_author' => filter_var( $attr['footer_author'] ?? 1, FILTER_VALIDATE_BOOLEAN ),
'footer_chapters' => filter_var( $attr['footer_chapters'] ?? 1, FILTER_VALIDATE_BOOLEAN ),
'footer_words' => filter_var( $attr['footer_words'] ?? 1, FILTER_VALIDATE_BOOLEAN ),
'footer_date' => filter_var( $attr['footer_date'] ?? 1, FILTER_VALIDATE_BOOLEAN ),

27
partials/_article-cards.php
View File

@ -25,6 +25,9 @@
* @internal $args['relation'] Relationship between taxonomies. Default 'AND'.
* @internal $args['lightbox'] Whether the image is opened in the lightbox. Default true.
* @internal $args['thumbnail'] Whether the image is rendered. Default true.
* @internal $args['footer_author'] Whether to show the post author. Default true.
* @internal $args['footer_date'] Whether to show the post date. Default true.
* @internal $args['footer_comments'] Whether to show the post comment count. Default true.
* @internal $args['classes'] String of additional CSS classes. Default empty.
*/
@ -148,6 +151,22 @@ $pag_args = array(
$card_classes[] = '_seamless';
}
if ( ! $args['footer'] ) {
$card_classes[] = '_no-footer';
}
if ( ! $args['footer_author'] ) {
$card_classes[] = '_no-footer-author';
}
if ( ! $args['footer_date'] ) {
$card_classes[] = '_no-footer-date';
}
if ( ! $args['footer_comments'] ) {
$card_classes[] = '_no-footer-comments';
}
// Card attributes
$attributes = [];
@ -239,22 +258,27 @@ $pag_args = array(
</div>
<?php endif; ?>
<?php if ( $args['footer'] ) : ?>
<div class="card__footer cell-footer _article _small">
<div class="card__footer-box text-overflow-ellipsis"><?php
// Build footer items
$footer_items = [];
if ( get_option( 'fictioneer_show_authors' ) ) {
if ( $args['footer_author'] && get_option( 'fictioneer_show_authors' ) ) {
$footer_items['author'] = '<span class="card__footer-author"><i class="card-footer-icon fa-solid fa-circle-user"></i> ' . fictioneer_get_author_node( get_the_author_meta( 'ID' ) ) . '</span>';
}
if ( $args['footer_date'] ) {
if ( $args['orderby'] === 'modified' ) {
$footer_items['modified_date'] = '<span class="card__footer-modified-date"><i class="card-footer-icon fa-regular fa-clock" title="' . esc_attr__( 'Last Updated', 'fictioneer' ) . '"></i> ' . get_the_modified_date( FICTIONEER_CARD_ARTICLE_FOOTER_DATE, $post ) . '</span>';
} else {
$footer_items['publish_date'] = '<span class="card__footer-publish-date"><i class="card-footer-icon fa-solid fa-clock" title="' . esc_attr__( 'Published', 'fictioneer' ) .'"></i> ' . get_the_date( FICTIONEER_CARD_ARTICLE_FOOTER_DATE ) . '</span>';
}
}
if ( $args['footer_comments'] ) {
$footer_items['comments'] = '<span class="card__footer-comments"><i class="card-footer-icon fa-solid fa-message" title="' . esc_attr__( 'Comments', 'fictioneer' ) . '"></i> ' . get_comments_number( $post ) . '</span>';
}
// Filter footer items
$footer_items = apply_filters( 'fictioneer_filter_shortcode_article_card_footer', $footer_items, $post );
@ -263,6 +287,7 @@ $pag_args = array(
echo implode( ' ', $footer_items );
?></div>
</div>
<?php endif; ?>
</div>