|
|
# 上海能辉科技定制前端主题
|
|
|
|
|
|
**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 上海能辉科技有限公司 |
