WordPress常用函数get children
导航: 上一页 | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy
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', );
参数[ ]
参数完全列表参见 get_posts() 在2.6版本中需要传递非空的post_type参数(也可以是附件或页面)。
$args
(混合)传递一个[http://codex.wordpress.org/Template_Tags/How_to_Pass_Tag_Parameters#Tags_with_query-string-style_parameters 查询类型的字符或数组]后可设置若干参数(如下)。传递整数文章编号或文章对象,可检索到该文章的子文章;传递空值则检索最新文章或页面的子文章或页面。
$args['numberposts']
(整数)需要检索的子文章数量。可选;默认值:-1(无限)
$args['post_parent']
(整数)传递日志或页面的编号以获取其子文章。传递空值可获取任意文章的子文章。可选;默认值:0 (任意父文章?)
$args['post_type']
(字符)文章列表中post_type列中的值,如附件,页面或修改情况;或者关键词any。
默认值:any
$args['post_status']
(字符)文章列表中post_status列中的值,如已发布,草稿或遗传;或关键词any。默认值:any
$args['post_mime_type']
(字符)完全或不完全的mime类型,如图片,视频,视频/mp4,与文章的post_mime_type字段相匹配。
$output
(常量)由OBJECT, ARRAY_A, ARRAY_N中任一个函数所返回的数组项的变量类型。可选;默认值:OBJECT
相关函数
get_children( )调用get_posts() ,后者又调用 $WP_Query->get_posts() 。