【WordPress】SettingsAPIでデータを配列にひとまとめ！チェックボックスはどうなる？

$item_array	= array(
		'url'			=> '',		// ブログ情報：URL（input text）
		'title'			=> '',		// ブログ情報：タイトル（input text）
		'description'	=> '',		// ブログ情報：説明（textarea）
		'gender'		=> '',		// 管理者情報：性別（ラジオボタン）
		'interest'		=> array(),	// 管理者情報：興味（配列）（複数チェックボックス）
		'selfintro'	=> ''		// 管理者情報：自己紹介（textarea）
	);

//コールバック）ブログ情報：URL（1行テキスト入力：input（text））
function jin_test_setting_field_callback_url(){
    echo '<input name="item_url" id="field_id_url" type="text"
	maxlength="200" value="'.
	esc_url( get_option( 'item_url' ) ).'" />';
}

//コールバック）ブログ情報：URL（1行テキスト入力：input（text））
function jin_test_setting_field_callback_url(){
    // 保存されている配列を取得（なければ空の配列を代入）
    $options = get_option( 'item_array' ) ?: array();
    // キーが存在するか確認して値を取り出す（なければ空文字）
    $val = isset( $options['url'] ) ? $options['url'] : '';

    echo '<input name="item_array[url]" id="field_id_url" type="text"
	maxlength="200" value="' . esc_url( $val ) . '" />';
}

//コールバック）ブログ情報：タイトル（1行テキスト入力：input（text））
function jin_test_setting_field_callback_title(){
    echo '<input name="item_title" id="field_id_title" type="text"
	maxlength="100" value="'.
	esc_attr( get_option( 'item_title' ) ).'" />';
}

//コールバック）ブログ情報：タイトル（1行テキスト入力：input（text））
function jin_test_setting_field_callback_title(){
    // 保存されている配列を取得（なければ空の配列を代入）
    $options = get_option( 'item_array' ) ?: array();
    // キーが存在するか確認して値を取り出す（なければ空文字）
    $val = isset( $options['title'] ) ? $options['title'] : '';

    echo '<input name="item_array[title]" id="field_id_title" type="text"
	maxlength="100" value="' . esc_attr( $val ) . '" />';
}

//コールバック）ブログ情報：説明（複数行テキスト入力：textarea）
function jin_test_setting_field_callback_description(){
    echo '<textarea name="item_description" id="field_id_description"
	rows="2" cols="30" maxlength="200">'.
	esc_textarea( get_option( 'item_description' ) ).'</textarea>';

	echo '<p>どんなブログかの簡単な説明</p>';
}

//コールバック）ブログ情報：説明（複数行テキスト入力：textarea）
function jin_test_setting_field_callback_description(){
    // 保存されている配列を取得（なければ空の配列を代入）
    $options = get_option( 'item_array' ) ?: array();
    // キーが存在するか確認して値を取り出す（なければ空文字）
    $val = isset( $options['description'] ) ? $options['description'] : '';

    echo '<textarea name="item_array[description]" id="field_id_description"
	rows="2" cols="30" maxlength="200">'.
	esc_textarea( $val ).'</textarea>';
 
	echo '<p>どんなブログかの簡単な説明</p>';
}

//コールバック）管理者情報：性別（選択：ラジオボタン：input（radio））
function jin_test_setting_field_callback_gender(){
	$gender = esc_attr( get_option( 'item_gender' ) );
?>
	<label><input type="radio" name="item_gender" value="男性" 
	<?php checked( $gender, '男性' );  ?> >男性</label>
	
	<label><input type="radio" name="item_gender" value="女性" 
	<?php checked( $gender, '女性' );  ?> >女性</label>
	
	<label><input type="radio" name="item_gender" value="秘密" 
	<?php checked( $gender, '秘密' );  ?> >秘密</label>
	
<?php
}

