get_term_feed_link() WordPress Function
The get_term_feed_link() function is used to retrieve the feed link for a given term. This function is useful for retrieving the feed link for a custom taxonomy term, or for any other taxonomy term. The function accepts two parameters: the term object, and the taxonomy name. The function returns the feed link for the given term.
get_term_feed_link( int|WP_Term|object $term, string $taxonomy = '', string $feed = '' ) #
Retrieves the feed link for a term.
Description
Returns a link to the feed for all posts in a given term. A specific feed can be requested or left blank to get the default feed.
Parameters
- $term
(int|WP_Term|object)(Required)The ID or term object whose feed link will be retrieved.
- $taxonomy
(string)(Optional) Taxonomy of
$term_id
.Default value: ''
- $feed
(string)(Optional) Feed type. Possible values include 'rss2', 'atom'. Default is the value of get_default_feed().
Default value: ''
Return
(string|false) Link to the feed for the term specified by $term
and $taxonomy
.
Source
File: wp-includes/link-template.php
function get_term_feed_link( $term, $taxonomy = '', $feed = '' ) { if ( ! is_object( $term ) ) { $term = (int) $term; } $term = get_term( $term, $taxonomy ); if ( empty( $term ) || is_wp_error( $term ) ) { return false; } $taxonomy = $term->taxonomy; if ( empty( $feed ) ) { $feed = get_default_feed(); } $permalink_structure = get_option( 'permalink_structure' ); if ( ! $permalink_structure ) { if ( 'category' === $taxonomy ) { $link = home_url( "?feed=$feed&cat=$term->term_id" ); } elseif ( 'post_tag' === $taxonomy ) { $link = home_url( "?feed=$feed&tag=$term->slug" ); } else { $t = get_taxonomy( $taxonomy ); $link = home_url( "?feed=$feed&$t->query_var=$term->slug" ); } } else { $link = get_term_link( $term, $term->taxonomy ); if ( get_default_feed() == $feed ) { $feed_link = 'feed'; } else { $feed_link = "feed/$feed"; } $link = trailingslashit( $link ) . user_trailingslashit( $feed_link, 'feed' ); } if ( 'category' === $taxonomy ) { /** * Filters the category feed link. * * @since 1.5.1 * * @param string $link The category feed link. * @param string $feed Feed type. Possible values include 'rss2', 'atom'. */ $link = apply_filters( 'category_feed_link', $link, $feed ); } elseif ( 'post_tag' === $taxonomy ) { /** * Filters the post tag feed link. * * @since 2.3.0 * * @param string $link The tag feed link. * @param string $feed Feed type. Possible values include 'rss2', 'atom'. */ $link = apply_filters( 'tag_feed_link', $link, $feed ); } else { /** * Filters the feed link for a taxonomy other than 'category' or 'post_tag'. * * @since 3.0.0 * * @param string $link The taxonomy feed link. * @param string $feed Feed type. Possible values include 'rss2', 'atom'. * @param string $taxonomy The taxonomy name. */ $link = apply_filters( 'taxonomy_feed_link', $link, $feed, $taxonomy ); } return $link; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
3.0.0 | Introduced. |