: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
// Generate the output links array.
foreach ( $tags_data as $key => $tag_data ) {
$class = $tag_data['class'] . ' tag-link-position-' . ( $key + 1 );
'<a href="%1$s"%2$s class="%3$s" style="font-size: %4$s;"%5$s>%6$s%7$s</a>',
esc_url( $tag_data['url'] ),
esc_attr( str_replace( ',', '.', $tag_data['font_size'] ) . $args['unit'] ),
esc_html( $tag_data['name'] ),
switch ( $args['format'] ) {
* Force role="list", as some browsers (sic: Safari 10) don't expose to assistive
* technologies the default role when the list is styled with `list-style: none`.
* Note: this is redundant but doesn't harm.
$return = "<ul class='wp-tag-cloud' role='list'>\n\t<li>";
$return .= implode( "</li>\n\t<li>", $a );
$return .= "</li>\n</ul>\n";
$return = implode( $args['separator'], $a );
* Filters the generated output of a tag cloud.
* The filter is only evaluated if a true value is passed
* to the $filter argument in wp_generate_tag_cloud().
* @see wp_generate_tag_cloud()
* @param string[]|string $return String containing the generated HTML tag cloud output
* or an array of tag links if the 'format' argument
* @param WP_Term[] $tags An array of terms used in the tag cloud.
* @param array $args An array of wp_generate_tag_cloud() arguments.
return apply_filters( 'wp_generate_tag_cloud', $return, $tags, $args );
* Serves as a callback for comparing objects based on name.
* @param object $a The first object to compare.
* @param object $b The second object to compare.
* @return int Negative number if `$a->name` is less than `$b->name`, zero if they are equal,
* or greater than zero if `$a->name` is greater than `$b->name`.
function _wp_object_name_sort_cb( $a, $b ) {
return strnatcasecmp( $a->name, $b->name );
* Serves as a callback for comparing objects based on count.
* @param object $a The first object to compare.
* @param object $b The second object to compare.
* @return int Negative number if `$a->count` is less than `$b->count`, zero if they are equal,
* or greater than zero if `$a->count` is greater than `$b->count`.
function _wp_object_count_sort_cb( $a, $b ) {
return ( $a->count - $b->count );
* Retrieves HTML list content for category list.
* @since 5.3.0 Formalized the existing `...$args` parameter by adding it
* to the function signature.
* @uses Walker_Category to create HTML list content.
* @see Walker::walk() for parameters and return description.
* @param mixed ...$args Elements array, maximum hierarchical depth and optional additional arguments.
function walk_category_tree( ...$args ) {
// The user's options are the third parameter.
if ( empty( $args[2]['walker'] ) || ! ( $args[2]['walker'] instanceof Walker ) ) {
$walker = new Walker_Category();
$walker = $args[2]['walker'];
return $walker->walk( ...$args );
* Retrieves HTML dropdown (select) content for category list.
* @since 5.3.0 Formalized the existing `...$args` parameter by adding it
* to the function signature.
* @uses Walker_CategoryDropdown to create HTML dropdown content.
* @see Walker::walk() for parameters and return description.
* @param mixed ...$args Elements array, maximum hierarchical depth and optional additional arguments.
function walk_category_dropdown_tree( ...$args ) {
// The user's options are the third parameter.
if ( empty( $args[2]['walker'] ) || ! ( $args[2]['walker'] instanceof Walker ) ) {
$walker = new Walker_CategoryDropdown();
$walker = $args[2]['walker'];
return $walker->walk( ...$args );
* Retrieves the link to the tag.
* @param int|object $tag Tag ID or object.
* @return string Link on success, empty string if tag does not exist.
function get_tag_link( $tag ) {
return get_category_link( $tag );
* Retrieves the tags for a post.
* @param int|WP_Post $post Post ID or object.
* @return WP_Term[]|false|WP_Error Array of WP_Term objects on success, false if there are no terms
* or the post does not exist, WP_Error on failure.
function get_the_tags( $post = 0 ) {
$terms = get_the_terms( $post, 'post_tag' );
* Filters the array of tags for the given post.
* @param WP_Term[]|false|WP_Error $terms Array of WP_Term objects on success, false if there are no terms
* or the post does not exist, WP_Error on failure.
return apply_filters( 'get_the_tags', $terms );
* Retrieves the tags for a post formatted as a string.
* @param string $before Optional. String to use before the tags. Default empty.
* @param string $sep Optional. String to use between the tags. Default empty.
* @param string $after Optional. String to use after the tags. Default empty.
* @param int $post_id Optional. Post ID. Defaults to the current post ID.
* @return string|false|WP_Error A list of tags on success, false if there are no terms,
function get_the_tag_list( $before = '', $sep = '', $after = '', $post_id = 0 ) {
$tag_list = get_the_term_list( $post_id, 'post_tag', $before, $sep, $after );
* Filters the tags list for a given post.
* @param string $tag_list List of tags.
* @param string $before String to use before the tags.
* @param string $sep String to use between the tags.
* @param string $after String to use after the tags.
* @param int $post_id Post ID.
return apply_filters( 'the_tags', $tag_list, $before, $sep, $after, $post_id );
* Displays the tags for a post.
* @param string $before Optional. String to use before the tags. Defaults to 'Tags:'.
* @param string $sep Optional. String to use between the tags. Default ', '.
* @param string $after Optional. String to use after the tags. Default empty.
function the_tags( $before = null, $sep = ', ', $after = '' ) {
if ( null === $before ) {
$before = __( 'Tags: ' );
$the_tags = get_the_tag_list( $before, $sep, $after );
if ( ! is_wp_error( $the_tags ) ) {
* Retrieves tag description.
* @param int $tag Optional. Tag ID. Defaults to the current tag ID.
* @return string Tag description, if available.
function tag_description( $tag = 0 ) {
return term_description( $tag );
* Retrieves term description.
* @since 4.9.2 The `$taxonomy` parameter was deprecated.
* @param int $term Optional. Term ID. Defaults to the current term ID.
* @param null $deprecated Deprecated. Not used.
* @return string Term description, if available.
function term_description( $term = 0, $deprecated = null ) {
if ( ! $term && ( is_tax() || is_tag() || is_category() ) ) {
$term = get_queried_object();
$description = get_term_field( 'description', $term );
return is_wp_error( $description ) ? '' : $description;
* Retrieves the terms of the taxonomy that are attached to the post.
* @param int|WP_Post $post Post ID or object.
* @param string $taxonomy Taxonomy name.
* @return WP_Term[]|false|WP_Error Array of WP_Term objects on success, false if there are no terms
* or the post does not exist, WP_Error on failure.
function get_the_terms( $post, $taxonomy ) {
$post = get_post( $post );
$terms = get_object_term_cache( $post->ID, $taxonomy );
if ( false === $terms ) {
$terms = wp_get_object_terms( $post->ID, $taxonomy );
if ( ! is_wp_error( $terms ) ) {
$term_ids = wp_list_pluck( $terms, 'term_id' );
wp_cache_add( $post->ID, $term_ids, $taxonomy . '_relationships' );
* Filters the list of terms attached to the given post.
* @param WP_Term[]|WP_Error $terms Array of attached terms, or WP_Error on failure.
* @param int $post_id Post ID.
* @param string $taxonomy Name of the taxonomy.
$terms = apply_filters( 'get_the_terms', $terms, $post->ID, $taxonomy );
* Retrieves a post's terms as a list with specified format.
* Terms are linked to their respective term listing pages.
* @param int $post_id Post ID.
* @param string $taxonomy Taxonomy name.
* @param string $before Optional. String to use before the terms. Default empty.
* @param string $sep Optional. String to use between the terms. Default empty.
* @param string $after Optional. String to use after the terms. Default empty.
* @return string|false|WP_Error A list of terms on success, false if there are no terms,
function get_the_term_list( $post_id, $taxonomy, $before = '', $sep = '', $after = '' ) {
$terms = get_the_terms( $post_id, $taxonomy );
if ( is_wp_error( $terms ) ) {
foreach ( $terms as $term ) {
$link = get_term_link( $term, $taxonomy );
if ( is_wp_error( $link ) ) {
$links[] = '<a href="' . esc_url( $link ) . '" rel="tag">' . $term->name . '</a>';
* Filters the term links for a given taxonomy.
* The dynamic portion of the hook name, `$taxonomy`, refers
* Possible hook names include:
* - `term_links-category`
* - `term_links-post_tag`
* - `term_links-post_format`
* @param string[] $links An array of term links.
$term_links = apply_filters( "term_links-{$taxonomy}", $links ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
return $before . implode( $sep, $term_links ) . $after;
* Retrieves term parents with separator.
* @param int $term_id Term ID.
* @param string $taxonomy Taxonomy name.
* @param string|array $args {
* Array of optional arguments.
* @type string $format Use term names or slugs for display. Accepts 'name' or 'slug'.
* @type string $separator Separator for between the terms. Default '/'.
* @type bool $link Whether to format as a link. Default true.
* @type bool $inclusive Include the term to get the parents for. Default true.
* @return string|WP_Error A list of term parents on success, WP_Error or empty string on failure.
function get_term_parents_list( $term_id, $taxonomy, $args = array() ) {
$term = get_term( $term_id, $taxonomy );
if ( is_wp_error( $term ) ) {
$term_id = $term->term_id;
$args = wp_parse_args( $args, $defaults );
foreach ( array( 'link', 'inclusive' ) as $bool ) {
$args[ $bool ] = wp_validate_boolean( $args[ $bool ] );
$parents = get_ancestors( $term_id, $taxonomy, 'taxonomy' );
if ( $args['inclusive'] ) {
array_unshift( $parents, $term_id );
foreach ( array_reverse( $parents ) as $term_id ) {
$parent = get_term( $term_id, $taxonomy );
$name = ( 'slug' === $args['format'] ) ? $parent->slug : $parent->name;
$list .= '<a href="' . esc_url( get_term_link( $parent->term_id, $taxonomy ) ) . '">' . $name . '</a>' . $args['separator'];
$list .= $name . $args['separator'];
* Displays the terms for a post in a list.
* @param int $post_id Post ID.
* @param string $taxonomy Taxonomy name.
* @param string $before Optional. String to use before the terms. Default empty.
* @param string $sep Optional. String to use between the terms. Default ', '.
* @param string $after Optional. String to use after the terms. Default empty.
* @return void|false Void on success, false on failure.
function the_terms( $post_id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
$term_list = get_the_term_list( $post_id, $taxonomy, $before, $sep, $after );
if ( is_wp_error( $term_list ) ) {
* Filters the list of terms to display.
* @param string $term_list List of terms to display.
* @param string $taxonomy The taxonomy name.
* @param string $before String to use before the terms.
* @param string $sep String to use between the terms.
* @param string $after String to use after the terms.
echo apply_filters( 'the_terms', $term_list, $taxonomy, $before, $sep, $after );
* Checks if the current post has any of given category.
* The given categories are checked against the post's categories' term_ids, names and slugs.
* Categories given as integers will only be checked against the post's categories' term_ids.
* If no categories are given, determines if post has any categories.
* @param string|int|array $category Optional. The category name/term_id/slug,
* or an array of them to check for. Default empty.
* @param int|WP_Post $post Optional. Post to check. Defaults to the current post.
* @return bool True if the current post has any of the given categories
* (or any category, if no category specified). False otherwise.
function has_category( $category = '', $post = null ) {
return has_term( $category, 'category', $post );
* Checks if the current post has any of given tags.
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
