用途:用于构建或调试 Perfex CRM 客户端区域自定义主题,涉及 assets/themes/<theme>/ 与 application/views/themes/<theme>/ 下的文件。
主要能力:主题目录结构与 functions.php 入口;通过 register_theme_assets_hook() 与 App_css/App_scripts 注册资源,处理缓存刷新与依赖分组;覆盖核心视图(复制 perfex 主题后修改,或用 my_ 前缀文件);暗色模式(语义化 CSS 变量 + [data-theme="dark"],首屏前应用属性避免 FOUC);RTL 支持;表单无障碍基线;更新安全的 CSS 覆盖(assets/css/custom.css 或内置 Theme Style 模块);Bootstrap 3 特异性冲突的三种策略(包装类作用域、命名空间 !important、@layer)。
必要用法:主题需在 application/views/themes/<theme>/ 下提供 functions.php,并从 perfex 主题复制 head.php、footer.php 等;通过 Setup → Settings → Customers → Theme 激活。资源应走注册表而非裸 <link>,依赖句柄须在同一分组(客户端分组为 common-js、theme-global-js、theme-clients-js)。jQuery Validate 会剥离提交按钮 name,需用隐藏 input 镜像意图。
限制:主题无法直接注册语言键,需配套模块或内联字符串;@layer 在旧浏览器回退;不要直接编辑核心视图或 perfex 主题,升级会被覆盖。具体版本兼容性以官方文档为准。