⚡ 优化笔记

🔗 链接体验优化

• 后台站点预览：后台顶部栏的“查看站点”链接改为新标签页打开 (_blank)，避免覆盖后台页面 (boxmoe_adminbar_viewsite_newtab).
• 后台全站链接新窗口打开：

- 开关入口: 基础设置 -> 后台所有链接新窗口打开 (boxmoe_admin_all_links_new_tab)
- 功能描述: 开启后，后台页面底部注入 JS，自动将所有非 JS/锚点 链接的 target 属性设置为 _blank。
- 代码寻找:
- 设置项: wp-content/themes/lolimeow/core/panel/settings/set-basis.php
- 注入逻辑: wp-content/themes/lolimeow/core/module/fun-admin.php (boxmoe_admin_all_links_new_tab)

• 导航栏链接新窗口打开：

- 开关入口: 基础设置 -> 导航栏链接新窗口打开 (boxmoe_nav_target_blank)
- 功能描述: 开启后，前台顶部导航菜单的所有末级链接（非下拉父级）将自动设置为新窗口打开 (target="_blank")。
- 代码寻找:
- 设置项: wp-content/themes/lolimeow/core/panel/settings/set-basis.php
- 过滤逻辑: wp-content/themes/lolimeow/core/module/fun-basis.php (boxmoe_nav_target_blank_filter)

• 文章编辑按钮新窗口打开：

- 开关入口: 基础设置 -> 文章编辑按钮新窗口打开 (boxmoe_article_edit_target_blank)
- 功能描述: 开启后，文章页/页面内的编辑按钮（包括顶部工具栏编辑）将在新窗口打开 (target="_blank")。
- 代码寻找:
- 设置项: wp-content/themes/lolimeow/core/panel/settings/set-basis.php
- 文章页按钮逻辑: wp-content/themes/lolimeow/core/module/fun-article.php (boxmoe_edit_post_link_new_tab)
- 工具栏按钮逻辑: wp-content/themes/lolimeow/core/module/fun-admin.php (boxmoe_adminbar_edit_post_newtab)

🏞️ Banner内容显示修复

文件位置: assets/js/boxmoe.js

• 问题描述: Banner区域的欢迎语和一言功能不显示
• 根本原因:

- CSS中.site-main元素默认设置为隐藏状态（opacity: 0）
- 依赖banner图片的load事件添加.loaded类来显示内容
- 缺少图片加载失败的处理机制，导致图片无法加载时内容一直隐藏

• 修复方案: 修改initBannerImage()函数，添加三重保障机制

1. 保持原有图片加载成功处理逻辑
2. 新增error事件监听，图片加载失败时也能显示内容
3. 添加3秒超时机制，无论图片是否加载，最终都会显示内容

• 代码寻找

- 修复前代码：wp-content/themes/lolimeow/assets/js/boxmoe.js:241-261
- 修复后代码：wp-content/themes/lolimeow/assets/js/boxmoe.js:241-267

修复效果

• 确保Banner区域的欢迎语和一言功能始终能正常显示
• 提高了页面的容错性和稳定性
• 避免了因图片加载问题导致内容一直隐藏的情况

📋 三列布局移动端日期显示优化

• 问题描述：文章布局风格设置为"一排三个布局"时，移动端的日期显示会分行或被切割
• 解决方案：

1. 将日期格式从长格式（如"2025年12月"）改为更紧凑的"Y.m.d"格式（如"2025.12.19"）
2. 优化CSS样式，确保作者和日期在同一行显示
3. 调整字体大小和间距，节省空间
4. 修复CSS语法错误，确保样式正确应用

• 涉及的文件位置：

- page/template/blog-list.php：修改日期格式
- assets/css/style.css：优化CSS样式

• 实现的核心要点：

- 将 get_the_date() 改为 get_the_date('Y.m.d')，减小日期显示宽度
- 调整 .list-three .list-post-author 的样式，确保不换行且不被切割
- 将 .list-three .list-post-author * 的 flex-shrink 属性从 0 改为 1，允许元素在必要时收缩
- 移除 .list-three .list-post-author 的 overflow:hidden 属性，防止日期被切割
- 调整字体大小和间距，优化整体布局

• 代码寻找位置：

- 日期格式修改：page/template/blog-list.php:127
- CSS样式优化：assets/css/style.css 中 .list-three 相关样式

• 修复效果：

- 确保在三列布局下，移动端的日期不会换行
- 确保日期不会被切割，完整显示
- 保持良好的视觉效果和用户体验

🎯 Badge样式优化

• 功能描述：优化文章页面pill模块样式，将文字放大但保持盒子大小不变
• 文件位置：assets/css/style.css
• 实现要点：

