get_children( mixed $args = '', string $output = OBJECT )

使用示例

• 示例1

  get_children()返回的每个项目都有以下值（显示的名称从ARRAY_A映射；相同的名称与OBJECT一起使用）：

  array(24) {
["ID"] => (int)
["post_author"] => (string)
["post_date"] => (string)
["post_date_gmt"] => (string)
["post_content"] => (string)
["post_title"] => (string)
["post_excerpt"] => (string)
["post_status"] => (string)
["comment_status"] => (string)
["ping_status"] => (string)
["post_password"] => (string)
["post_name"] => (string)
["to_ping"] => (string)
["pinged"] => (string)
["post_modified"] => (string)
["post_modified_gmt"] => (string)
["post_content_filtered"] => (string)
["post_parent"] => (int)
["guid"] => (string)
["menu_order"] => (int)
["post_type"] => (string)
["post_mime_type"] => (string)
["comment_count"] => (string)
["filter"] => (string)
}

• 示例2

  显示与文章相关的第一个图像

  此函数用于检索与文章相关联的第一个图像

  <?php
  /**
   * Echo first image (if available).
   *
   * @param int $post_id Post ID.
   */
  function wpdocs_echo_first_image( $post_id ) {
  	$args = array(
  		'posts_per_page' => 1,
  		'order'          => 'ASC',
  		'post_mime_type' => 'image',
  		'post_parent'    => $post_id,
  		'post_status'    => null,
  		'post_type'      => 'attachment',
  	);
  
  	$attachments = get_children( $args );
  
  	if ( $attachments ) {
  		foreach ( $attachments as $attachment ) {
  			$image_attributes = wp_get_attachment_image_src( $attachment->ID, 'thumbnail' ) ? wp_get_attachment_image_src( $attachment->ID, 'thumbnail' ) : wp_get_attachment_image_src( $attachment->ID, 'full' );
  			echo '<img src="' . esc_url( wp_get_attachment_thumb_url( $attachment->ID ) ) . '" class="current" />';
  		}
  	}
  }
  

• 示例3

  显示与文章相关的第一个图像，并重新设置数组的关键帧

  在上面的例子中，一个主数组是用图像ID（正是正在寻找的东西-因为我们不知道它-我们应该如何访问它？）。下面的代码为图像信息提供了更简单的处理：数组$child_image。应在循环中使用。

  $args = array(
  	'posts_per_page' => 1,
  	'order'          => 'DESC',
  	'post_mime_type' => 'image',
  	'post_parent'    => $post->ID,
  	'post_type'      => 'attachment'
  	);
  
  $get_children_array = get_children( $args,ARRAY_A );  //returns Array ( [$image_ID].
  
  $rekeyed_array = array_values( $get_children_array );
  $child_image   = $rekeyed_array[0];  
  
  print_r( $child_image );  	//Show the contents of the $child_image array.
  echo $child_image['ID'];   	//Show the $child_image ID.
  

• 示例4

  获取所有父文章ID

  $post_type ="post"; //page, or custom_post_type
  $post_status = "any"; //publish, draft, etc
  $num_of_posts = -1; // -1 for all, or amount # to return
  $post_parent = 0; //0 for parents, or and id
  
  $args = array('post_parent' => 0, 'post_type' => $post_type, 'numberposts' => $num_of_posts, 'post_status' => $post_status);
  
  $parents = get_children($args);
  
  foreach ($parents as $parent) {
   echo "<br>ParentID: ".$parent->ID;
  }
  

• 示例5

  这对于从文章中提取第一个图像是不安全的

  正如所给的名称一样，该函数实际上从父对象返回子对象。这意味着，如果你在新文章中重复使用图像，它将不会返回图像。例如：

  首先，创建一篇新文章A并上传这些图片A01.jpg，A02.jpg和A03.jpg到文章A。然后这些图片，或者说附件（A01、A02、A03）是文章A的子项。有了它，我们可以从循环中的文章A中检索图像A01。这是一种常见的替换缩略图的方法，以防作者忘记添加缩略图。但是如果我们再发一篇文章呢？

  让我们创建第二篇文章B并重用文章A上传的图像（A01和A02）。在这种情况下，不会从get_children返回任何图像，因为图像A01和A02不是文章B的子对象。这意味着如果我们的主题设计肯定会被打破，因为在索引页面中的文章上没有可显示的图像。除非主题是针对特定情况设计的，并为用户提供了仔细的指导，否则此功能不应用于从文章中检索图像！

  <?php
  function print_first_kid_image_of_post($post_id) {
      $arr = array(
          'posts_per_page' => 1, # This param ensures only 1 post returned in the array
          'post_mime_type' => 'image',
          'post_parent'    => $post_id,
          'post_type'      => 'attachment',
      );
   
      $imgs = get_children($arr); # Return an array with an item
      $img = $imgs[0];
  
      $img_id = $img->ID;
  	$img_size = 'thumbnail'
  	echo wp_get_attachment_image($img_id, $img_size);
  }
  

  结果：
  1. 文章 A (上传图片：A1, A2, A3)：图片 A1
  2. 文章 B (重用的图片：A1, A2): NULL
  3. 文章 C (重用的图片：A1) (上传图片：C1, C2, C3)：图片 C1 (即使图片A1被放在上面，图片C1仍然会被返回，因为A1不是文章 C的子级。)
• 示例6

  要仅获取子ID数组，请在函数args数组中传递 ‘fields’ => ‘ids’

  get_children( [
  	'post_parent' 	=> $post_id,
  	'fields'        => 'ids',
  ] );
  

• 示例7

  示例

  如果您只想获取或显示附件，那么使用get_posts()可能会更容易一些。

  $images =& get_children( array(
  	'post_type'      => 'attachment',
  	'post_mime_type' => 'image'
  );
  
  $videos =& get_children( array(
  	'post_type'      => 'attachment',
  	'post_mime_type' => 'video/mp4'
  );
  
  if ( empty( $images ) ) {
  	// no attachments here
  } else {
  	foreach ( $images as $attachment_id => $attachment ) {
  		echo wp_get_attachment_image( $attachment_id, 'full' );
  	}
  }
  
  //  If you don't need to handle an empty result:
  
  foreach ( (array) $videos as $attachment_id => $attachment ) {
  	echo wp_get_attachment_link( $attachment_id );
  }