W3cubDocs

/WordPress

feed_links_extra( array $args = array() )

Display the links to the extra feeds such as category feeds.

Parameters

$args

(array) (Optional) arguments.

Default value: array()

Source

File: wp-includes/general-template.php 

function feed_links_extra( $args = array() ) {
	$defaults = array(
		/* translators: Separator between blog name and feed type in feed links. */
		'separator'     => _x( '»', 'feed link' ),
		/* translators: 1: Blog name, 2: Separator (raquo), 3: Post title. */
		'singletitle'   => __( '%1$s %2$s %3$s Comments Feed' ),
		/* translators: 1: Blog name, 2: Separator (raquo), 3: Category name. */
		'cattitle'      => __( '%1$s %2$s %3$s Category Feed' ),
		/* translators: 1: Blog name, 2: Separator (raquo), 3: Tag name. */
		'tagtitle'      => __( '%1$s %2$s %3$s Tag Feed' ),
		/* translators: 1: Blog name, 2: Separator (raquo), 3: Term name, 4: Taxonomy singular name. */
		'taxtitle'      => __( '%1$s %2$s %3$s %4$s Feed' ),
		/* translators: 1: Blog name, 2: Separator (raquo), 3: Author name. */
		'authortitle'   => __( '%1$s %2$s Posts by %3$s Feed' ),
		/* translators: 1: Blog name, 2: Separator (raquo), 3: Search query. */
		'searchtitle'   => __( '%1$s %2$s Search Results for “%3$s” Feed' ),
		/* translators: 1: Blog name, 2: Separator (raquo), 3: Post type name. */
		'posttypetitle' => __( '%1$s %2$s %3$s Feed' ),
	);

	$args = wp_parse_args( $args, $defaults );

	if ( is_singular() ) {
		$id   = 0;
		$post = get_post( $id );

		if ( comments_open() || pings_open() || $post->comment_count > 0 ) {
			$title = sprintf( $args['singletitle'], get_bloginfo( 'name' ), $args['separator'], the_title_attribute( array( 'echo' => false ) ) );
			$href  = get_post_comments_feed_link( $post->ID );
		}
	} elseif ( is_post_type_archive() ) {
		$post_type = get_query_var( 'post_type' );
		if ( is_array( $post_type ) ) {
			$post_type = reset( $post_type );
		}

		$post_type_obj = get_post_type_object( $post_type );
		$title         = sprintf( $args['posttypetitle'], get_bloginfo( 'name' ), $args['separator'], $post_type_obj->labels->name );
		$href          = get_post_type_archive_feed_link( $post_type_obj->name );
	} elseif ( is_category() ) {
		$term = get_queried_object();

		if ( $term ) {
			$title = sprintf( $args['cattitle'], get_bloginfo( 'name' ), $args['separator'], $term->name );
			$href  = get_category_feed_link( $term->term_id );
		}
	} elseif ( is_tag() ) {
		$term = get_queried_object();

		if ( $term ) {
			$title = sprintf( $args['tagtitle'], get_bloginfo( 'name' ), $args['separator'], $term->name );
			$href  = get_tag_feed_link( $term->term_id );
		}
	} elseif ( is_tax() ) {
		$term = get_queried_object();

		if ( $term ) {
			$tax   = get_taxonomy( $term->taxonomy );
			$title = sprintf( $args['taxtitle'], get_bloginfo( 'name' ), $args['separator'], $term->name, $tax->labels->singular_name );
			$href  = get_term_feed_link( $term->term_id, $term->taxonomy );
		}
	} elseif ( is_author() ) {
		$author_id = intval( get_query_var( 'author' ) );

		$title = sprintf( $args['authortitle'], get_bloginfo( 'name' ), $args['separator'], get_the_author_meta( 'display_name', $author_id ) );
		$href  = get_author_feed_link( $author_id );
	} elseif ( is_search() ) {
		$title = sprintf( $args['searchtitle'], get_bloginfo( 'name' ), $args['separator'], get_search_query( false ) );
		$href  = get_search_feed_link();
	}

	if ( isset( $title ) && isset( $href ) ) {
		echo '<link rel="alternate" type="' . feed_content_type() . '" title="' . esc_attr( $title ) . '" href="' . esc_url( $href ) . '" />' . "\n";
	}
}

Uses

Uses Description
wp-includes/l10n.php: _x()

Retrieve translated string with gettext context.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/formatting.php: esc_attr()

Escaping for HTML attributes.
wp-includes/formatting.php: esc_url()

Checks and cleans a URL.
wp-includes/general-template.php: get_search_query()

Retrieves the contents of the search WordPress query variable.
wp-includes/general-template.php: get_bloginfo()

Retrieves information about the current site.
wp-includes/query.php: is_singular()

Determines whether the query is for an existing single post of any post type (post, attachment, page, custom post types).
wp-includes/query.php: is_search()

Determines whether the query is for a search.
wp-includes/query.php: is_category()

Determines whether the query is for an existing category archive page.
wp-includes/query.php: is_tag()

Determines whether the query is for an existing tag archive page.
wp-includes/query.php: is_tax()

Determines whether the query is for an existing custom taxonomy archive page.
wp-includes/query.php: is_author()

Determines whether the query is for an existing author archive page.
wp-includes/query.php: is_post_type_archive()

Determines whether the query is for an existing post type archive page.
wp-includes/query.php: get_query_var()

Retrieve variable in the WP_Query class.
wp-includes/query.php: get_queried_object()

Retrieve the currently-queried object.
wp-includes/functions.php: wp_parse_args()

Merge user defined arguments into defaults array.
wp-includes/taxonomy.php: get_taxonomy()

Retrieves the taxonomy object of $taxonomy.
wp-includes/link-template.php: get_post_type_archive_feed_link()

Retrieves the permalink for a post type archive feed.
wp-includes/link-template.php: get_tag_feed_link()

Retrieves the permalink for a tag feed.
wp-includes/link-template.php: get_term_feed_link()

Retrieves the feed link for a term.
wp-includes/link-template.php: get_search_feed_link()

Retrieves the permalink for the search results feed.
wp-includes/link-template.php: get_post_comments_feed_link()

Retrieves the permalink for the post comments feed.
wp-includes/link-template.php: get_category_feed_link()

Retrieves the feed link for a category.
wp-includes/link-template.php: get_author_feed_link()

Retrieves the feed link for a given author.
wp-includes/feed.php: feed_content_type()

Return the content type for specified feed type.
wp-includes/post-template.php: the_title_attribute()

Sanitize the current title when retrieving or displaying.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.
wp-includes/post.php: get_post_type_object()

Retrieves a post type object by name.
wp-includes/author-template.php: get_the_author_meta()

Retrieves the requested data of the author of the current post.
wp-includes/comment-template.php: comments_open()

Determines whether the current post is open for comments.
wp-includes/comment-template.php: pings_open()

Determines whether the current post is open for pings.

Changelog

Version Description
2.8.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/feed_links_extra