
wordpress 插件中使用 `admin_notices` 钩子输出提示消息时,若未包裹在 `.wrap` 容器内,会导致通知全宽显示、遮挡侧边栏或脱离主内容区(`#wpbody-content`),根本原因是该钩子触发过早,此时 wordpress 管理后台主体结构尚未渲染。
在 WordPress 后台,标准的通知(如更新成功、设置保存提示)之所以能精准嵌入主内容区域,是因为它们被包裹在
你当前的代码直接将
✅ 正确做法:不直接在 admin_notices 中输出通知 HTML,而是通过自定义钩子 + 包裹容器进行可控注入。推荐采用以下结构:
千博企业网站管理系统标准版2013 Build0206
系统简介 千博企业建站系统是根据企业客户实际应用需求而提供的一套完整的中小企业网站应用解决方案,协助企业对公司产品进行更深层次的展示、推广。 千博企业建站系统主要面向企业进行产品展示、推广、企业形象展示而设计研发,系统界面简洁大方,管理操作非常简易,可高效构建企业、行业、律师、医院、政府信息门户网站、内部知识网站、信息门户等平台,并内置了专业的内容管理功能模块,可为浏览网站的顾客提供全方位的导购服
下载
';
do_action('customer_admin_notices');
echo '? 关键说明:
- customer_admin_notices 是你自定义的动作钩子,用于解耦通知内容与容器结构;
- admin_notices 仅用于触发 customer_admin_notice_wrapper(),后者负责输出 并调用你的通知;
- 使用 esc_html() 和 esc_attr() 对输出内容做基础转义,防止 XSS 风险;
- switch 替代长 if/else if 提升可读性与可维护性;
- did_action('in_admin_header') 可选增强判断,确保仅在管理页头已加载后执行(进一步规避时机问题)。
⚠️ 注意事项:
- 不要在 admin_notices 回调中直接 echo 多个 .wrap,否则可能嵌套混乱;
- 若需动态控制通知显示(如仅在特定页面显示),应在 customer_admin_notice_wrapper() 中添加 get_current_screen() 判断;
- 建议配合 wp_die() 或 wp_redirect() 后的 add_settings_error() + settings_errors() 实现更规范的设置页通知流(适用于选项页面);
- is-dismissible 类需配合 JS 手动绑定关闭逻辑(WordPress 默认不自动处理自定义通知的 dismiss),如需支持关闭,请添加 JavaScript 移除对应 DOM 节点并调用 wp.ajax.post() 记录用户偏好。
通过此方案,你的通知将严格对齐 WordPress 官方 UI 规范,正确显示在主内容区顶部,具备完整样式、交互与可访问性支持。









