# 上海能辉科技定制前端主题 **Theme Name:** 上海能辉科技定制前端-安全增强版本 **Theme URI:** https://www.nenghui.com/ **Author:** 上海能辉科技 **Description:** 上海能辉科技，基于 WordPress 定制的专用前端主题，修复安全问题，提升系统安全性。 **Version:** 1.6.0 ## 项目介绍 上海能辉科技定制前端是一个专为上海能辉科技公司开发的现代化 WordPress 主题。该主题采用模块化架构设计，具有高性能、安全性和可扩展性，专注于能源科技行业的展示需求。 ## 核心特性 ### 🎨 现代化设计 - 响应式布局，完美适配各种设备 - 现代化 UI 设计，符合能源科技行业特色 - 支持 WebP 和 SVG 格式图片 - 内置动画效果和交互体验 ### 🚀 高性能优化 - 模块化代码架构，按需加载 - 图片压缩和 WebP 自动生成 - 内存使用监控和优化 - 临时文件自动清理 - 服务器资源智能管理 ### 🔒 安全防护 - PHP 木马防护和文件扫描 - 文件上传安全检查 - 恶意代码检测和清理 - 安全日志记录 ### 📱 功能模块 - **Banner 轮播**：支持多图轮播，可自定义内容和样式 - **Futures 展示**：特性项目展示区块 - **新闻模块**：动态新闻展示，支持分类筛选 - **选项卡系统**：多选项卡内容展示 - **自定义器集成**：可视化配置界面 ## 文件结构 ``` nenghui-energy-theme-2/ ├── 404.php # 404错误页面 ├── README.md # 项目说明文档 ├── archive.php # 归档页面模板 ├── assets/ # 静态资源目录 │ ├── css/ # 样式文件 │ │ ├── admin.css # 后台管理样式 │ │ ├── animate.min.css # 动画效果库 │ │ └── index.css # 主要样式文件 │ ├── images/ # 图片资源 │ │ ├── NaN-img.png # 默认占位图片 │ │ ├── futures-bg.webp # Futures背景图 │ │ ├── logo-1.svg # Logo图标1 │ │ └── logo-2.svg # Logo图标2 │ └── js/ # JavaScript文件 │ ├── customizer-controls.js # 自定义器控制脚本 │ ├── customizer-preview.js # 自定义器预览脚本 │ ├── index.js # 主要交互脚本 │ ├── jquery.min.js # jQuery库 │ └── tinytyper.min.js # 打字机效果库 ├── comments.php # 评论模板 ├── docs/ # 文档目录 │ ├── architecture_issues.md # 架构问题分析 │ ├── banner_shortcode.md # Banner短代码说明 │ ├── futures_shortcode.md # Futures短代码说明 │ ├── home_news_shortcode.md # 新闻短代码说明 │ ├── home_tabs_shortcode.md # 选项卡短代码说明 │ ├── product_swiper_shortcode.md # 产品轮播短代码说明 │ └── project_evaluation_report.md # 项目评分报告文档 ├── footer.php # 页脚模板 ├── functions.php # 主题功能文件（模块化入口） ├── header.php # 页头模板 ├── inc/ # 功能模块目录 │ ├── init-config.php # 初始化配置（服务器资源、图片压缩等） │ ├── theme-setup.php # 主题设置和功能支持 │ ├── admin-config.php # 后台管理配置 │ ├── assets-loader.php # 脚本和样式加载器 │ ├── media-config.php # 媒体和文件上传配置 │ ├── cleanup.php # 清理和优化功能 │ ├── customizer.php # 主题自定义器设置 │ ├── performance-config.php # 性能配置和安全防护 │ └── shortcode.php # 短代码功能 ├── index.php # 主页模板 ├── page-full-width.php # 全宽页面模板 ├── page.php # 页面模板 ├── screenshot.png # 主题截图 ├── search.php # 搜索结果页面 ├── sidebar.php # 侧边栏模板 ├── single.php # 单篇文章模板 ├── style.css # 主题样式表 ├── template-parts/ # 模板片段目录 │ ├── blocks/ # 区块模板 │ │ ├── block-banner.php # Banner区块模板 │ │ ├── block-futures.php # Futures区块模板 │ │ ├── block-home-news.php # 新闻区块模板 │ │ └── block-tabs.php # 选项卡区块模板 │ ├── content-none.php # 无内容模板 │ └── content-search.php # 搜索内容模板 ├── theme-options.php # 主题选项页面 └── widgets/ # 小部件目录 └── widgets-config.php # 小部件配置 ``` ## 短代码功能 ### Banner 轮播 ``` [nenghui_banner] [nenghui_banner id="custom-banner" class="my-banner" autoplay="true"] ``` ### Futures 展示 ``` [nenghui_futures] [nenghui_futures title="我们的优势" show_animation="true"] ``` ### 新闻模块 ``` [nenghui_news] [nenghui_news title="最新动态" category_id="1,2" posts_count="5"] ``` ### 选项卡系统 ``` [nenghui_tabs] [nenghui_tabs id="custom-tabs" class="my-tabs"] ``` ## 安装和使用 ### 系统要求 - WordPress 5.0 或更高版本 - PHP 7.4 或更高版本 - MySQL 5.6 或更高版本 ### 安装步骤 1. 下载主题文件 2. 上传到 WordPress 的 `/wp-content/themes/` 目录 3. 在 WordPress 后台激活主题 4. 进入「外观」→「自定义」配置主题设置 ### 配置说明 1. **Banner 设置**：在自定义器中配置轮播图片和内容 2. **Futures 设置**：配置特性项目的图标、标题和描述 3. **新闻设置**：设置新闻模块的显示方式和数量 4. **选项卡设置**：配置选项卡的内容和样式 ## 开发说明 ### 模块化架构 主题采用模块化设计，各功能模块独立管理： - `inc/init-config.php` - 系统初始化和性能配置 - `inc/theme-setup.php` - 主题基础功能设置 - `inc/admin-config.php` - 后台管理功能 - `inc/assets-loader.php` - 资源加载管理 - `inc/media-config.php` - 媒体文件处理 ### 自定义开发 1. 新增功能模块请在 `inc/` 目录下创建对应文件 2. 在 `functions.php` 中引用新模块 3. 遵循 WordPress 编码标准 4. 添加适当的安全检查和数据验证 ## 性能优化 - ✅ 图片自动压缩和 WebP 生成 - ✅ 内存使用监控和优化 - ✅ 临时文件自动清理 - ✅ 服务器资源智能管理 - ✅ 延迟加载和缓存优化 ## 安全特性 - ✅ PHP 木马检测和清理 - ✅ 文件上传安全验证 - ✅ 恶意代码扫描 - ✅ 安全日志记录 - ✅ 输入数据过滤和验证 ## SMTP连接故障排除 ### 连接超时问题 如果遇到 "Connection timed out" 错误，请按以下步骤排查： #### 1. 网络连通性检查 - 使用系统诊断工具检查服务器网络状态 - 确认服务器可以访问外部网络 - 检查DNS解析是否正常 #### 2. 防火墙设置 - 确认服务器防火墙允许SMTP端口（25、465、587）的出站连接 - 检查云服务商的安全组设置 - 联系主机提供商确认端口限制 #### 3. SMTP服务器配置 - 验证SMTP服务器地址和端口是否正确 - 确认加密方式设置（SSL/TLS/STARTTLS） - 检查SMTP服务器是否正常运行 #### 4. 端口25被封禁问题 **⚠️ 重要提示：大多数云服务商默认封禁端口25** **问题现象：** - 连接超时错误："Connection timed out (110)" - 所有连接方式都失败 - 诊断显示无法连接到端口25 **解决方案：** - **立即更换端口**：改用587（TLS）或465（SSL） - **更新加密设置**：配合端口使用相应的加密方式 - **避免使用端口25**：即使在自建服务器上也建议避免 **云服务商政策：** - **阿里云ECS**：永久封禁25端口，无法申请解封 - **腾讯云CVM**：默认封禁25端口，企业用户可申请解封 - **华为云ECS**：默认封禁25端口 - **AWS EC2**：需要申请解除25端口限制 #### 5. 其他常见解决方案 - **防火墙设置**：确保安全组开放587/465端口 - **自建服务器**：检查iptables或ufw防火墙规则 - **共享主机**：联系主机商开启SMTP功能 - **网络问题**：检查DNS解析和网络连通性 #### 6. 诊断工具使用 1. 进入WordPress后台 → 工具 → SMTP诊断 2. 点击"运行诊断"查看详细报告 3. 根据诊断结果进行相应调整 #### 7. 替代方案 如果无法解决连接问题，可以考虑： - 使用第三方邮件服务（如SendGrid、阿里云邮件推送） - 配置邮件中继服务 - 联系主机提供商获取技术支持 ## 更新记录 ### v1.5.0 (2025-12-11) - 🔒 修复安全问题，提升系统安全性 - ✅ 更新版本号为 1.5.0 ### v1.4.1 (2025-01-XX) - ✅ 增强SMTP诊断功能，添加DNS解析测试 - ✅ 新增网络连通性测试，检测服务器网络状态 - ✅ 改进端口连接测试，支持多种连接方式 - ✅ 优化诊断结果显示，提供详细的故障排除建议 - ✅ 增强连接超时处理和错误诊断 - ✅ 添加端口25被封禁的专门检测和警告 - ✅ 在管理界面增加端口25使用警告提示 - ✅ 完善云服务商端口限制说明文档 ### v1.4.0 (2025-07-17) - ✅ 创建项目评分报告文档，完成WordPress最佳实践和性能评估 - ✅ 重构代码架构，实现模块化设计 - ✅ 优化性能配置和安全防护 - ✅ 完善文档和使用说明 - ✅ 修复已知问题和优化用户体验 ### v1.0.0 - 🎉 初始版本发布 --- **更新时间：** 2025-12-11 14:31:14 **版权所有：** © 2025 上海能辉科技有限公司