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

Add fictioneer_filter_shortcode_terms_query_args filter

Browse Source
This commit is contained in:
Tetrakern 2025-01-08 00:02:01 +01:00
parent e3b17c898b
commit d1aee5e2ca
2 changed files with 32 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
FILTERS.md
View File

@ -1575,7 +1575,7 @@ Filters the WP_Query arguments in the `fictioneer_blog` shortcode.
* $posts_per_page (int) – `$args['posts_per_page']` * $posts_per_page (int) – `$args['posts_per_page']`
* $tax_query (array|null) – `fictioneer_get_shortcode_tax_query( $args )` * $tax_query (array|null) – `fictioneer_get_shortcode_tax_query( $args )`
**$attr:** **$args:**
* $posts_per_page (int) – The number of posts per page. Defaults to WordPress. * $posts_per_page (int) – The number of posts per page. Defaults to WordPress.
* $page (int) – Current main query page number. Default `1`. * $page (int) – Current main query page number. Default `1`.
* $ignore_sticky (boolean) – Optional. Whether to ignore sticky posts. Default `false`. * $ignore_sticky (boolean) – Optional. Whether to ignore sticky posts. Default `false`.
@ -1925,6 +1925,33 @@ Filters the WP_Query arguments in the `fictioneer_showcase` shortcode. The optio
--- ---
### `apply_filters( 'fictioneer_filter_shortcode_terms_query_args', $query_args, $attr )`
Filters the WP_Term_Query arguments in the `fictioneer_terms` shortcode.
**$query_args:**
* 'fictioneer_query_name' (string) – `'terms_shortcode'`
* 'taxonomy' (string) – As specified in the shortcode. Either `'category'`, `'post_tag'`, `'fcn_genre'`, `'fcn_fandom'`, `'fcn_character'`, or `'fcn_content_warning'`.
* 'orderby' (string) – As specified in the shortcode. Default `'count'`.
* 'order' (string) – As specified in the shortcode. Default `'desc'`.
* 'number' (int|null) – As specified in the shortcode. Default `null`.
* 'hide_empty' (bool) – As specified in the shortcode. Default `true`.
**$attr:**
* 'term_type' (string|null) – Either `'category'`, `'tag'`, `'genre'`, `'fandom'`, `'character'`, or `'warning'`. Default `'tag'`.
* 'post_id' (int|null) – Limit terms to a specific post. Default `0`.
* 'count' (int|null) – Limit number of queried terms. Default `-1` (all).
* 'orderby' (string|null) – Default `'count'`.
* 'order' (string|null) – Default `'desc'`.
* 'show_empty' (boolean|null) – Whether to query unused terms. Default `false`.
* 'show_count' (boolean|null) – Whether to show the term counts. Default `false`.
* 'classes' (string|null) – String of additional outer CSS classes. Default empty.
* 'inner_classes' (string|null) – String of additional inner CSS classes. Default empty.
* 'style' (string|null) – String of additional outer inline styles. Default empty.
* 'inner_style' (string|null) – String of additional inner inline styles. Default empty.
* 'empty' (string|null) – Override message for empty query result. Default empty.
---
### `apply_filters( 'fictioneer_filter_sitemap_page_template_excludes', $excludes )` ### `apply_filters( 'fictioneer_filter_sitemap_page_template_excludes', $excludes )`
Filters the exclusion array of page templates for the custom theme sitemap. By default, these are `'user-profile.php'`, `'singular-bookmarks.php'`, `'singular-bookshelf.php'`, and `'singular-bookshelf-ajax.php'`. Filters the exclusion array of page templates for the custom theme sitemap. By default, these are `'user-profile.php'`, `'singular-bookmarks.php'`, `'singular-bookshelf.php'`, and `'singular-bookshelf-ajax.php'`.

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

@ -2527,6 +2527,7 @@ function fictioneer_shortcode_terms( $attr ) {
// Prepare query args // Prepare query args
$args = array( $args = array(
'fictioneer_query_name' => 'terms_shortcode',
'taxonomy' => $term_type, 'taxonomy' => $term_type,
'orderby' => $orderby, 'orderby' => $orderby,
'order' => $order, 'order' => $order,
@ -2537,6 +2538,9 @@ function fictioneer_shortcode_terms( $attr ) {
$args['number'] = $count; $args['number'] = $count;
} }
// Apply filters
$args = apply_filters( 'fictioneer_filter_shortcode_terms_query_args', $args, $attr );
// Query terms // Query terms
if ( $post_id ) { if ( $post_id ) {
$terms = wp_get_post_terms( $post_id, $term_type, $args ); $terms = wp_get_post_terms( $post_id, $term_type, $args );