完全な例

WPOrgという名前のトップレベルメニューを追加し、wporg_optionsというカスタムオプションを登録し、Settings APIおよびOptions APIを使用してCRUD（作成、読み取り、更新、削除）ロジックを実行します（エラー/更新メッセージの表示を含む）。 

  1. /**
  2.  * @internal never define functions inside callbacks.
  3.  * these functions could be run multiple times; this would result in a fatal error.
  4.  */
  6. /**
  7.  * custom option and settings
  8.  */
  9. function wporg_settings_init() {
  10.     // Register a new setting for "wporg" page.
  11.     register_setting( 'wporg', 'wporg_options' );
  13.     // Register a new section in the "wporg" page.
  14.     add_settings_section(
  15.         'wporg_section_developers',
  16.         __( 'The Matrix has you.', 'wporg' ), 'wporg_section_developers_callback',
  17.         'wporg'
  18.     );
  20.     // Register a new field in the "wporg_section_developers" section, inside the "wporg" page.
  21.     add_settings_field(
  22.         'wporg_field_pill', // As of WP 4.6 this value is used only internally.
  23.          // Use $args' label_for to populate the id inside the callback.
  24.             __( 'Pill', 'wporg' ),
  25.         'wporg_field_pill_cb',
  26.         'wporg',
  27.         'wporg_section_developers',
  28.         array(
  29.             'label_for'         => 'wporg_field_pill',
  30.             'class'             => 'wporg_row',
  31.             'wporg_custom_data' => 'custom',
  32.         )
  33.     );
  34. }
  36. /**
  37.  * Register our wporg_settings_init to the admin_init action hook.
  38.  */
  39. add_action( 'admin_init', 'wporg_settings_init' );
  41. /**
  42.  * Custom option and settings:
  43.  *  - callback functions
  44.  */
  46. /**
  47.  * Developers section callback function.
  48.  *
  49.  * @param array $args  The settings array, defining title, id, callback.
  50.  */
  51. function wporg_section_developers_callback( $args ) {
  52.     ?>
  53.     <p id="<?php echo esc_attr( $args['id'] ); ?>"><?php esc_html_e( 'Follow the white rabbit.', 'wporg' ); ?></p>
  54.     <?php
  55. }
  57. /**
  58.  * Pill field callbakc function.
  59.  *
  60.  * WordPress has magic interaction with the following keys: label_for, class.
  61.  * - the "label_for" key value is used for the "for" attribute of the <label>.
  62.  * - the "class" key value is used for the "class" attribute of the <tr> containing the field.
  63.  * Note: you can add custom key value pairs to be used inside your callbacks.
  64.  *
  65.  * @param array $args
  66.  */
  67. function wporg_field_pill_cb( $args ) {
  68.     // Get the value of the setting we've registered with register_setting()
  69.     $options = get_option( 'wporg_options' );
  70.     ?>
  71.     <select
  72.             id="<?php echo esc_attr( $args['label_for'] ); ?>"
  73.             data-custom="<?php echo esc_attr( $args['wporg_custom_data'] ); ?>"
  74.             name="wporg_options[<?php echo esc_attr( $args['label_for'] ); ?>]">
  75.         <option value="red" <?php echo isset( $options[ $args['label_for'] ] ) ? ( selected( $options[ $args['label_for'] ], 'red', false ) ) : ( '' ); ?>>
  76.             <?php esc_html_e( 'red pill', 'wporg' ); ?>
  77.         </option>
  78.          <option value="blue" <?php echo isset( $options[ $args['label_for'] ] ) ? ( selected( $options[ $args['label_for'] ], 'blue', false ) ) : ( '' ); ?>>
  79.             <?php esc_html_e( 'blue pill', 'wporg' ); ?>
  80.         </option>
  81.     </select>
  82.     <p class="description">
  83.         <?php esc_html_e( 'You take the blue pill and the story ends. You wake in your bed and you believe whatever you want to believe.', 'wporg' ); ?>
  84.     </p>
  85.     <p class="description">
  86.         <?php esc_html_e( 'You take the red pill and you stay in Wonderland and I show you how deep the rabbit-hole goes.', 'wporg' ); ?>
  87.     </p>
  88.     <?php
  89. }
  91. /**
  92.  * Add the top level menu page.
  93.  */
  94. function wporg_options_page() {
  95.     add_menu_page(
  96.         'WPOrg',
  97.         'WPOrg Options',
  98.         'manage_options',
  99.         'wporg',
  100.         'wporg_options_page_html'
  101.     );
  102. }
  104. /**
  105.  * Register our wporg_options_page to the admin_menu action hook.
  106.  */
  107. add_action( 'admin_menu', 'wporg_options_page' );
  109. /**
  110.  * Top level menu callback function
  111.  */
  112. function wporg_options_page_html() {
  113.     // check user capabilities
  114.     if ( ! current_user_can( 'manage_options' ) ) {
  115.         return;
  116.     }
  118.     // add error/update messages
  120.     // check if the user have submitted the settings
  121.     // WordPress will add the "settings-updated" $_GET parameter to the url
  122.     if ( isset( $_GET['settings-updated'] ) ) {
  123.         // add settings saved message with the class of "updated"
  124.         add_settings_error( 'wporg_messages', 'wporg_message', __( 'Settings Saved', 'wporg' ), 'updated' );
  125.     }
  127.     // show error/update messages
  128.     settings_errors( 'wporg_messages' );
  129.     ?>
  130.     <div class="wrap">
  131.         <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
  132.         <form action="options.php" method="post">
  133.             <?php
  134.             // output security fields for the registered setting "wporg"
  135.             settings_fields( 'wporg' );
  136.             // output setting sections and their fields
  137.             // (sections are registered for "wporg", each field is registered to a specific section)
  138.             do_settings_sections( 'wporg' );
  139.             // output save settings button
  140.             submit_button( 'Save Settings' );
  141.             ?>
  142.         </form>
  143.     </div>
  144.     <?php
  145. }