# 上海能辉科技定制前端主题

**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 上海能辉科技有限公司