feed_links_extra( array $args = array() )

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Parameters

$argsarrayoptional

Optional arguments.Default: array()

Performance profile

How much work a call to feed_links_extra() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Heavy

Reaches the database via get_post().

Scaling

Constant

No loop in the body: the same number of instructions runs whatever you pass in.

Instructions

63–126

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 338.

Plugin surface

9 hooks

Third-party callbacks on 'feed_links_extra_args', 'feed_links_show_comments_feed', 'feed_links_extra_show_post_comments_feed' run inside this call, and their cost is not bounded by anything here.

Called by

0

Nothing in core calls this; the cost is only what you spend yourself.

What it touches

• hookthird-party callbacksapply_filters()called directly
• querycontent queryget_post()one call below feed_links_extra()
• optionoption read or writeget_option()one call below feed_links_extra()

Further down the call graph this can also reach cache, serialize and transient. Those are the worst case, several calls deep and usually down an error path, not what a normal call pays.

What one call costs · 42 distinct outcomes

One number would be a lie: the work depends on which branch runs. These are every distinct cost feed_links_extra() can have, taken from its control-flow graph on PHP 8.5.

Hooks and filters fired · 9

9 hooks fire while feed_links_extra() runs, in this order:

1. 1
   apply_filters( feed_links_extra_args )filterline 3549 (+29 into the body)

   Filters the extra feed links arguments.

2. 2
   apply_filters( feed_links_show_comments_feed )filterline 3560 (+40 into the body)

   Filters whether to display the comments feed link.

3. 3
   apply_filters( feed_links_extra_show_post_comments_feed )filterline 3575 (+55 into the body)

   Filters whether to display the post comments feed link.

4. 4
   apply_filters( feed_links_extra_show_post_type_archive_feed )filterline 3604 (+84 into the body)

   Filters whether to display the post type archive feed link.

5. 5
   apply_filters( feed_links_extra_show_category_feed )filterline 3632 (+112 into the body)

   Filters whether to display the category feed link.

6. 6
   apply_filters( feed_links_extra_show_tag_feed )filterline 3656 (+136 into the body)

   Filters whether to display the tag feed link.

7. 7
   apply_filters( feed_links_extra_show_tax_feed )filterline 3680 (+160 into the body)

   Filters whether to display the custom taxonomy feed link.

8. 8
   apply_filters( feed_links_extra_show_author_feed )filterline 3707 (+187 into the body)

   Filters whether to display the author feed link.

9. 9
   apply_filters( feed_links_extra_show_search_feed )filterline 3729 (+209 into the body)

   Filters whether to display the search results feed link.

Uses · 31

• _x()Retrieves translated string with gettext context.
• __()Retrieves the translation of $text.
• wp_parse_args()Merges user defined arguments into defaults array.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_queried_object()Retrieves the currently queried object.
• is_singular()Determines whether the query is for an existing single post of any post type (post, attachment, page, custom post types).
• comments_open()Determines whether the current post is open for comments.
• pings_open()Determines whether the current post is open for pings.
• get_bloginfo()Retrieves information about the current site.
• the_title_attribute()Sanitizes the current title when retrieving or displaying.
• get_post_comments_feed_link()Retrieves the permalink for the post comments feed.
• is_post_type_archive()Determines whether the query is for an existing post type archive page.

Source code

View on Trac ↗View on GitHub ↗

3520function feed_links_extra( $args = array() ) {3521	$defaults = array(3522		/* translators: Separator between site name and feed type in feed links. */3523		'separator'     => _x( '»', 'feed link' ),3524		/* translators: 1: Site name, 2: Separator (raquo), 3: Post title. */3525		'singletitle'   => __( '%1$s %2$s %3$s Comments Feed' ),3526		/* translators: 1: Site name, 2: Separator (raquo), 3: Category name. */3527		'cattitle'      => __( '%1$s %2$s %3$s Category Feed' ),3528		/* translators: 1: Site name, 2: Separator (raquo), 3: Tag name. */3529		'tagtitle'      => __( '%1$s %2$s %3$s Tag Feed' ),3530		/* translators: 1: Site name, 2: Separator (raquo), 3: Term name, 4: Taxonomy singular name. */3531		'taxtitle'      => __( '%1$s %2$s %3$s %4$s Feed' ),3532		/* translators: 1: Site name, 2: Separator (raquo), 3: Author name. */3533		'authortitle'   => __( '%1$s %2$s Posts by %3$s Feed' ),3534		/* translators: 1: Site name, 2: Separator (raquo), 3: Search query. */3535		'searchtitle'   => __( '%1$s %2$s Search Results for “%3$s” Feed' ),3536		/* translators: 1: Site name, 2: Separator (raquo), 3: Post type name. */3537		'posttypetitle' => __( '%1$s %2$s %3$s Feed' ),3538	);3539 3540	$args = wp_parse_args( $args, $defaults );3541 3542	/**3543	 * Filters the extra feed links arguments.3544	 *3545	 * @since 6.7.03546	 *3547	 * @param array $args An array of extra feed links arguments.3548	 */3549	$args = apply_filters( 'feed_links_extra_args', $args );3550 3551	/*3552	 * The template conditionals are referring to the global query, so the queried object is used rather than3553	 * depending on a global $post being set.3554	 */3555	$queried_object = get_queried_object();3556	if ( is_singular() && $queried_object instanceof WP_Post ) {3557		$post = $queried_object;3558 3559		/** This filter is documented in wp-includes/general-template.php */3560		$show_comments_feed = apply_filters( 'feed_links_show_comments_feed', true );3561 3562		/**3563		 * Filters whether to display the post comments feed link.3564		 *3565		 * This filter allows to enable or disable the feed link for a singular post3566		 * in a way that is independent of {@see 'feed_links_show_comments_feed'}3567		 * (which controls the global comments feed). The result of that filter3568		 * is accepted as a parameter.3569		 *3570		 * @since 6.1.03571		 *3572		 * @param bool $show_comments_feed Whether to display the post comments feed link. Defaults to3573		 *                                 the {@see 'feed_links_show_comments_feed'} filter result.3574		 */3575		$show_post_comments_feed = apply_filters( 'feed_links_extra_show_post_comments_feed', $show_comments_feed );3576 3577		if ( $show_post_comments_feed && ( comments_open( $post ) || pings_open( $post ) || (int) $post->comment_count > 0 ) ) {3578			$title = sprintf(3579				$args['singletitle'],3580				get_bloginfo( 'name' ),3581				$args['separator'],3582				the_title_attribute(3583					array(3584						'echo' => false,3585						'post' => $post,3586					)3587				)3588			);3589 3590			$feed_link = get_post_comments_feed_link( $post->ID );3591 3592			if ( $feed_link ) {3593				$href = $feed_link;3594			}3595		}3596	} elseif ( is_post_type_archive() ) {3597		/**3598		 * Filters whether to display the post type archive feed link.3599		 *

Changelog

Introduced in 2.8.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.1.0 tag, from src/wp-includes/general-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.