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

60–121

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

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()called directly
• 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 3328 (+29 into the body)

   Filters the extra feed links arguments.

2. 2
   apply_filters( feed_links_show_comments_feed )filterline 3335 (+36 into the body)

   Filters whether to display the comments feed link.

3. 3
   apply_filters( feed_links_extra_show_post_comments_feed )filterline 3350 (+51 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 3374 (+75 into the body)

   Filters whether to display the post type archive feed link.

5. 5
   apply_filters( feed_links_extra_show_category_feed )filterline 3402 (+103 into the body)

   Filters whether to display the category feed link.

6. 6
   apply_filters( feed_links_extra_show_tag_feed )filterline 3426 (+127 into the body)

   Filters whether to display the tag feed link.

7. 7
   apply_filters( feed_links_extra_show_tax_feed )filterline 3450 (+151 into the body)

   Filters whether to display the custom taxonomy feed link.

8. 8
   apply_filters( feed_links_extra_show_author_feed )filterline 3477 (+178 into the body)

   Filters whether to display the author feed link.

9. 9
   apply_filters( feed_links_extra_show_search_feed )filterline 3499 (+200 into the body)

   Filters whether to display the search results feed link.

Uses · 32

• _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.
• is_singular()Determines whether the query is for an existing single post of any post type (post, attachment, page, custom post types).
• get_post()Retrieves post data given a post ID or post object.
• 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 ↗

3299function feed_links_extra( $args = array() ) {3300	$defaults = array(3301		/* translators: Separator between site name and feed type in feed links. */3302		'separator'     => _x( '»', 'feed link' ),3303		/* translators: 1: Site name, 2: Separator (raquo), 3: Post title. */3304		'singletitle'   => __( '%1$s %2$s %3$s Comments Feed' ),3305		/* translators: 1: Site name, 2: Separator (raquo), 3: Category name. */3306		'cattitle'      => __( '%1$s %2$s %3$s Category Feed' ),3307		/* translators: 1: Site name, 2: Separator (raquo), 3: Tag name. */3308		'tagtitle'      => __( '%1$s %2$s %3$s Tag Feed' ),3309		/* translators: 1: Site name, 2: Separator (raquo), 3: Term name, 4: Taxonomy singular name. */3310		'taxtitle'      => __( '%1$s %2$s %3$s %4$s Feed' ),3311		/* translators: 1: Site name, 2: Separator (raquo), 3: Author name. */3312		'authortitle'   => __( '%1$s %2$s Posts by %3$s Feed' ),3313		/* translators: 1: Site name, 2: Separator (raquo), 3: Search query. */3314		'searchtitle'   => __( '%1$s %2$s Search Results for “%3$s” Feed' ),3315		/* translators: 1: Site name, 2: Separator (raquo), 3: Post type name. */3316		'posttypetitle' => __( '%1$s %2$s %3$s Feed' ),3317	);3318 3319	$args = wp_parse_args( $args, $defaults );3320 3321	/**3322	 * Filters the extra feed links arguments.3323	 *3324	 * @since 6.7.03325	 *3326	 * @param array $args An array of extra feed links arguments.3327	 */3328	$args = apply_filters( 'feed_links_extra_args', $args );3329 3330	if ( is_singular() ) {3331		$id   = 0;3332		$post = get_post( $id );3333 3334		/** This filter is documented in wp-includes/general-template.php */3335		$show_comments_feed = apply_filters( 'feed_links_show_comments_feed', true );3336 3337		/**3338		 * Filters whether to display the post comments feed link.3339		 *3340		 * This filter allows to enable or disable the feed link for a singular post3341		 * in a way that is independent of {@see 'feed_links_show_comments_feed'}3342		 * (which controls the global comments feed). The result of that filter3343		 * is accepted as a parameter.3344		 *3345		 * @since 6.1.03346		 *3347		 * @param bool $show_comments_feed Whether to display the post comments feed link. Defaults to3348		 *                                 the {@see 'feed_links_show_comments_feed'} filter result.3349		 */3350		$show_post_comments_feed = apply_filters( 'feed_links_extra_show_post_comments_feed', $show_comments_feed );3351 3352		if ( $show_post_comments_feed && ( comments_open() || pings_open() || $post->comment_count > 0 ) ) {3353			$title = sprintf(3354				$args['singletitle'],3355				get_bloginfo( 'name' ),3356				$args['separator'],3357				the_title_attribute( array( 'echo' => false ) )3358			);3359 3360			$feed_link = get_post_comments_feed_link( $post->ID );3361 3362			if ( $feed_link ) {3363				$href = $feed_link;3364			}3365		}3366	} elseif ( is_post_type_archive() ) {3367		/**3368		 * Filters whether to display the post type archive feed link.3369		 *3370		 * @since 6.1.03371		 *3372		 * @param bool $show Whether to display the post type archive feed link. Default true.3373		 */3374		$show_post_type_archive_feed = apply_filters( 'feed_links_extra_show_post_type_archive_feed', true );3375 3376		if ( $show_post_type_archive_feed ) {3377			$post_type = get_query_var( 'post_type' );3378

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 6.8.8 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.