- 修改CSS变量--bs-badge-font-size，将字体大小从0.8em调整为0.95rem，比普通文本大5px
- 调整line-height为1，确保盒子大小不会因为文字变大而增加
- 使用!important确保样式优先级高于Bootstrap默认样式

• 优化效果：

- 文字更加醒目，提升视觉效果
- 保持盒子大小不变，不影响页面布局
- 适配各种类型的Badge组件

📦 后台菜单名称优化

• 功能描述：将后台外观菜单下的"小工具"名称修改为"页面小部件"，统一后台术语风格
• 实现方式：通过修改后台菜单数组和翻译过滤器实现全局替换
• 代码寻找：

- 菜单修改：wp-content/themes/lolimeow/core/module/fun-admin.php:570-582
- 翻译过滤器：wp-content/themes/lolimeow/core/module/fun-admin.php:584-592

🎨 注销提示页面美化与修复

文件位置: functions.php

• 美化设计：将默认的注销提示页面替换为与主题风格一致的玻璃拟态设计，包括全屏背景、圆角卡片和主题配色
• 修复常量重复定义：在定义DONOTCACHEPAGE常量前添加检查，避免重复定义警告
• 修复favicon路径：正确处理favicon.ico文件路径，确保图标正常显示
• 修复语言属性输出：使用输出缓冲捕获language_attributes()函数输出，避免纯文本显示
• 修复logo位置：将logo正确放置在div卡片内上方，使用输出缓冲捕获boxmoe_logo()函数输出
• 修复注销功能：将表单提交方式从GET改为POST，添加必要的隐藏字段，确保注销功能正常工作
• 背景图片绑定：将注销页面背景绑定到后台主题设置的Banner随机图片配置，支持API图片、随机图片和固定图片

代码寻找：

• 主要实现：wp-content/themes/lolimeow/functions.php:150-412

📝 系统优化默认值调整

• 功能描述：将后台主题设置中"系统优化"的"关闭古腾堡编辑器"选项默认值从关闭改为开启
• 实现方式：修改设置面板的默认值配置
• 代码寻找：wp-content/themes/lolimeow/core/panel/settings/set-optimize.php:24
• 影响范围：新安装主题或重置设置时，古腾堡编辑器将默认关闭，使用经典编辑器

🖼️ Banner背景图默认值修复

文件位置: core/panel/settings/set-banner.php

• 问题描述: 后台自定义banner背景图的默认值路径不正确，导致生成的URL无效
• 根本原因: 原始代码中存在路径重复问题，$image_path 已包含 /assets/images/ 路径，却又额外添加了 /banner/assets/images/ 路径
• 修复方案: 修改默认值配置，将 'std' => $image_path.'/banner/assets/images/banner.jpg' 改为 'std' => $image_path.'banner.jpg'
• 代码寻找: wp-content/themes/lolimeow/core/panel/settings/set-banner.php:75
• 影响范围: 新安装主题或重置设置时，banner背景图默认值将正确指向 wp-content/themes/lolimeow/assets/images/banner.jpg

🔒 重置密码页面样式统一

文件位置: page/p-reset_password.php

• 样式统一：将重置密码页面样式修改为与登录页面一致，采用现代化玻璃拟态设计
• 视觉效果增强：

- 全屏背景图片和模糊效果
- 玻璃拟态卡片设计
- 浮动标签表单效果
- 暗色模式适配
- 按钮扫光动画
- 粒子效果背景

• HTML结构优化：

- 新增全屏背景容器
- 使用玻璃拟态卡片包裹内容
- 改进Logo和标题区域
- 优化返回登录链接样式
- 添加底部版权信息

• JavaScript增强：

- 添加加载动画效果
- 改进表单提交处理
- 优化错误和成功消息显示
- 集成粒子效果脚本

🔐 erphpdown插件登录状态显示问题修复

文件位置: wp-content/plugins/erphpdown/includes/init.php · wp-content/themes/lolimeow/page/p-signin.php

• 问题描述：erphpdown插件导致登录状态偶尔显示为未登录，点击登录按钮等同于刷新页面
• 修复方案：

- 会话管理修复：在 erphpdown_nologinpay_check 函数中添加会话状态检查，只有在会话未启动时才启动会话，避免干扰WordPress的cookie-based身份验证
- ajax_object未定义修复：在登录页面中直接定义 ajax_object 变量，避免依赖主题脚本加载

• 代码寻找：

- 会话状态检查：wp-content/plugins/erphpdown/includes/init.php:131-134
- ajax_object定义：wp-content/themes/lolimeow/page/p-signin.php:339-343

• 修复效果：

- 登录状态显示稳定，不再偶尔变为未登录状态
- 点击登录按钮正常执行AJAX登录请求，不再等同于刷新页面