wp_insert_post( array $postarr, bool $wp_error = false, bool $fire_after_hooks = true ): int|WP_Error

使用示例

• 示例1

  插入带有自定义分类的文章和文章数meta据（自4.4.0起）：

  $hierarchical_tax = array( 13, 10 ); // Array of tax ids.
  $non_hierarchical_terms = 'tax name 1, tax name 2'; // Can use array of ids or string of tax names separated by commas
  
  $post_arr = array(
  	'post_title'   => 'Test post',
  	'post_content' => 'Test post content',
  	'post_status'  => 'publish',
  	'post_author'  => get_current_user_id(),
  	'tax_input'    => array(
  		'hierarchical_tax'     => $hierarchical_tax,
  		'non_hierarchical_tax' => $non_hierarchical_terms,
  	),
  	'meta_input'   => array(
  		'test_meta_key' => 'value of test_meta_key',
  	),
  );

• 示例2

  只有当具有“assign_terms”访问权限的用户调用函数时，参数中的‘tax_input’才能在wp_insert_post上工作

• 示例3

  插入文章

  在调用wp_insert_post()之前，需要创建一个数组来传递组成文章的必要元素。wp_insert_post()将填写这些元素的默认列表，但用户需要提供标题和内容，否则数据库写入将失败。

  下一个示例显示了要设置的文章标题、内容、状态、作者和文章类别。您可以添加更多的键值对，确保键与数据库中wp_posts表中列的名称匹配。

  // Gather post data.
  $my_post = array(
  	'post_title'    => 'My post',
  	'post_content'  => 'This is my post.',
  	'post_status'   => 'publish',
  	'post_author'   => 1,
  	'post_category' => array( 8,39 )
  );
  
  // Insert the post into the database.
  wp_insert_post( $my_post );

  您还可以在插入新文章后获取新文章ID：

  $post_id = wp_insert_post( $post, $wp_error );

• 示例4

  重要的是，在使用之前，通过检查返回的值是否是WP_error，

  $args = array(
    'post_type' => 'my_custom_post',
    /*other default parameters you want to set*/
  );
  $post_id = wp_insert_post($args);
  if(!is_wp_error($post_id)){
    //the post is valid
  }else{
    //there was an error in the post insertion, 
    echo $post_id->get_error_message();
  }

• 示例5

  正如@KieraHowe出色地注意到的，‘tax_input’需要‘assign_terms’访问。

  一个快速的解决方案是：

  wp_set_object_terms( $post_id, array( $term_id1, $term_id2 ), 'tax_slug' );

• 示例6

  还应说明post_template参数。

  应该使用完整的文件名进行设置，例如“templatefilename.php”。

  这一澄清将帮助开发人员尝试将模板绑定到页面。

• 示例7

  默认情况下，wp_insert_post不会插入空文章。如果您正在传递一个ID并期望它返回到wp_update_post，这可能会导致意外的问题。例如，以下操作将不起作用：

  wp_insert_post( array( 'ID' => 2, 'post_parent' => 1 ) );

  您需要直接调用wp_update_post。

  wp_update_post( array( 'ID' => 2, 'post_parent' => 1 ) );

• 示例8

  保存包含斜杠的数据时，请记住添加额外的斜杠，因为wp_insert_post会清除一次斜杠。

  $regex = '(\b16-\d{3}\b)';
  $post_data = array(
      'post_title' => 'Test regex',
      'post_content' => $regex,
      'post_type' => 'post',
  );
  $post_id = wp_insert_post( $post_data );

  将存储(b16-d{3}b)。要解决此问题，请使用wp_slash()：

  $regex = '(\b16-\d{3}\b)';
  $post_data = array(
      'post_title' => 'Test regex',
      'post_content' => wp_slash( $regex ),
      'post_type' => 'post',
  );
  $post_id = wp_insert_post( $post_data );

• 示例9

  post_date和post_date_gmt输入的格式是Y-m-d H:i:s，例如2019-01-01 01:01:01。您可以使用PHP的date函数，如下所示：

  wp_insert_post( array(
      'post_date' => date( 'Y-m-d H:i:s', time() ),
      // etc
  ) );

