get_term_feed_link( int|WP_Term|object $term, string $taxonomy = '', string $feed = '' ): string|false

Description

Parameters

$termint|WP_Term|object

The ID or term object whose feed link will be retrieved.

$taxonomystringoptional

Taxonomy of $term_id.Default: ''

$feedstringoptional

Feed type. Possible values include 'rss2', 'atom'. Default is the value of get_default_feed().Default: ''

Return

string|false

Link to the feed for the term specified by $term and $taxonomy.

Hooks fired · 3

3 hooks fire while get_term_feed_link() runs, in this order:

1. 1
   apply_filters( category_feed_link )filterline 983 (+48 into the body)

   Filters the category feed link.

2. 2
   apply_filters( tag_feed_link )filterline 993 (+58 into the body)

   Filters the post tag feed link.

3. 3
   apply_filters( taxonomy_feed_link )filterline 1004 (+69 into the body)

   Filters the feed link for a taxonomy other than 'category' or 'post_tag'.

Uses · 10

• get_term()Gets all term data from database by term ID.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• get_default_feed()Retrieves the default feed.
• get_option()Retrieves an option value based on an option name.
• home_url()Retrieves the URL for the current site where the front end is accessible.
• get_taxonomy()Retrieves the taxonomy object of $taxonomy.
• get_term_link()Generates a permalink for a taxonomy term archive.
• trailingslashit()Appends a trailing slash.
• user_trailingslashit()Retrieves a trailing-slashed string if the site is set for adding trailing slashes.
• apply_filters()Calls the callback functions that have been added to a filter hook.

Used by · 4

• Walker_Category::start_el()Starts the element output.
• feed_links_extra()Displays the links to the extra feeds such as category feeds.
• get_category_feed_link()Retrieves the feed link for a category.
• get_tag_feed_link()Retrieves the permalink for a tag feed.

Source

View on Trac ↗View on GitHub ↗

935function get_term_feed_link( $term, $taxonomy = '', $feed = '' ) {936	if ( ! is_object( $term ) ) {937		$term = (int) $term;938	}939 940	$term = get_term( $term, $taxonomy );941 942	if ( empty( $term ) || is_wp_error( $term ) ) {943		return false;944	}945 946	$taxonomy = $term->taxonomy;947 948	if ( empty( $feed ) ) {949		$feed = get_default_feed();950	}951 952	$permalink_structure = get_option( 'permalink_structure' );953 954	if ( ! $permalink_structure ) {955		if ( 'category' === $taxonomy ) {956			$link = home_url( "?feed=$feed&cat=$term->term_id" );957		} elseif ( 'post_tag' === $taxonomy ) {958			$link = home_url( "?feed=$feed&tag=$term->slug" );959		} else {960			$t    = get_taxonomy( $taxonomy );961			$link = home_url( "?feed=$feed&$t->query_var=$term->slug" );962		}963	} else {964		$link = get_term_link( $term, $term->taxonomy );965		if ( get_default_feed() === $feed ) {966			$feed_link = 'feed';967		} else {968			$feed_link = "feed/$feed";969		}970 971		$link = trailingslashit( $link ) . user_trailingslashit( $feed_link, 'feed' );972	}973 974	if ( 'category' === $taxonomy ) {975		/**976		 * Filters the category feed link.977		 *978		 * @since 1.5.1979		 *980		 * @param string $link The category feed link.981		 * @param string $feed Feed type. Possible values include 'rss2', 'atom'.982		 */983		$link = apply_filters( 'category_feed_link', $link, $feed );984	} elseif ( 'post_tag' === $taxonomy ) {985		/**986		 * Filters the post tag feed link.987		 *988		 * @since 2.3.0989		 *990		 * @param string $link The tag feed link.991		 * @param string $feed Feed type. Possible values include 'rss2', 'atom'.992		 */993		$link = apply_filters( 'tag_feed_link', $link, $feed );994	} else {995		/**996		 * Filters the feed link for a taxonomy other than 'category' or 'post_tag'.997		 *998		 * @since 3.0.0999		 *1000		 * @param string $link     The taxonomy feed link.1001		 * @param string $feed     Feed type. Possible values include 'rss2', 'atom'.1002		 * @param string $taxonomy The taxonomy name.1003		 */1004		$link = apply_filters( 'taxonomy_feed_link', $link, $feed, $taxonomy );1005	}1006 1007	return $link;1008}

History

Introduced in 3.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/link-template.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.