10 KiB

Raw Blame History Unescape Escape

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

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

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 或更高版本

安装步骤

下载主题文件
上传到 WordPress 的 /wp-content/themes/ 目录
在 WordPress 后台激活主题
进入「外观」→「自定义」配置主题设置

配置说明

Banner 设置：在自定义器中配置轮播图片和内容
Futures 设置：配置特性项目的图标、标题和描述
新闻设置：设置新闻模块的显示方式和数量
选项卡设置：配置选项卡的内容和样式

开发说明

模块化架构

主题采用模块化设计，各功能模块独立管理：

inc/init-config.php - 系统初始化和性能配置
inc/theme-setup.php - 主题基础功能设置
inc/admin-config.php - 后台管理功能
inc/assets-loader.php - 资源加载管理
inc/media-config.php - 媒体文件处理

自定义开发

新增功能模块请在 inc/ 目录下创建对应文件
在 functions.php 中引用新模块
遵循 WordPress 编码标准
添加适当的安全检查和数据验证

性能优化

✅ 图片自动压缩和 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. 诊断工具使用

进入WordPress后台 → 工具 → SMTP诊断
点击"运行诊断"查看详细报告
根据诊断结果进行相应调整

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

🎉 初始版本发布

10 KiB Raw Blame History Unescape Escape