Wordpressの管理画面にページとフィールドを追加する方法

2021-9-29

meko

新しいページを追加する方法

<?php
// ページの追加
add_action( 'admin_menu', 'register_manual_page' );
function register_manual_page() {
    add_menu_page('管理画面の使い方', 'マニュアル', 'manage_options', 'manual', 'add_manual_page', 'dashicons-book', 3);
}
 
// ページの中身のHTML
function add_manual_page() {
?>
<div>
    <h1>マニュアル</h1>
</div>
<?php
}
Copy

それぞれの項目と詳細

add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position );
Copy

サブメニューを追加する方法

<?php
// ページの追加
add_action('admin_menu', 'add_manual_submenu');
function add_manual_submenu() {
    add_submenu_page('post-new.php', '投稿の使い方', 'マニュアル', 'manage_options', 'manual', 'add_manual_subpage');
}
 
// ページの中身のHTML
function add_manual_subpage() {
?>
<div>
    <h1>マニュアルサブページ</h1>
</div>
<?php
}
Copy

それぞれの項目と詳細

add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

既存のページに追加する関数

ダッシュボードに追加

add_dashboard_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

投稿に追加

add_posts_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

メディアに追加

add_media_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

固定ページに追加

add_pages_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

コメントに追加

add_comments_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

外観に追加

add_theme_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

ユーザーに追加

add_users_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

ツールに追加

add_management_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

設定に追加

add_options_page( $page_title, $menu_title, $capability, $menu_slug, $function);
Copy

ページにセクションを追加する方法

add_settings_sectionを使用します

セクションの追加

add_action( "admin_init", "add_manual_sections" );
function add_manual_sections() {
    add_settings_section(
        "manual-1", // section name
        "マニュアル極意1",
        "manual_one", // null is ok
        "manual" // add this page
    );
}

function manual_one() {
    ?>
    <h2>マニュアル極意1</h2>
    <?php
}
Copy

フィールドの追加

add_action( "admin_init", "add_manual_fields" );
function add_manual_fields() {
    add_settings_field(
        "field-1",
        "フィールド1",
        "field_one", // function's name
        "manual", // page name
        "manual-1" // section's name
    );
    register_setting(
        "seo",
        "field-1",
        [
            "sanitize_callback" => "esc_attr"
        ], // null is ok
    );
    add_option("google-analytics-id");
}

function field_one() {
    if ($_REQUEST["google-analytics-id"]) {
		update_option("google-analytics-id", $_REQUEST["google-analytics-id"]);
	}
    ?>
    <input name="field-1" type="text" id="field-1" value="<?php form_option('field-1') ?>">
    <?php
}
Copy

form_optionはget_optionした値を表示してくれる関数です

セクションとフィールドの表示

settings_fieldsとdo_settings_sectionsを使います

function add_manual_subpage() {
?>
<div>
    <h1>マニュアルサブページ</h1>
    <form>
        <?php
            settings_fields("manual"); // page name
            do_settings_sections("manual"); // page name
            submit_button();
        ?>
    </form>
</div>
<?php
}
Copy

フィールドの値を使用する方法

get_optionを使います
呼び出したい場所でregister_settingで登録した名前で呼び出す

$manual_options = get_option("manual-1");
$field_one = manual_options["field-1"];
Copy

参考

add menu page
管理メニューの追加
add settings field
設定ページの作成