WordPress函数get_pages详细用法教程解析

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()函数可用于获取页面的信息，可以通过传递不同的参数来筛选和排序页面。返回一个页面对象数组，可以根据需要进行处理和显示。