acf_options_page()

WordPressの関数acf_options_page()は、Advanced Custom Fields（ACF）プラグインでカスタムオプションページを作成するために使用されます。この関数を使うと、管理画面にオプションページを追加し、そのページにカスタムフィールドを表示できます。

シンタックス

acf_options_page( array $args );

• $args (array) — オプションページを作成するための設定

引数の詳細:

• page_title (string) — オプションページのタイトル
• menu_title (string) — メニューに表示されるタイトル
• menu_slug (string) — メニューのスラッグ（URLの一部）
• capability (string) — このページを表示するために必要なユーザー権限
• redirect (boolean) — このページにリダイレクトするかどうか

例1: 基本的なオプションページの作成

オプションページを作成する最も基本的な例です。

acf_options_page( array(
    'page_title' => 'カスタムオプション',
    'menu_title' => 'カスタムオプション',
    'menu_slug'  => 'custom-options',
) );

例2: 権限を指定したオプションページの作成

管理者だけがアクセスできるように、権限を指定する例です。

acf_options_page( array(
    'page_title' => '管理者オプション',
    'menu_title' => '管理者オプション',
    'menu_slug'  => 'admin-options',
    'capability' => 'manage_options',
) );

例3: リダイレクトを有効にしたオプションページの作成

新しく作成したオプションページにリダイレクトする例です。

acf_options_page( array(
    'page_title' => 'リダイレクトオプション',
    'menu_title' => 'リダイレクトオプション',
    'menu_slug'  => 'redirect-options',
    'redirect'   => true,
) );

例4: 複数のオプションページを作成

複数のオプションページを作成する例です。

acf_options_page( array(
    'page_title' => 'オプションページ1',
    'menu_title' => 'オプション1',
    'menu_slug'  => 'option-page-1',
) );
acf_options_page( array(
    'page_title' => 'オプションページ2',
    'menu_title' => 'オプション2',
    'menu_slug'  => 'option-page-2',
) );

例5: サブメニューを持つオプションページの作成

サブメニューを持つオプションページの例です。

acf_options_page( array(
    'page_title'  => 'メインオプション',
    'menu_title'  => 'メインオプション',
    'menu_slug'   => 'main-options',
    'capability'  => 'manage_options',
    'redirect'    => false,
) );

acf_options_page( array(
    'page_title'  => 'サブオプション',
    'menu_title'  => 'サブオプション',
    'parent_slug' => 'main-options',
    'menu_slug'   => 'sub-options',
    'capability'  => 'manage_options',
) );

警告

オプションページを作成する際には、適切な権限を設定し、アクセス制限を厳格に行うようにしてください。また、ページのスラッグはユニークである必要があり、他のページと衝突しないように注意する必要があります。