//コールバック）管理者情報：性別（選択：ラジオボタン：input（radio））
function jin_test_setting_field_callback_gender(){
    // 保存されている配列を取得（なければ空の配列を代入）
    $options = get_option( 'item_array' ) ?: array();
    // キーが存在するか確認して値を取り出す（なければ空文字）
    $gender = isset( $options['gender'] ) ? $options['gender'] : '';
?>
	<label><input type="radio" name="item_array[gender]" value="男性" 
	<?php checked( $gender, '男性' );  ?> >男性</label>
	
	<label><input type="radio" name="item_array[gender]" value="女性" 
	<?php checked( $gender, '女性' );  ?> >女性</label>
	
	<label><input type="radio" name="item_array[gender]" value="秘密" 
	<?php checked( $gender, '秘密' );  ?> >秘密</label>
<?php
}

//コールバック）管理者情報：興味（複数選択：チェックボックス：input（checkbox））
function jin_test_setting_field_callback_interest(){	
	$interest = get_option( 'item_interest' );
	$interest = sanitize_item_interest( $interest );	// サニタイズ
    ?>
    <label><input type='checkbox' name='item_interest[]' 
	<?php checked( in_array( '旅行', $interest ), true ); ?> value='旅行'>旅行</label>

    <label><input type='checkbox' name='item_interest[]'
	<?php checked( in_array( 'IT', $interest ), true ); ?> value='IT'>IT</label>

    <label><input type='checkbox' name='item_interest[]'
	<?php checked( in_array( '遊び', $interest ), true ); ?> value='遊び'>遊び</label>

<?php
}

//コールバック）管理者情報：興味（複数選択：チェックボックス：input（checkbox））
function jin_test_setting_field_callback_interest(){
    // 保存されている配列を取得（なければ空の配列を代入）
    $options = get_option( 'item_array' ) ?: array();
    // キー「interest」があるか確認し、なければ空の配列をセット
    $interest = isset( $options['interest'] ) ? $options['interest'] : array();

    // 自作のサニタイズ関数を通す（念のため）
    $interest = sanitize_item_interest( $interest );
    ?>
    <label><input type='checkbox' name='item_array[interest][]' 
	<?php checked( in_array( '旅行', $interest ), true ); ?> value='旅行'>旅行</label>

    <label><input type='checkbox' name='item_array[interest][]'
	<?php checked( in_array( 'IT', $interest ), true ); ?> value='IT'>IT</label>

    <label><input type='checkbox' name='item_array[interest][]'
	<?php checked( in_array( '遊び', $interest ), true ); ?> value='遊び'>遊び</label>
<?php
}

// サニタイズ（チェックボックスの配列用）
function sanitize_item_interest( $args ){
    // 配列でない（何も選ばれていない）場合は空の配列を返す
    $args = is_array( $args ) ? $args : array();
    // 各要素を安全な形に変換
    $args = array_map( 'esc_attr', $args );
    return $args;
}

//コールバック）管理者情報：自己紹介（複数行テキスト入力：textarea）
function jin_test_setting_field_callback_selfintro(){
    echo '<textarea name="item_selfintro" id="field_id_selfintro" 
	rows="2" cols="30" maxlength="200">'.
	esc_textarea( get_option( 'item_selfintro' ) ).'</textarea>';
	
	echo '<p>ブログの管理者はどんな人か簡単な自己紹介</p>';
}

//コールバック）管理者情報：自己紹介（複数行テキスト入力：textarea）
function jin_test_setting_field_callback_selfintro(){
    // 保存されている配列を取得（なければ空の配列を代入）
    $options = get_option( 'item_array' ) ?: array();
    // キーが存在するか確認して値を取り出す（なければ空文字）
    $val = isset( $options['selfintro'] ) ? $options['selfintro'] : '';

    echo '<textarea name="item_array[selfintro]" id="field_id_selfintro" 
	rows="2" cols="30" maxlength="200">'.
	esc_textarea( $val ).'</textarea>';
	
	echo '<p>ブログの管理者はどんな人か簡単な自己紹介</p>';
}

//
// 初期値設定
//

//$item_url_init			= '';	// ブログ情報：URL
$item_title_init		= '';			// ブログ情報：タイトル
$item_description_init	= '';			// ブログ情報：説明
$item_gender_init		= '秘密';		// 管理者情報：性別
$item_interest_init	= array();		// 管理者情報：興味（空の配列を初期値としておく）
$item_selfintro_init	= '';			// 管理者情報：自己紹介

