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

wp_dropdown_pages() 函数用于生成一个下拉菜单（select 下拉列表），用于选择页面。

用法：
wp_dropdown_pages( $args )

参数说明：
$args（数组）：设置下拉菜单的选项。

常用选项参数：
- depth（整数）：设置下拉菜单的页面层级深度，默认值为 0，表示显示所有页面。例如，设置为 1 表示只显示一级页面。
- child_of（整数）：设置下拉菜单的起始页面，默认值为 0，表示从所有页面开始。例如，设置为 5 表示从页面 ID 为 5 的页面开始。
- exclude（字符串）：设置需要排除的页面 ID 列表，多个页面 ID 用逗号隔开。例如，设置为 '2,4,6' 表示排除页面 ID 为 2、4、6 的页面。
- selected（整数）：设置默认选中的页面 ID。例如，设置为 3 表示默认选中页面 ID 为 3 的页面。
- echo（布尔值）：设置是否直接输出下拉菜单，默认为 true，即直接输出。如果设置为 false，函数将返回生成的下拉菜单字符串。

示例用法：
1. 输出一个显示所有页面的下拉菜单：

wp_dropdown_pages();

2. 输出一个只显示一级页面的下拉菜单，并设置默认选中页面 ID 为 5：

$args = array(
'depth' => 1,
'selected' => 5
);
wp_dropdown_pages( $args );

3. 返回一个只显示指定页面的下拉菜单的字符串，并将其输出：

$args = array(
'child_of' => 8,
'echo' => false
);
$menu = wp_dropdown_pages( $args );
echo $menu;

注意事项：
- 使用 wp_dropdown_pages() 函数之前，必须在 WordPress 的 Loop（循环）之外调用 setup_postdata( $post ) 函数，以设置全局 $post 变量。
- 该函数仅应在后台管理页面中使用，如主题选项页面、自定义小工具等。在前台页面中使用时，请确保用户对显示的页面具有相应的权限。
- 可以通过使用 'option_none_value' 参数来设置无选择内容的值（默认为空字符串）。例如，设置为 -1 表示无选择内容。
- 若要将下拉菜单的值保存到数据库中，请使用会话或表单处理等技术来实现。