wp_insert_post

パラメータ

• $postarr
  投稿情報を連想配列で指定。連想配列の内容（抜粋）は次の通り。

  キー名	省略時の値	内容
  'post_status'	'draft'	投稿ステータス（'draft'、'publish'、'private'、'future'など）
  'post_type'	'post'	投稿タイプ（'post'、'page'、カスタム投稿タイプ名など）
  'post_author'	$user_ID	投稿者ID
  'ping_status'	get_option( 'default_ping_status' )	デフォルトのピンステータス
  'post_parent'	0	親の投稿情報ID
  'menu_order'	0	メニューの表示順
  'to_ping'	''
  'pinged'	''
  'post_password'	''	パスワードによるアクセス制限時のパスワード
  'guid'	''
  'post_content_filtered'	''
  'post_excerpt'	''	抜粋
  'import_id'	0	新しい投稿情報ID（未使用のID）
  'post_content'	''	投稿記事
  'post_title'	''	タイトル
  'ID'	―	投稿情報ID
  'post_category'	―	カテゴリーIDの配列
  'tags_input'	―	投稿タグの文字列（複数の場合は,（カンマ）区切り）
  'comment_status'	―	コメントステータス（'open'、'closed'など）
  'post_date'	―	投稿日時

• $wp_error
  登録失敗時にエラー内容を示す WP_Errorオブジェクトを返す場合はtrueを、0を返す場合はfalseを指定（省略時はfalse）
• $fire_after_hooks
  [5.6.0]投稿情報とその関連情報の保存後に wp_after_insert_post関数を呼び出す場合はtrueを指定（省略時はtrue）。

返り値

注意

$post_category = array( get_option('default_category') );
$comment_status = get_option( 'default_comment_status' );
$ping_status = get_option( 'default_ping_status' );

使用例

• 投稿情報としてタイトルと内容を登録する。
  <?php $post_id = wp_insert_post( array( 'post_title'=>'テスト投稿', 'post_content'=>'この投稿はテストです。' ) ); ?>
• 投稿情報として$postarrを登録する。登録できなかった場合はエラー内容を取得する。
  <?php $post_id = wp_insert_post( $postarr, true ); ?>

フィルター

$data = apply_filters( 'wp_insert_attachment_data', $data, $postarr, $unsanitized_postarr, $update );

$data = apply_filters( 'wp_insert_post_data', $data, $postarr, $unsanitized_postarr, $update );

if ( apply_filters( 'wp_insert_post_empty_content', $maybe_empty, $postarr ) ) {

$post_parent = apply_filters( 'wp_insert_post_parent', $post_parent, $post_ID, compact( array_keys( $postarr ) ), $postarr );

アクション

do_action( 'pre_post_update', $post_ID );

do_action( "edit_post_{$post->post_type}", $post_ID, $post );

do_action( 'edit_post', $post_ID, $post );

do_action( 'post_updated', $post_ID, $post_after, $post_before );

do_action( "save_post_{$post->post_type}", $post_ID, $post, $update );

do_action( 'save_post', $post_ID, $post, $update );

do_action( 'wp_insert_post', $post_ID, $post, $update );

ソースファイル