get_page_by_title

函数
get_page_by_title ( $page_title, $output = OBJECT, $post_type = 'page' )
参数
  • (string) $page_title Page title.
    Required:
  • (string) $output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to a WP_Post object, an associative array, or a numeric array, respectively. Default OBJECT.
    Required:
    Default: OBJECT
  • (string|array) $post_type Optional. Post type or array of post types. Default 'page'.
    Required:
    Default: 'page'
返回值
  • (WP_Post|array|null) WP_Post (or array) on success, or null on failure.
定义位置
相关方法
get_page_by_pathget_admin_page_titleget_the_titleget_page_childrenget_page_statuses
引入
2.1.0
弃用
-

get_page_by_title函数是一个WordPress的函数,通过它的标题来检索单个页面: 这个函数接受一个参数,它是你想检索的页面的标题: 该函数返回一个页面对象。

检索一个页面的标题。

如果有多个文章使用相同的标题,将返回ID最小的那个文章。注意: 如果有多篇文章具有相同的标题,它将检查最早的出版日期,而不是最小的ID。

因为这个函数使用MySQL的’=’比较,$page_title通常会被匹配为不区分大小写的默认排序。

function get_page_by_title( $page_title, $output = OBJECT, $post_type = 'page' ) {
	$args  = array(
		'title'                  => $page_title,
		'post_type'              => $post_type,
		'post_status'            => get_post_stati(),
		'posts_per_page'         => 1,
		'update_post_term_cache' => false,
		'update_post_meta_cache' => false,
		'no_found_rows'          => true,
		'orderby'                => 'post_date ID',
		'order'                  => 'ASC',
	);
	$query = new WP_Query( $args );
	$pages = $query->posts;

	if ( empty( $pages ) ) {
		return null;
	}

	return get_post( $pages[0], $output );
}

常见问题

FAQs
查看更多 >