• 示例10

  关于分类模式参数
  参数：'tax_input' (array) Array of taxonomy terms keyed by their taxonomy name. Default empty.

  参数‘tax_input’的描述没有明确说明，到目前为止没有给出任何示例，因此我想在这里补充说明确切的含义和示例。

  根据‘wp_insert_post()’的源代码，‘tax_input’由函数‘wp_set_post_terms()’添加。所以我参考了它的描述，下面是使用它的示例：

  'tax_input' => array( $taxomony => $tags )

  • $taxomony – (string) 分类模式名称 $tags – (string|array) 要为文章设置的分类项数组，或用逗号分隔的字符串。 (tags)
    例如
    

    'something1, something2, something3'

    或

    array( 30, 40, 50 )

    或

    array( 'something1', 'something2', 'something3' )

  • 有分层级的分类模式 （类别） 必须始终传递ID，而不是名称，以便同名但父级不同的子级不会混淆。例如

    array( 30, 40, 50 )

  测试：我已经在一个带有自定义类别（分类模式）名称的自定义文章类型中使用wp_update_post()对其进行了个人测试

• 示例11

  使用自定义文章类型添加分类和meta字段值。

  对于分类：
  请确保分类名称是tax_input数组的键。而分类的ID数组是该键的值，如下面的示例所示。

  对于meta值：
  您可以将meta值名称作为键传递，将meta值作为键值传递。

  $post_arr = array(
  				'post_title'   => esc_html($video_title),
  				'post_content' => $video_description,
  				'post_status'  => 'draft',
  				'post_author'  => $user_id,
  				'post_type'	   => 'videos',
  				'tax_input'    => array(
  					"video_category" => $taxnomy_ids //Video Cateogry is Taxnmony Name and being used as key of array.
  				),
  				'meta_input'   => array(
  					'wc_video_url' => $video_url,
  					'wc_product'   => $video_product
  				),
  			);

• 示例12

  如果您正在创建一篇文章，但文章ID尚不存在，则使用'ID' => your_number不会创建新的文章。它将返回空白，因为它搜索了ID，但它不存在。

  而是像这样使用'import_id'：

  $args = array(
  	'import_id'    => your_custom_integer, 	// this designates the custom post ID you want to use! make sure it's unique
  	'post_type'	   => 'your_post_type',
  	'post_status'  => 'publish',
  	'content'	   => 'your_content',
  	'meta_input'   => array(
  		'product_data' => 'if_you_want_this'
  	)
  );
  
  $id = wp_insert_post($args);

• 示例13

  防止重复文章

  // Product Title
  $post_title = 'Test Product';
  
  // Add Product
  $new_post = array(
      'post_title' => $post_title,
      'post_type' => 'product',
      'post_staus' => 'draft', 
      'post_content' => 'Lorem Ipsum is simply dummy text of the printing and typesetting industry.',
      'post_excerpt' => 'Lorem Ipsum is simply dummy text'
  );
  
  // Catch post ID
  $post_id = post_exists( $post_title ) or wp_insert_post( $new_post );

• 示例14

  直接插入id为32的现有附件作为文章缩略图。

  $thumbnail_id = 32;
  
  $args = array(
      'post_type' => 'post',
      'post_title' => 'Some title',
      'post_content' => 'Some content',
      '_thumbnail_id' => $thumbnail_id,
  );
  
  wp_insert_post( $args );

• 示例15

  为自定义文章类型创建文章：

  $id = wp_insert_post(array('post_title'=>'random', 'post_type'=>'custom_post', 'post_content'=>'demo text'));

• 示例16

  注意当使用wp_insert_post()更新文章时，如果您没有明确指定post_status，它会将其改回“草稿”。

  我最终使用了wp_update_post()。

