acf_get_valid_post_id()


WordPressのacf_get_valid_post_id()関数は、有効な投稿IDを取得するために使用されます。この関数は、Advanced Custom Fields（ACF）プラグインの一部であり、投稿、ページ、カスタム投稿タイプ、オプションページなど、さまざまなコンテキストで使用される投稿IDを正しく取得するために役立ちます。

構文

acf_get_valid_post_id( $post_id = 0 );
  • $post_id(int|string) — 投稿IDまたは文字列（例: ‘option’）を指定します。デフォルトは0で、現在の投稿IDを取得します。

例1: 現在の投稿IDを取得する

この例では、現在の投稿IDを取得します。

$post_id = acf_get_valid_post_id(); echo $post_id;

例2: 特定の投稿IDを検証する

この例では、指定された投稿IDが有効かどうかを確認します。

$post_id = acf_get_valid_post_id( get_the_ID() ); echo $post_id;

例3: オプションページのIDを取得する

この例では、オプションページのIDを取得します。

$post_id = acf_get_valid_post_id( 'option' ); echo $post_id;

例4: カスタム投稿タイプのIDを取得する

この例では、カスタム投稿タイプのIDを取得します。

$post_id = acf_get_valid_post_id( 'post_type_slug' ); echo $post_id;

例5: フロントページのIDを取得する

この例では、フロントページのIDを取得します。

$post_id = acf_get_valid_post_id( get_option( 'page_on_front' ) ); echo $post_id;

例6: ブログページのIDを取得する

この例では、ブログページのIDを取得します。

$post_id = acf_get_valid_post_id( get_option( 'page_for_posts' ) ); echo $post_id;

例7: ユーザーIDを取得する

この例では、ユーザーIDを取得します。

$post_id = acf_get_valid_post_id( 'user_1' ); echo $post_id;

例8: タームIDを取得する

この例では、タームIDを取得します。

$post_id = acf_get_valid_post_id( 'term_1' ); echo $post_id;

注意点

  • acf_get_valid_post_id()は、ACFプラグインが有効化されている場合にのみ使用できます。
  • 無効な投稿IDを指定した場合、関数は0を返します。
  • オプションページやユーザー、タームなどの特殊なコンテキストでは、文字列形式のIDを使用する必要があります。

関連機能：