get_boundary_post()
最后更新于:2021-11-26 06:44:20
get_boundary_post( bool$in_same_term=false, int[]|string$excluded_terms=”, bool$start=true, string$taxonomy=’category’)Retrieves the boundary post.
参数
- $in_same_term
-
(bool) (Optional) Whether returned post should be in a same taxonomy term.
Default value: false
- $excluded_terms
-
(int[]|string) (Optional) Array or comma-separated list of excluded term IDs.
Default value: ”
- $start
-
(bool) (Optional) Whether to retrieve first or last post. Default true
Default value: true
- $taxonomy
-
(string) (Optional) Taxonomy, if $in_same_term is true.
Default value: ‘category’
响应
(null|array) Array containing the boundary post object if successful, null otherwise.
源文件
文件: gc-includes/link-template.php
function get_boundary_post( $in_same_term = false, $excluded_terms = '', $start = true, $taxonomy = 'category' ) {
$post = get_post();
if ( ! $post || ! is_single() || is_attachment() || ! taxonomy_exists( $taxonomy ) ) {
return null;
}
$query_args = array(
'posts_per_page' => 1,
'order' => $start ? 'ASC' : 'DESC',
'update_post_term_cache' => false,
'update_post_meta_cache' => false,
);
$term_array = array();
if ( ! is_array( $excluded_terms ) ) {
if ( ! empty( $excluded_terms ) ) {
$excluded_terms = explode( ',', $excluded_terms );
} else {
$excluded_terms = array();
}
}
if ( $in_same_term || ! empty( $excluded_terms ) ) {
if ( $in_same_term ) {
$term_array = gc_get_object_terms( $post->ID, $taxonomy, array( 'fields' => 'ids' ) );
}
if ( ! empty( $excluded_terms ) ) {
$excluded_terms = array_map( 'intval', $excluded_terms );
$excluded_terms = array_diff( $excluded_terms, $term_array );
$inverse_terms = array();
foreach ( $excluded_terms as $excluded_term ) {
$inverse_terms[] = $excluded_term * -1;
}
$excluded_terms = $inverse_terms;
}
$query_args['tax_query'] = array(
array(
'taxonomy' => $taxonomy,
'terms' => array_merge( $term_array, $excluded_terms ),
),
);
}
return get_posts( $query_args );
}