当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「関数リファレンス/add meta box」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(翻訳完了)
 
(関連記事 リンク修正)
108行目: 108行目:
 
== 関連記事 ==
 
== 関連記事 ==
  
* [[Migrating Plugins and Themes]]
+
* [[プラグインとテーマの移行]]
* [[Function Reference]]
+
* [[関数リファレンス]]
 
* [[Creating Tables with Plugins]]
 
* [[Creating Tables with Plugins]]
* [[Function Reference/update post meta|update_post_meta() function]]
+
* [[関数リファレンス/update_post_meta|update_post_meta]] /[[:en:Function Reference/update post meta|en]]
* [[Function Reference/add post meta|add_post_meta() function]]
+
* [[関数リファレンス/add_post_meta|add_post_meta]] /[[:en:Function Reference/add post meta|en]]
  
 
== 外部リンク  ==
 
== 外部リンク  ==

2009年7月27日 (月) 09:29時点における版

説明

add_meta_box() は、WordPress 2.5 以降で利用できる関数です。プラグイン開発者は、記事投稿、ページ投稿、リンク編集画面にセクションを追加することができます。

使い方

%%% <?php add_meta_box( $id, $title, $callback, $page, $context, $priority ); ?> %%%

パラメータ

$id 
(文字列) 編集画面セクションの HTML ID
$title 
(文字列) 編集画面セクションのタイトル、画面上に表示される
$callback 
(文字列) 編集画面セクションに HTML 出力する関数
$page 
(文字列) 編集画面セクションを表示する画面のタイプ ('post', 'page', または 'link')
$context 
(文字列) 編集画面セクションが表示される部分 ('normal', 'advanced' または (2.7 以降) 'side')
$priority 
(文字列) ボックスが表示される優先度 ('high' または 'low')

用例

記事投稿画面とページ投稿画面にカスタムセクションを追加する例です。WordPress 2.5 やそれ以前のバージョン (add_meta_box が存在しない) でも動作します。

<?php
/* Use the admin_menu action to define the custom boxes */
add_action('admin_menu', 'myplugin_add_custom_box');

/* Use the save_post action to do something with the data entered */
add_action('save_post', 'myplugin_save_postdata');

/* Adds a custom section to the "advanced" Post and Page edit screens */
function myplugin_add_custom_box() {

  if( function_exists( 'add_meta_box' )) {
    add_meta_box( 'myplugin_sectionid', __( 'My Post Section Title', 'myplugin_textdomain' ), 
                'myplugin_inner_custom_box', 'post', 'advanced' );
    add_meta_box( 'myplugin_sectionid', __( 'My Post Section Title', 'myplugin_textdomain' ), 
                'myplugin_inner_custom_box', 'page', 'advanced' );
   } else {
    add_action('dbx_post_advanced', 'myplugin_old_custom_box' );
    add_action('dbx_page_advanced', 'myplugin_old_custom_box' );
  }
}
   
/* Prints the inner fields for the custom post/page section */
function myplugin_inner_custom_box() {

  // Use nonce for verification

  echo '<input type="hidden" name="myplugin_noncename" id="myplugin_noncename" value="' . 
    wp_create_nonce( plugin_basename(__FILE__) ) . '" />';

  // The actual fields for data entry

  echo '<label for="myplugin_new_field">' . __("Description for this field", 'myplugin_textdomain' ) . '</label> ';
  echo '<input type="text" name="myplugin_new_field" value="whatever" size="25" />';
}

/* Prints the edit form for pre-WordPress 2.5 post/page */
function myplugin_old_custom_box() {

  echo '<div class="dbx-b-ox-wrapper">' . "\n";
  echo '<fieldset id="myplugin_fieldsetid" class="dbx-box">' . "\n";
  echo '<div class="dbx-h-andle-wrapper"><h3 class="dbx-handle">' . 
        __( 'My Post Section Title', 'myplugin_textdomain' ) . "</h3></div>";   
   
  echo '<div class="dbx-c-ontent-wrapper"><div class="dbx-content">';

  // output editing form

  myplugin_inner_custom_box();

  // end wrapper

  echo "</div></div></fieldset></div>\n";
}

/* When the post is saved, saves our custom data */
function myplugin_save_postdata( $post_id ) {

  // verify this came from the our screen and with proper authorization,
  // because save_post can be triggered at other times

  if ( !wp_verify_nonce( $_POST['myplugin_noncename'], plugin_basename(__FILE__) )) {
    return $post_id;
  }

  if ( 'page' == $_POST['post_type'] ) {
    if ( !current_user_can( 'edit_page', $post_id ))
      return $post_id;
  } else {
    if ( !current_user_can( 'edit_post', $post_id ))
      return $post_id;
  }

  // OK, we're authenticated: we need to find and save the data

  $mydata = $_POST['myplugin_new_field'];

  // TODO: Do something with $mydata 
  // probably using add_post_meta(), update_post_meta(), or 
  // a custom table (see Further Reading section below)

   return $mydata;
}
?>

関連記事

外部リンク

最新英語版: WordPress Codex » Function_Reference/add_meta_box最新版との差分