wp_list_pages() 是 WordPress 中用于生成页面导航列表的函数。它允许你轻松地列出你的 WordPress 站点中的页面,并将它们格式化为 HTML 列表。以下是 wp_list_pages()

wordpress页面导航调用函数wp_list_pages()使用说明

函数的基本使用说明:

<?php
$args = array(
    'depth'        => 0, // 显示的页面层级深度,0 表示显示所有页面
    'show_date'    => '',
    'date_format'  => get_option('date_format'),
    'child_of'     => 0, // 显示指定页面的子页面,默认为 0(显示顶级页面)
    'exclude'      => '',
    'title_li'     => __('Pages'), // 页面导航列表的标题
    'echo'         => 1, // 是否直接输出页面导航列表
    'authors'      => '', // 按作者 ID 过滤页面
    'sort_column'  => 'menu_order, post_title', // 页面排序方式
    'link_before'  => '', // 链接前置文本
    'link_after'   => '', // 链接后置文本
    'walker'       => '', // 自定义 Walker 类(用于自定义输出)
);

wp_list_pages($args);
?>

上面的代码片段演示了如何使用 wp_list_pages() 函数。你可以将这个代码片段插入到你的 WordPress 主题模板文件中,以在页面中显示页面导航列表。以下是一些常用参数的说明:

  1. depth: 用于指定显示的页面层级深度,0 表示显示所有页面。

  2. child_of: 用于指定显示哪个页面的子页面。默认为 0,表示显示顶级页面。

  3. title_li: 用于设置页面导航列表的标题。

  4. sort_column: 用于指定页面的排序方式,默认是根据菜单顺序(menu_order)和页面标题(post_title)排序。

  5. link_beforelink_after: 可以在每个页面链接之前和之后添加自定义文本。

  6. walker: 用于自定义输出的 Walker 类。你可以创建一个自定义 Walker 类来完全控制页面导航列表的输出。

你可以根据你的需求自定义这些参数,以满足你的页面导航列表的特定要求。希望这个说明能帮助你使用 wp_list_pages() 函数在 WordPress 网站中生成页面导航。