// URL：初期（まだ変数自体がない）または空の文字列では「http://」を表示する
if( esc_url( get_option( 'item_url' ) ) == false ){
	update_option( 'item_url' , 'http://' );
}

//
// 初期値設定
// （設定値はすべて配列 $item_array でひとまとめ）
//
	$default = array(
		'url' => 'http://', // ブログ情報：URL
		'title' => '', // ブログ情報：タイトル
		'description' => '', // ブログ情報：説明
		'gender' => '秘密', // 管理者情報：性別
		'interest' => array(), // 管理者情報：興味（空の配列を初期値としておく）
		'selfintro' => '' // 管理者情報：自己紹介
	);

//
// データベースに登録
//（まだデータベースに item_array がなければ登録して初期値を設定）
//
if ( false === get_option( 'item_array' ) ) {
    add_option( 'item_array', $default );
}

//
// 設定値の登録
//

// ブログ情報：URL
register_setting(
	'jin-test-setting-field-group',	// ① グループ名（settings_fieldsで設定されたもの）
	'item_url',	// ② inputやtextareaなどのname要素と合わせる
	'esc_url' 	// ③ サニタイズ関数
);
// ブログ情報：タイトル
register_setting(
	'jin-test-setting-field-group',	// ① グループ名（settings_fieldsで設定されたもの）
	'item_title',	// ② inputやtextareaなどのname要素と合わせる
	array(
		'sanitize_callback' => 'esc_attr', 	// ③ サニタイズ関数
		'default' => $item_title_init			// ④ 初期値
	)
);
// ブログ情報：説明
register_setting(
	'jin-test-setting-field-group',	// ① グループ名（settings_fieldsで設定されたもの）


　　( ----- 以下省略 ----- )

//
// 設定値の登録
//（Settings API で扱う設定値を登録）
//
register_setting(
	'jin-test-setting-field-group',	// ① グループ名
	'item_array',			// ② 設定値名（配列名）
	array(
		'type'              => 'array',	     // データ型が配列であることを明示
		'sanitize_callback' => 'item_sanitize' // ③ サニタイズ関数
	)
);

//
// 設定値の登録
//

// ブログ情報：URL
register_setting(
	'jin-test-setting-field-group',	// ① グループ名（settings_fieldsで設定されたもの）
	'item_url',	// ② inputやtextareaなどのname要素と合わせる
	'esc_url' 	// ③ サニタイズ関数
);
// ブログ情報：タイトル
register_setting(
	'jin-test-setting-field-group',	// ① グループ名（settings_fieldsで設定されたもの）
	'item_title',	// ② inputやtextareaなどのname要素と合わせる
	array(
		'sanitize_callback' => 'esc_attr', 	// ③ サニタイズ関数
		'default' => $item_title_init			// ④ 初期値
	)
);
// ブログ情報：説明
register_setting(
	'jin-test-setting-field-group',	// ① グループ名（settings_fieldsで設定されたもの）
	'item_description',	// ② inputやtextareaなどのname要素と合わせる
	array(
		'sanitize_callback' => 'esc_textarea', 	// ③ サニタイズ関数
		'default' => $item_description_init		// ④ 初期値
	)
);

以下略

// ③ サニタイズ関数（データの安全化処理をまとめて行う）
function item_sanitize( $args ){
    // データが配列でない場合は空の配列として扱う（エラー防止）
    if ( ! is_array( $args ) ) {
        return array();
    }

    foreach( $args as $key => $value ){
        switch( $key ){
            case 'url':          // ブログ情報：URL
                // 空文字だったら「http://」を補完
                if( $value == '' ){
                    $value = "http://";
                }
                $args[ $key ] = esc_url( $value );
                break;

            case 'title':        // ブログ情報：タイトル
            case 'gender':       // 管理者情報：性別
                $args[ $key ] = sanitize_text_field( $value );
                break;

            case 'description':  // ブログ情報：説明
            case 'selfintro':    // 管理者情報：自己紹介
                $args[ $key ] = sanitize_textarea_field( $value );
                break;
                
            case 'interest':     // 管理者情報：興味（複数選択）
                $args[ $key ] = sanitize_item_interest( $value );
                break;

            default:
                // 未定義のキーが含まれていた場合は、安全のため削除するかそのまま通す
                break;
        }
    }
    
    return $args;
}

<?php
// ------------------------------------
// 手順１）「メニュー情報」の関数名を指定（関数Bを指定）
// ------------------------------------
add_action( 'admin_menu', 'jin_test' );


// ------------------------------------
// 手順２）「メニュー情報」の関数の具体的内容（関数B）
// ------------------------------------
function jin_test(){
	add_options_page(
		'JIN Test Settings',		// ① ページタイトル
		'JINテスト用設定',			// ② メニュー名
		'manage_options',			// ③ メニューが表示されるユーザー権限
		'jin-test-setting-slug',	// ④ メニューのスラッグ
		'jin_test_setting_func'	// ⑤ 「設定画面」表示の関数名（関数Aを指定）
	);
}

// ------------------------------------
// 手順３）「設定画面」表示関数の具体的内容（関数A）
// ------------------------------------
function jin_test_setting_func(){ ?>
 
	<div class="wrap">
	<h1>JINのテスト用設定画面なのだ</h1>
	<form method="post" action="options.php">
	 
	<?php settings_fields( 'jin-test-setting-field-group' ); ?>
	<?php do_settings_sections( 'jin-test-setting-slug' ); ?>
	<?php submit_button(); ?>
	 
	</form>
	</div>
 
<?php
};

/* ------------------------------------
セクションの追加
------------------------------------ */
//admin_initフックを使って呼び出す
function jin_test_setting_section_init() {
	
	//ブログ情報のセクション１
	add_settings_section(
		'jin_test_setting_section_id1', 		// ① ID
		'ブログ情報', 							// ② セクションのタイトル
		'jin_test_setting_section_callback1', // ③ コールバック関数1
		'jin-test-setting-slug' 				// ④ 設定ページSlug
	);
	
	//管理者情報のセクション２
	add_settings_section(
		'jin_test_setting_section_id2', 		// ① ID
		'管理者情報', 							// ② セクションのタイトル
		'jin_test_setting_section_callback2', // ③ コールバック関数2
		'jin-test-setting-slug' 				// ④ 設定ページSlug
	);
 
}
add_action('admin_init', 'jin_test_setting_section_init');
 
// ③ コールバック関数
// ブログ情報用
function jin_test_setting_section_callback1() {
    echo '<p>ブログの情報を入力してね</p>';
}
// 管理者情報用
function jin_test_setting_section_callback2() {
    echo '<p>管理者の情報を入力してね</p>';
}

/* ------------------------------------
フィールドの追加
------------------------------------ */
//admin_initフックを使って呼び出す
function jin_test_settings_fields_init(){
	//フィールド（ブログ情報）：URL
	add_settings_field(
		'field_id_url',	// ① id：⑥でlabel_forを指定する場合、inputタグなどのid属性に同じ文字列を設定する
		'URL',				// ② フィールドのタイトル（設定項目のラベル）
		'jin_test_setting_field_callback_url',	// ③ input要素などを表示するコールバック関数
		'jin-test-setting-slug',					// ④ 設定画面のスラッグ
		'jin_test_setting_section_id1',			// ⑤ 表示するセクションのID
		array( 'label_for' => 'field_id_url' )	// ⑥ 配列:省略可。'label_for'を指定して①のidを入れると、項目名をlabelタグで囲んでくれる
	);
	//フィールド（ブログ情報）：タイトル
	add_settings_field(
		'field_id_title',		// ① id：⑥でlabel_forを指定する場合、inputタグなどのid属性に同じ文字列を設定する
		'タイトル',				// ② フィールドのタイトル（設定項目のラベル）
		'jin_test_setting_field_callback_title',	// ③ input要素などを表示するコールバック関数
		'jin-test-setting-slug',					// ④ 設定画面のスラッグ
		'jin_test_setting_section_id1',			// ⑤ 表示するセクションのID
		array( 'label_for' => 'field_id_title' )	// ⑥ 配列:省略可。'label_for'を指定して①のidを入れると、項目名をlabelタグで囲んでくれる
	);
	//フィールド（ブログ情報）：説明
	add_settings_field(
		'field_id_description',	// ① id：⑥でlabel_forを指定する場合、inputタグなどのid属性に同じ文字列を設定する
		'説明',					// ② フィールドのタイトル（設定項目のラベル）
		'jin_test_setting_field_callback_description',	// ③ input要素などを表示するコールバック関数
		'jin-test-setting-slug',					// ④ 設定画面のスラッグ
		'jin_test_setting_section_id1',			// ⑤ 表示するセクションのID
		array( 'label_for' => 'field_id_description' )	// ⑥ 配列:省略可。'label_for'を指定して①のidを入れると、項目名をlabelタグで囲んでくれる
	);

	//フィールド（管理者情報）：性別
	add_settings_field(
		'field_id_gender',	// ① id：⑥でlabel_forを指定する場合、inputタグなどのid属性に同じ文字列を設定する
		'性別',				// ② フィールドのタイトル（設定項目のラベル）
		'jin_test_setting_field_callback_gender',	// ③ input要素などを表示するコールバック関数
		'jin-test-setting-slug',					// ④ 設定画面のスラッグ
		'jin_test_setting_section_id2',			// ⑤ 表示するセクションのID
	);
	//フィールド（管理者情報）：興味
	add_settings_field(
		'field_id_interest',	// ① id：⑥でlabel_forを指定する場合、inputタグなどのid属性に同じ文字列を設定する
		'興味',					// ② フィールドのタイトル（設定項目のラベル）
		'jin_test_setting_field_callback_interest',	// ③ input要素などを表示するコールバック関数
		'jin-test-setting-slug',						// ④ 設定画面のスラッグ
		'jin_test_setting_section_id2',				// ⑤ 表示するセクションのID
	);
	//フィールド（管理者情報）：自己紹介
	add_settings_field(
		'field_id_selfintro',	// ① id：⑥でlabel_forを指定する場合、inputタグなどのid属性に同じ文字列を設定する
		'自己紹介',				// ② フィールドのタイトル（設定項目のラベル）
		'jin_test_setting_field_callback_selfintro',	// ③ input要素などを表示するコールバック関数
		'jin-test-setting-slug',						// ④ 設定画面のスラッグ
		'jin_test_setting_section_id2',				// ⑤ 表示するセクションのID
		array( 'label_for' => 'field_id_selfintro' )	// ⑥ 配列:省略可。'label_for'を指定して①のidを入れると、項目名をlabelタグで囲んでくれる
	);
}
add_action('admin_init', 'jin_test_settings_fields_init');

// ------------------------------------
// フィールドのコールバック関数
// label_forを使う場合、input要素のidはadd_settings_fieldのidと同じにする
// ------------------------------------
//コールバック）ブログ情報：URL（1行テキスト入力：input（text））
function jin_test_setting_field_callback_url(){
    echo '<input name="item_array[url]" id="field_id_url" type="text"
	maxlength="200" value="'.
	esc_url( get_option( 'item_array' )['url'] ).'" />';
}
//コールバック）ブログ情報：タイトル（1行テキスト入力：input（text））
function jin_test_setting_field_callback_title(){
    echo '<input name="item_array[title]" id="field_id_title" type="text"
	maxlength="100" value="'.
	esc_attr( get_option( 'item_array' )['title'] ).'" />';
}
//コールバック）ブログ情報：説明（複数行テキスト入力：textarea）
function jin_test_setting_field_callback_description(){
    echo '<textarea name="item_array[description]" id="field_id_description"
	rows="2" cols="30" maxlength="200">'.
	esc_textarea( get_option( 'item_array' )['description'] ).'</textarea>';

	echo '<p>どんなブログかの簡単な説明</p>';
}

//コールバック）管理者情報：性別（選択：ラジオボタン：input（radio））
function jin_test_setting_field_callback_gender(){
	$gender = esc_attr( get_option( 'item_array' )['gender'] );
?>
	<label><input type="radio" name="item_array[gender]" value="男性" 
	<?php checked( $gender, '男性' );  ?> >男性</label>
	
	<label><input type="radio" name="item_array[gender]" value="女性" 
	<?php checked( $gender, '女性' );  ?> >女性</label>
	
	<label><input type="radio" name="item_array[gender]" value="秘密" 
	<?php checked( $gender, '秘密' );  ?> >秘密</label>
	
<?php
}
//コールバック）管理者情報：興味（複数選択：チェックボックス：input（checkbox））
function jin_test_setting_field_callback_interest(){	
	$interest = get_option( 'item_array' )[ 'interest' ];
	$interest = sanitize_item_interest( $interest );	// サニタイズ
    ?>
    <label><input type='checkbox' name='item_array[interest][]' 
	<?php checked( in_array( '旅行', $interest ), true ); ?> value='旅行'>旅行</label>

    <label><input type='checkbox' name='item_array[interest][]'
	<?php checked( in_array( 'IT', $interest ), true ); ?> value='IT'>IT</label>

    <label><input type='checkbox' name='item_array[interest][]'
	<?php checked( in_array( '遊び', $interest ), true ); ?> value='遊び'>遊び</label>

<?php
}
// サニタイズ（チェックボックスの配列用）
function sanitize_item_interest( $args ){
	$args = isset( $args ) ? (array) $args : [];
	$args = array_map('esc_attr', $args);
	return $args;
}

//コールバック）管理者情報：自己紹介（複数行テキスト入力：textarea）
function jin_test_setting_field_callback_selfintro(){
    echo '<textarea name="item_array[selfintro]" id="field_id_selfintro" 
	rows="2" cols="30" maxlength="200">'.
	esc_textarea( get_option( 'item_array' )['selfintro'] ).'</textarea>';
	
	echo '<p>ブログの管理者はどんな人か簡単な自己紹介</p>';
}

/* ------------------------------------
設定値と初期値を登録
------------------------------------ */
//admin_initフックを使って呼び出す
function jin_test_settings_values_init(){
	//
	// 初期値設定
	// （設定値はすべて配列 $item_array でひとまとめ）
	//
	$default	= array(
			'url'			=> 'http://',	// ブログ情報：URL
			'title'			=> '',			// ブログ情報：タイトル
			'description'	=> '',			// ブログ情報：説明
			'gender'		=> '秘密',		// 管理者情報：性別
			'interest'		=> array(),		// 管理者情報：興味（空の配列を初期値としておく）
			'selfintro'	=> ''			// 管理者情報：自己紹介
		);

	//
	// データベースに登録
	//（まだデータベースに item_array がなければ登録して初期値を設定）
	//
	if( get_option( 'item_array' ) == false ){
		update_option( 'item_array', $default );
	}
	
	//
	// 設定値の登録
	//（Settings API で扱う設定値を登録）
	//
    register_setting(
		'jin-test-setting-field-group',	// ① グループ名（settings_fieldsで設定されたもの）
		'item_array',	// ② 設定値名：inputやtextareaなどのname要素と合わせる
		'item_sanitize' 	// ③ サニタイズ関数
	);

}
add_action('admin_init', 'jin_test_settings_values_init');

// ③ サニタイズ関数
function item_sanitize( $args ){
	foreach( $args as $key => $value ){
		switch( $key ){
			case 'url':			// input text	：ブログ情報）URL
				// 空文字だったら「http://」を付ける
				if( $value == ''){
					$value = "http://";
				}
				
				$args[ $key ] 		= esc_url( $value );
				break;

			case 'title':			// input text	：ブログ情報）タイトル
			case 'description':	// textarea	：ブログ情報）説明
			case 'gender':			// input radio	：管理者情報）性別
			case 'selfintro':		// textarea	：管理者情報）自己紹介
				$args[ $key ] 		= esc_attr( $value );
				break;
				
			case 'interest':		// input checkbox：管理者情報）興味
				// コールバックの所で定義したサニタイズ（チェックボックスの配列用）
				$args[ $key ] 		= sanitize_item_interest( $value );
				break;

			default:				// エラー表示
				echo '<br>no case:'.$key.'<br>';
		}
	}
	
	return $args;
}
?>