编辑“WordPress常用函数get children”

<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>导航:</strong> [[WordPress常用函数(上)|
上一页]] | {{Template:WordPress导航}}</span>
<div style="clear:both;"></div>

get_children( )检索附件、版本、子页面等信息，一般情况下由父文章执行。

get_children( )与get_posts( )运行基本一致。

==简介==
array|false $children =& get_children( mixed $args = "", constant $output = OBJECT);

'''返回的值'''
返回文章的关联数组（由$output参数设置的变量类型），其中文章编号作为数组的key，如果未找到相应文章返回false。

==示例==
 $images =& get_children( 'post_type=attachment&post_mime_type=image' );    
 $videos =& get_children( '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 );  
 }

===默认参数（2.7版本）===
 $defaults = array(   
      'post_parent' => 0,  'post_type' => 'any',       
    'numberposts' => -1,      
    'post_status' => 'any',  
 );

==参数==
参数完全列表参见 [http://codex.wordpress.org/Template_Tags/get_posts get_posts()]
在[http://codex.wordpress.org/Version_2.6 2.6版本]中需要传递非空的post_type参数（也可以是附件或页面）。

<STRONG>$args</STRONG>

(混合）传递一个[http://codex.wordpress.org/Template_Tags/How_to_Pass_Tag_Parameters#Tags_with_query-string-style_parameters 
查询类型的字符或数组]后可设置若干参数（如下）。传递整数文章编号或文章对象，可检索到该文章的子文章；传递空值则检索最新文章或页面的子文章或页面。

<STRONG>$args['numberposts']</STRONG>

(整数）需要检索的子文章数量。可选；默认值：-1（无限）

<STRONG>$args['post_parent']</STRONG>

（整数）传递日志或页面的编号以获取其子文章。传递空值可获取任意文章的子文章。可选；默认值：0 （任意父文章？）

<STRONG>$args['post_type</STRONG><STRONG>']</STRONG>

(字符）文章列表中post_type列中的值，如附件，页面或修改情况；或者关键词any。

默认值：any

<STRONG>$args['post_status']</STRONG>

(字符）文章列表中post_status列中的值，如已发布，草稿或遗传；或关键词any。默认值：any

<STRONG>$args['post_mime_type']</STRONG>

（字符）完全或不完全的mime类型，如图片，视频，视频/mp4，与文章的post_mime_type字段相匹配。

<STRONG>$output </STRONG>

(常量）由OBJECT, ARRAY_A, ARRAY_N中任一个函数所返回的数组项的变量类型。可选；默认值：OBJECT

<H3>相关函数</H3>
get_children( )调用[http://codex.wordpress.org/Template_Tags/get_posts get_posts()] ，后者又调用 [http://codex.wordpress.org/Function_Reference/WP_Query#Methods $WP_Query-&gt;get_posts()] 。

[http://codex.wordpress.org/Template_Tags/wp_get_attachment_link wp_get_attachment_link()]

==相关条目==
*[[Drupal]] 
*[[OBLOG]] 
*[[X-Space]] 
*[[SaBlog-X]] 
*[[Bo-Blog]]

[[category:WordPress中文文档|G]]
[[category:WordPress网站开发|G]]
[[category:WordPress开发文档|G]]