• 示例17

  要使用此函数，您应该

  $_POST

    $post_title = $_POST['title'];
    $post_description = $_POST['content'];
    $post_posted_id = $_POST['user_id'];
    $post_categories = $_POST['term'];
    $post_options = array();
  
    if( !empty($post_description) ) {
      $post_options['post_content'] = wp_strip_all_tags(post_description);
    }
  
    if( !empty($post_title) ) {
      $post_options['post_title'] = wp_strip_all_tags($post_title);
      // Then start to add new post
      $post_id = wp_insert_post($post_options);
      // Then return JSON in case you are using AJAX
  
      if( !is_wp_error($post_id) ) {
        wp_send_json_success(array('post_id' => $post_id), 200);
      } else {
        wp_send_json_error($post_id->get_error_message());
      }
    }

  第二件事，如果您推送多个参数，如选中多个复选框，您应该知道如何推送到数组：

  示例标记：

  <?php
  // Existing Bootstrap 4 markup
  if( !empty($languages) ) : ?>
    <?php foreach($languages as $key => $language) : ?>
      <div class="form-check">
        <input class="form-check-input" type="checkbox" value="<?php echo $language['id']; ?>" id="term[language][<?php echo $key; ?>]" name="term[language][]">
        <label class="form-check-label" for="term[language][<?php echo $key; ?>]"><?php echo $language['name']; ?></label>
      </div>
    <?php endforeach; ?>
  <?php endif; 
  // The result you got term[language] = [11, 13, 14];
  ?>

  我们应该检查并使用此函数以确保其工作：

  <?php
  // Function hint: wp_ajax_
  // Function hint: wp_ajax_nopriv_
  
  $post_terms = $_POST['term'];
  if( !empty($post_terms) ) {
    foreach($post_terms as $key => $category) {
      if( $post_options['tax_input'][$key] !== '' ) {
        $post_options['tax_input'][$key] = array($category);
      } else {
        array_push($post_options['tax_input'][$key], $category);
      }
    }
  }
  ?>

• 示例18

  此代码段创建了一篇文章，代码在创建之前检查该文章是否已存在。

  function create_wordpress_post_with_code() {
      
          // Set the post ID to -1. This sets to no action at moment
          $post_id = -1;
      
          // Set the Author, Slug, title and content of the new post
          $author_id = 1;
          $slug = 'wordpress-post-created-with-code';
          $title = 'WordPress post created whith code';
          $content = 'This is the content of the post that we are creating right now with code. 
                      More text: I motsetning til hva mange tror, er ikke Lorem Ipsum bare tilfeldig tekst. 
                      Dets røtter springer helt tilbake til et stykke klassisk latinsk litteratur fra 45 år f.kr., 
                      hvilket gjør det over 2000 år gammelt. Richard McClintock - professor i latin ved Hampden-Sydney 
                      College i Virginia, USA - slo opp flere av de mer obskure latinske ordene, consectetur, 
                      fra en del av Lorem Ipsum, og fant dets utvilsomme opprinnelse gjennom å studere bruken 
                      av disse ordene i klassisk litteratur. Lorem Ipsum kommer fra seksjon 1.10.32 og 1.10.33 i 
                      "de Finibus Bonorum et Malorum" (The Extremes of Good and Evil) av Cicero, skrevet i år 45 f.kr. 
                      Boken er en avhandling om teorier rundt etikk, og var veldig populær under renessansen. Den første 
                      linjen av Lorem Ipsum, "Lorem Ipsum dolor sit amet...", er hentet fra en linje i seksjon 1.10.32.';
          // Cheks if doen't exists a post with slug "wordpress-post-created-with-code".
          if( !post_exists_by_slug( $slug ) ) {
              // Set the post ID
              $post_id = wp_insert_post(
                  array(
                      'comment_status'	=>	'closed',
                      'ping_status'		=>	'closed',
                      'post_author'		=>	$author_id,
                      'post_name'		    =>	$slug,
                      'post_title'		=>	$title,
                      'post_content'      =>  $content,
                      'post_status'		=>	'publish',
                      'post_type'		    =>	'post'
                  )
              );
          } else {
      
                  // Set pos_id to -2 becouse there is a post with this slug.
                  $post_id = -2;
          
          } // end if
      
      } // end oaf_create_post_with_code
   add_filter( 'after_setup_theme', 'create_wordpress_post_with_code' );
   /**
   * post_exists_by_slug.
   *
   * @return mixed boolean false if no post exists; post ID otherwise.
   */
  function post_exists_by_slug( $post_slug ) {
      $args_posts = array(
          'post_type'      => 'post',
          'post_status'    => 'any',
          'name'           => $post_slug,
          'posts_per_page' => 1,
      );
      $loop_posts = new WP_Query( $args_posts );
      if ( ! $loop_posts->have_posts() ) {
          return false;
      } else {
          $loop_posts->the_post();
          return $loop_posts->post->ID;
      }
  }