wp_insert_post（）の「meta_input」パラメーターは何に使用されますか？

関数wp_insert_post（）を使用して、ワードプレスに投稿を挿入しています。

各投稿にいくつかのカスタムフィールドを挿入し、ドキュメントを読みたいのですが、meta_infoパラメータが使用されていましたが、次のようなことを試しました。

$data = array(
        'post_author' => 1,
        'post_status' => 'publish',
        'post_title' => $post->getTitle(),
        'post_content' => $post->getContent(),
        'post_category' => $post->getCategory(),
        'tags_input' => $post->getTags(),
        'meta_input' => array( "_test" => "testx1" )
);

$postID = wp_insert_post( $data );

投稿は正しく挿入され、タグも付けられます。ただし、カスタムフィールドは追加されていません。add_post_meta（）を使用してそれらを追加できることはわかっていますが、投稿を挿入した後、データベースで「testx1」を検索し、結果が見つからなかったため、meta_inputパラメータの用途を知りたいと思っています。

のこの部分wp_insert_posts()はそれを提供します：

  if ( ! empty( $postarr['meta_input'] ) ) {
        foreach ( $postarr['meta_input'] as $field => $value ) {
            update_post_meta( $post_ID, $field, $value );
        }
  } 

ここで、投稿メタフィールドがでどのように更新/追加されるかを確認しupdate_post_meta()ます。

これはインライン記述ですmeta_input：

ポストメタキーをキーとするポストメタ値の配列。デフォルトは空です。

これはWordPress 4.4で追加されました。詳細については、関連するチケット＃20451をご覧ください。

メタキーの前にアンダースコアを使用すると、ポスト編集画面のカスタムフィールドメタボックス_testから非表示になることに注意してください。

私がそれをする方法は、スラッグではなくterm_idを介してであり、それは機能します：

//insert Art items into database
$arr = array('item 1', 'item 2');
// $arr = array('art item 1', 'art item 2');

foreach ($arr as $a) { 
    wp_insert_post(array(
    //essentials
    //'ID'      => 1131,
    'post_author'       => 1,
    'post_title'        => $a,
    'post_type'         => 'post',
    'post_content'      => 'Something...',
    'post_status'       => 'publish',
    'post_name'         => 'post name',
    'meta_input'        => array( //(array) Array of post meta values keyed by their post meta key. Default empty.
        'city'     => '',// 'name' => $post['name']
        'country'  => ''// 'city' => $post['city']
    ),
    'tax_input'    => array(
        'category' => array(33,32), //id numbers work, slugs tend to be ignored !!!
        'post_tag' => array('one', 'two') //for tags slugs seem to work
    ),//(array) Array of taxonomy terms keyed by their taxonomy name. Default empty. Equivalent to calling wp_set_post_terms() / wp_set_object_terms()
    //'tags_input'  => array('una', 'trei'), //(array) Array of tag names, slugs, or IDs. Default empty. Equivalent to calling wp_set_post_tags().
    ), true);   
}