如何隐藏 WordPress 管理栏？

本文介绍如何通过正确编写 PHP 代码，在 functions.php 中实现仅对非管理员用户隐藏 WordPress 管理栏（Admin Bar），避免因混用 PHP 与 CSS 导致的语法错误。

本文介绍如何通过正确编写 PHP 代码，在 functions.php 中实现仅对非管理员用户隐藏 WordPress 管理栏（Admin Bar），避免因混用 PHP 与 CSS 导致的语法错误。

您遇到的错误——syntax error, unexpected '<', expecting end of file——根本原因在于：您将纯 CSS 样式代码（如 #wp-admin-bar-wp-logo{display: none;}）直接写进了 PHP 文件（functions.php）中，且未包裹在 PHP 输出或钩子逻辑内。functions.php 是一个 PHP 执行环境，不支持裸写 CSS；浏览器端生效的样式必须通过 <style> 标签输出、CSS 文件引入，或使用 WordPress 提供的钩子动态控制。

✅ 正确做法是：使用 show_admin_bar 过滤器控制管理栏的显示逻辑，而非尝试用 CSS 隐藏其 DOM 元素。这样既安全、高效，又符合 WordPress 最佳实践。

以下是在主题 functions.php 中添加的推荐代码：

/**
 * 仅对管理员显示 WordPress 管理栏，其他已登录用户完全隐藏
 */
function prefix_hide_admin_bar( $show ) {
    // 若当前用户不具备 'administrator' 能力，则强制隐藏管理栏
    if ( ! current_user_can( 'administrator' ) ) {
        return false;
    }
    return $show;
}
add_filter( 'show_admin_bar', 'prefix_hide_admin_bar' );

? 关键说明：

• current_user_can( 'administrator' ) 判断的是用户是否拥有 administrator 角色（注意引号内是角色名字符串，不是能力名如 manage_options；若需更精细权限控制，可改用 current_user_can('manage_options')）。
• 此方案彻底移除管理栏 HTML 和相关 JS/CSS 加载，比 CSS 隐藏更轻量、更安全（避免前端绕过）。
• 函数名前缀 prefix_ 建议替换为您主题的唯一前缀（如 mytheme_），防止插件或子主题冲突。

⚠️ 注意事项：

• 不要将此代码放在 <?php ... ?> 外部，确保整个函数定义和 add_filter() 调用都在 PHP 开始标签内；
• 修改前请备份 functions.php；
• 若使用子主题，请务必在子主题的 functions.php 中添加，而非父主题（避免更新丢失）；
• 测试时请使用非管理员账号（如编辑、作者）登录验证效果，管理员账号仍可见管理栏。

? 进阶提示（可选）：
若您希望保留部分管理栏项目（如“退出”链接）给普通用户，应改用 admin_bar_menu 动作钩子进行精细化移除，而非全局隐藏。但对大多数场景，“仅管理员可见”是最简洁、最安全的方案。

总之，WordPress 的核心原则是：用逻辑控制行为，而非用 CSS 修补表现。遵循这一原则，即可避免语法错误、提升代码健壮性，并为后续维护打下坚实基础。