get_page_by_title()


WordPressのget_page_by_title()関数は、指定されたタイトルに基づいてページオブジェクトを取得するために使用されます。

シンタックス

get_page_by_title( string $page_title, string $output = OBJECT, string $post_type = 'page' );

引数の説明:

  • $page_title (string) — 取得したいページのタイトル。
  • $output (string) — 出力形式を指定します。デフォルトはOBJECTです。以下のオプションが利用可能です。
    • OBJECT — ページオブジェクトとして返します。
    • ARRAY_A — 連想配列として返します。
    • ARRAY_N — 数値インデックス配列として返します。
  • $post_type (string) — 投稿タイプを指定します。デフォルトは'page'です。

例1: ページオブジェクトを取得する

指定されたタイトルを持つページを取得し、そのIDを表示します。

<?php
$page = get_page_by_title( 'サンプルページ' );
if ( $page ) {
    echo $page->ID;
}
?>

例2: 出力形式を連想配列にする

ARRAY_Aオプションを使用して連想配列としてページデータを取得します。

<?php
$page = get_page_by_title( 'サンプルページ', 'ARRAY_A' );
if ( $page ) {
    echo $page['ID'];
}
?>

例3: 投稿タイプを指定する

$post_type引数を'post'に指定し、投稿タイプpostからページを検索します。

<?php
$page = get_page_by_title( '投稿タイトル', OBJECT, 'post' );
if ( $page ) {
    echo $page->post_title;
}
?>

例4: ページが存在しない場合の処理

存在しない場合にメッセージを表示します。

<?php
$page = get_page_by_title( '存在しないページ' );
if ( $page ) {
    echo 'ページが見つかりました。ID: ' . $page->ID;
} else {
    echo 'ページは存在しません。';
}
?>

例5: ページのスラッグを取得する

ページオブジェクトからスラッグを表示します。

<?php
$page = get_page_by_title( 'サンプルページ' );
if ( $page ) {
    echo $page->post_name;
}
?>

注意事項

  • この関数は、タイトルが完全一致するページのみを取得します。
  • タイトルが重複している場合は最初に一致したページが返されます。

関連機能：