get_pages()函数用于获取所有页面的信息,返回一个页面对象数组。

使用方法:

$pages = get_pages( $args );

参数说明:
- $args (array):可选参数,用于设置获取页面的条件。
- child_of (int):父页面的ID,只获取子页面。
- sort_order (string):页面的排序方式,默认为“ASC”(升序),可设置为“DESC”(降序)。
- sort_column (string):按照哪一列进行排序,默认为“post_title”(根据页面标题排序),可选值有“post_author”(根据作者排序)、“menu_order”(根据菜单顺序排序)等。
- include (array):包含指定页面的ID。
- exclude (array):排除指定页面的ID。
- meta_key (string):根据自定义字段进行筛选,可与meta_value一起使用。
- meta_value (string):根据自定义字段的值进行筛选,可与meta_key一起使用。
- authors (array):只获取指定作者的页面。
- parent (int):只获取指定父页面ID的页面。
- exclude_tree (string):排除指定页面及其所有子页面。
- number (int):获取指定数量的页面,默认为-1(获取所有页面)。
- offset (int):跳过指定数量的页面。
- post_type (string|array):页面的类型,默认为“page”。
- post_status (string|array):页面的状态,默认为“publish”。

返回值:
- 成功:一个页面对象数组。
- 失败:空数组或false。

示例用法:
1. 获取所有页面:

$pages = get_pages();
foreach( $pages as $page ){
echo $page->post_title;
}

2. 获取指定父页面下的子页面:

$args = array(
'child_of' => 5, // 父页面ID为5
);
$pages = get_pages( $args );
foreach( $pages as $page ){
echo $page->post_title;
}

3. 获取并按照菜单顺序排序的页面:

$args = array(
'sort_column' => 'menu_order',
);
$pages = get_pages( $args );
foreach( $pages as $page ){
echo $page->post_title;
}

总结:
get_pages()函数可用于获取页面的信息,可以通过传递不同的参数来筛选和排序页面。返回一个页面对象数组,可以根据需要进行处理和显示。