add_object_page函数是WordPress中用于添加一个菜单页面的函数,可以在后台管理界面的侧边栏添加自定义页面菜单链接。下面是add_object_page函数的详细用法解析:
add_object_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', string $icon_url = '', int $position = null )
参数解析:
- $page_title:(必填) 页面标题,会显示在浏览器标签栏和菜单栏中。
- $menu_title:(必填) 菜单标题,会显示在后台管理界面的侧边栏菜单中。
- $capability:(必填) 用户权限,控制哪些用户能够访问此自定义页面。
- $menu_slug:(必填) 菜单链接的唯一标识符,用于检索菜单项。
- $function:(可选) 页面显示的回调函数,可以用来显示页面内容。
- $icon_url:(可选) 菜单项图标的URL,用于显示在菜单中。
- $position:(可选) 菜单项的位置,数字越小越靠前。
示例代码:
function my_custom_page_content() {
// 在这里编写自定义页面的内容
echo "
Hello, World!
";
}
function add_my_custom_menu_page() {
add_object_page( 'My Custom Page', 'My Custom Menu', 'manage_options', 'my-custom-slug', 'my_custom_page_content', 'dashicons-admin-generic', 5 );
}
add_action( 'admin_menu', 'add_my_custom_menu_page' );
这段代码会在后台管理界面的侧边栏添加一个名为"My Custom Menu"的菜单项,点击菜单项会跳转到一个名为"My Custom Page"的自定义页面,页面内容为"Hello, World!"。菜单项的图标使用了`dashicons-admin-generic`,位置为5。
注意事项:
- 用户权限`capability`可以使用默认的WordPress用户角色,如`manage_options`表示管理员权限,也可以使用自定义的用户角色。
- 回调函数`function`参数可以为空,如果为空,则需要自定义页面模板来显示页面内容。
- 菜单项的位置`position`参数可以为空,如果为空,则按照默认顺序添加到菜单的最后。
- 菜单项的图标URL可以使用dashicons图标集中的任意图标,也可以使用自定义图标。
- 使用`admin_menu`动作钩子来添加自定义菜单页面,确保在后台管理界面初始化之后才执行。
0 个评论