add_posts_page函数是WordPress中一个用于添加新的管理页面的函数。它的用法如下:
add_posts_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', int $position = null )
参数解析:
- $page_title(必需):新页面的标题,会显示在页面的顶部。
- $menu_title(必需):菜单项的显示文本,会显示在WordPress仪表盘中的侧边栏菜单上。
- $capability(必需):用户必须具备的权限才能访问该页面。默认情况下,只有管理员可以访问。
- $menu_slug(必需):菜单项的唯一标识,必须是独一无二的。用于定义菜单项的链接 URL。
- $function(可选):当用户访问该页面时要执行的回调函数。如果不提供该参数,会使用一个默认的回调函数来渲染页面内容。
- $position(可选):菜单项在侧边栏菜单中的位置。值越小,位置越靠前。默认为null,自动添加到菜单的末尾。
示例用法:
function my_custom_page_callback() {
echo '
Hello, this is my custom page!
';
}
add_action( 'admin_menu', 'my_custom_menu_page' );
function my_custom_menu_page() {
add_posts_page( 'Custom Page Title', 'Custom Menu Title', 'manage_options', 'my-custom-page', 'my_custom_page_callback' );
}
在上面的示例中,我们定义了一个名为`my_custom_page_callback`的回调函数来渲染页面内容。然后,我们使用`add_action`函数将该函数与`admin_menu`动作挂钩,以便在后台管理菜单中添加我们的自定义页面。最后,使用`add_posts_page`函数来添加自定义页面,我们设置了页面的标题为"Custom Page Title",菜单项的显示文本为"Custom Menu Title",用户需要具备"manage_options"权限才能访问该页面,菜单项的唯一标识为"my-custom-page",并且指定了我们刚刚定义的回调函数来渲染页面内容。
通过以上步骤,我们就成功地添加了一个新的管理页面,并且在后台管理菜单中显示出来。
0 个评论