wpseek.com
A WordPress-centric search engine for devs and theme authors



get_page_by_title › WordPress Function

Since2.1.0
Deprecated6.2.0
› get_page_by_title ( $page_title, $output = OBJECT, $post_type = 'page' )
Parameters: (3)
  • (string) $page_title Page title.
    Required: Yes
  • (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: No
    Default: OBJECT
  • (string|array) $post_type Optional. Post type or array of post types. Default 'page'.
    Required: No
    Default: 'page'
Returns:
  • (WP_Post|array|null) WP_Post (or array) on success, or null on failure.
Defined at:
Codex:
Change Log:
  • 3.0.0

Retrieves a page given its title.

If more than one post uses the same title, the post with the smallest ID will be returned. Be careful: in case of more than one post having the same title, it will check the oldest publication date, not the smallest ID. Because this function uses the MySQL '=' comparison, $page_title will usually be matched as case-insensitive with default collation.


Related Functions: get_page_by_path, get_admin_page_title, get_the_title, get_page_statuses, get_page_children

Source 

function get_page_by_title( $page_title, $output = OBJECT, $post_type = 'page' ) {
	_deprecated_function( __FUNCTION__, '6.2.0', 'WP_Query' );
	global $wpdb;

	if ( is_array( $post_type ) ) {
		$post_type           = esc_sql( $post_type );
		$post_type_in_string = "'" . implode( "','", $post_type ) . "'";
		$sql                 = $wpdb->prepare(
			"SELECT ID
			FROM $wpdb->posts
			WHERE post_title = %s
			AND post_type IN ($post_type_in_string)",
			$page_title
		);
	} else {
		$sql = $wpdb->prepare(
			"SELECT ID
			FROM $wpdb->posts
			WHERE post_title = %s
			AND post_type = %s",
			$page_title,
			$post_type
		);
	}

	$page = $wpdb->get_var( $sql );

	if ( $page ) {
		return get_post( $page, $output );
	}

	return null;
}