Question

get_post_type_archive_link( string $post_type )

Retrieves the permalink for a post type archive.

---

description

---

参数

$post_type

(string) (Required) Post type.

---

返回值

(string|false) The post type archive permalink.

---

源代码

File: wp-includes/link-template.php

function get_post_type_archive_link( $post_type ) {
	global $wp_rewrite;
	if ( ! $post_type_obj = get_post_type_object( $post_type ) )
		return false;

	if ( 'post' === $post_type ) {
		$show_on_front = get_option( 'show_on_front' );
		$page_for_posts  = get_option( 'page_for_posts' );

		if ( 'page' == $show_on_front && $page_for_posts ) {
			$link = get_permalink( $page_for_posts );
		} else {
			$link = get_home_url();
		}
		/** This filter is documented in wp-includes/link-template.php */
		return apply_filters( 'post_type_archive_link', $link, $post_type );
	}

	if ( ! $post_type_obj->has_archive )
		return false;

	if ( get_option( 'permalink_structure' ) && is_array( $post_type_obj->rewrite ) ) {
		$struct = ( true === $post_type_obj->has_archive ) ? $post_type_obj->rewrite['slug'] : $post_type_obj->has_archive;
		if ( $post_type_obj->rewrite['with_front'] )
			$struct = $wp_rewrite->front . $struct;
		else
			$struct = $wp_rewrite->root . $struct;
		$link = home_url( user_trailingslashit( $struct, 'post_type_archive' ) );
	} else {
		$link = home_url( '?post_type=' . $post_type );
	}

	/**
	 * Filters the post type archive permalink.
	 *
	 * @since 3.1.0
	 *
	 * @param string $link      The post type archive permalink.
	 * @param string $post_type Post type name.
	 */
	return apply_filters( 'post_type_archive_link', $link, $post_type );
}

---

更新日志

Version	description
4.5.0	Support for posts was added.
3.1.0	Introduced.

---

相关函数

Uses

• wp-includes/link-template.php: get_home_url()
• wp-includes/link-template.php: home_url()
• wp-includes/link-template.php: post_type_archive_link
• wp-includes/link-template.php: get_permalink()
• wp-includes/link-template.php: user_trailingslashit()
• wp-includes/plugin.php: apply_filters()
• wp-includes/option.php: get_option()
• wp-includes/post.php: get_post_type_object()
Show 3 more uses Hide more uses

---

Used By

• wp-includes/customize/class-wp-customize-nav-menu-item-setting.php: WP_Customize_Nav_Menu_Item_Setting::value_as_wp_post_nav_menu_item()
• wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::load_available_items_query()
• wp-admin/includes/nav-menu.php: wp_nav_menu_item_post_type_meta_box()
• wp-includes/category-template.php: wp_list_categories()
• wp-includes/link-template.php: get_post_type_archive_feed_link()
• wp-includes/admin-bar.php: wp_admin_bar_edit_menu()
• wp-includes/nav-menu.php: wp_setup_nav_menu_item()
Show 2 more used by Hide more used by

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Example

   
   <a href="<?php echo get_post_type_archive_link( 'movies' ); ?>">Movies Archive</a>