|
|
# Nenghui Energy Theme - 短代码使用文档
|
|
|
|
|
|
本文档提供了 Nenghui Energy 主题中所有可用短代码的详细说明和使用示例。
|
|
|
|
|
|
## 目录
|
|
|
|
|
|
1. [产品相关短代码](#产品相关短代码)
|
|
|
2. [新闻相关短代码](#新闻相关短代码)
|
|
|
3. [关于页面短代码](#关于页面短代码)
|
|
|
4. [联系页面短代码](#联系页面短代码)
|
|
|
5. [通用组件短代码](#通用组件短代码)
|
|
|
6. [EPC相关短代码](#epc相关短代码)
|
|
|
|
|
|
---
|
|
|
|
|
|
## 产品相关短代码
|
|
|
|
|
|
### `nenghui_products_list` - 产品列表
|
|
|
|
|
|
显示产品列表，支持分类筛选和分页。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_products_list]
|
|
|
```
|
|
|
|
|
|
**完整参数：**
|
|
|
```php
|
|
|
[nenghui_products_list
|
|
|
per_page="6"
|
|
|
category="residential"
|
|
|
order="date"
|
|
|
orderby="DESC"
|
|
|
category_order=""]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `per_page` - 每页显示的产品数量（默认：6）
|
|
|
- `category` - 筛选特定分类（留空显示所有）
|
|
|
- `order` - 排序方式（默认：date）
|
|
|
- `orderby` - 排序字段（默认：DESC）
|
|
|
- `category_order` - 自定义分类排序
|
|
|
|
|
|
**产品自定义字段：**
|
|
|
- `cate_type` - 产品分类（必需）
|
|
|
- `cate_type_value` - 分类显示名称
|
|
|
- `efficiency` - 效率值（如：≥93% Efficiency）
|
|
|
- `is_new` - 是否为新产品（true/false）
|
|
|
- `attr_key` - 属性名称（逗号分隔）
|
|
|
- `attr_value` - 属性值（逗号分隔）
|
|
|
- `_product_banner_url` - 产品横幅图片URL
|
|
|
- `_usage_scenario_data` - 使用场景数据（包含bottom_text）
|
|
|
|
|
|
**示例：**
|
|
|
```php
|
|
|
// 显示所有产品，每页9个
|
|
|
[nenghui_products_list per_page="9"]
|
|
|
|
|
|
// 只显示residential分类的产品
|
|
|
[nenghui_products_list category="residential"]
|
|
|
|
|
|
// 自定义排序
|
|
|
[nenghui_products_list order="title" orderby="ASC"]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_products_banner` - 产品横幅
|
|
|
|
|
|
显示产品页面横幅。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_products_banner]
|
|
|
```
|
|
|
|
|
|
或简化版本：
|
|
|
```php
|
|
|
[products_banner]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_warehousing_distribution` - 仓储配送
|
|
|
|
|
|
显示仓储配送信息。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_warehousing_distribution]
|
|
|
```
|
|
|
|
|
|
或简化版本：
|
|
|
```php
|
|
|
[warehousing_distribution]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 新闻相关短代码
|
|
|
|
|
|
### `nenghui_news` - 新闻列表
|
|
|
|
|
|
显示新闻文章列表。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_news]
|
|
|
```
|
|
|
|
|
|
**完整参数：**
|
|
|
```php
|
|
|
[nenghui_news
|
|
|
title="最新资讯"
|
|
|
category_id="1"
|
|
|
posts_count="6"
|
|
|
order_by="date"
|
|
|
order="DESC"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `title` - 模块标题
|
|
|
- `category_id` - 分类ID
|
|
|
- `posts_count` - 显示文章数量
|
|
|
- `order_by` - 排序字段
|
|
|
- `order` - 排序方向
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_news_grid` - 新闻网格
|
|
|
|
|
|
以网格布局显示新闻。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_news_grid]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 关于页面短代码
|
|
|
|
|
|
### `nenghui_about_nav` - 关于导航
|
|
|
|
|
|
显示关于页面的导航菜单。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_about_nav]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_about_nav menu_id="123"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `menu_id` - 指定菜单ID（留空使用自定义器设置的默认菜单）
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_about_company` - 关于公司
|
|
|
|
|
|
显示公司介绍信息。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_about_company]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_about_company show_animation="true"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `show_animation` - 是否显示动画效果
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_development_history` - 发展历程
|
|
|
|
|
|
显示公司发展历程时间线。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_development_history]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_development_history show_animation="true"]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_certification_gallery` - 认证画廊
|
|
|
|
|
|
显示公司认证证书画廊。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_certification_gallery]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_certification_gallery
|
|
|
columns="5"
|
|
|
lightbox="true"
|
|
|
animation="true"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `columns` - 每行显示列数（1-6）
|
|
|
- `lightbox` - 是否启用灯箱效果
|
|
|
- `animation` - 是否启用动画效果
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_technical_service` - 技术服务
|
|
|
|
|
|
显示技术服务信息。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_technical_service]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_technical_service
|
|
|
title="可靠的技术服务"
|
|
|
subtitle="提升客户体验"]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `black_about_company_banner` - 关于公司横幅
|
|
|
|
|
|
显示关于页面的横幅。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[black_about_company_banner]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_black_about_info` - 关于信息
|
|
|
|
|
|
显示公司详细信息。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_black_about_info]
|
|
|
```
|
|
|
|
|
|
或简化版本：
|
|
|
```php
|
|
|
[black_about_info]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `business_process` - 业务流程
|
|
|
|
|
|
显示业务流程图。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[business_process]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 联系页面短代码
|
|
|
|
|
|
### `nenghui_contact_form` - 联系表单
|
|
|
|
|
|
显示联系表单。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_contact_form]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_contact_form form_id="1" show_animation="true"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `form_id` - 表单ID
|
|
|
- `show_animation` - 是否显示动画效果
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_contact_map` - 联系地图
|
|
|
|
|
|
显示联系地图。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_contact_map]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_overseas_services` - 海外服务
|
|
|
|
|
|
显示海外服务信息。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_overseas_services]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 通用组件短代码
|
|
|
|
|
|
### `nenghui_banner` - 轮播横幅
|
|
|
|
|
|
显示轮播横幅。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_banner]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_banner autoplay="true"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `autoplay` - 是否自动播放
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_futures` - 未来展望
|
|
|
|
|
|
显示未来展望内容。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_futures]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_futures title="未来展望" show_animation="true"]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_tabs` - 选项卡
|
|
|
|
|
|
显示选项卡内容。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_tabs]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_tabs tabs_count="3" show_animation="true"]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_flowchart_tabs` - 流程图选项卡
|
|
|
|
|
|
显示流程图选项卡。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_flowchart_tabs]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_banner_title` - 标题横幅
|
|
|
|
|
|
显示带标题的横幅。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_banner_title title="关于我们" description="我们致力于提供最优质的服务"]
|
|
|
```
|
|
|
|
|
|
**完整参数：**
|
|
|
```php
|
|
|
[nenghui_banner_title
|
|
|
title="关于我们"
|
|
|
description="我们致力于提供最优质的服务"
|
|
|
bg_image="https://example.com/image.jpg"
|
|
|
height="70vh"
|
|
|
overlay_opacity="0.6"
|
|
|
show_animation="true"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `title` - 标题
|
|
|
- `description` - 描述
|
|
|
- `bg_image` - 背景图片URL
|
|
|
- `height` - 高度（支持px、vh、%）
|
|
|
- `overlay_opacity` - 遮罩透明度（0-1）
|
|
|
- `show_animation` - 是否显示动画
|
|
|
|
|
|
---
|
|
|
|
|
|
### `black_maps` - 黑色地图
|
|
|
|
|
|
显示交互式地图。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[black_maps]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[black_maps height="100vh" show_loading="true"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `height` - 地图高度
|
|
|
- `show_loading` - 是否显示加载动画
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_video` - 视频
|
|
|
|
|
|
显示视频播放器。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_video video_url="https://example.com/video.mp4"]
|
|
|
```
|
|
|
|
|
|
**完整参数：**
|
|
|
```php
|
|
|
[nenghui_video
|
|
|
video_url="https://example.com/video.mp4"
|
|
|
cover_image="https://example.com/cover.jpg"
|
|
|
title="我们的企业视频"
|
|
|
description="了解我们的产品和服务"
|
|
|
play_button_text="立即播放"
|
|
|
show_overlay="true"
|
|
|
overlay_opacity="0.5"
|
|
|
height="80vh"
|
|
|
autoplay="false"
|
|
|
muted="true"
|
|
|
controls="true"]
|
|
|
```
|
|
|
|
|
|
**参数说明：**
|
|
|
- `video_url` - 视频URL（必需）
|
|
|
- `cover_image` - 封面图片URL
|
|
|
- `title` - 视频标题
|
|
|
- `description` - 视频描述
|
|
|
- `play_button_text` - 播放按钮文字
|
|
|
- `show_overlay` - 是否显示遮罩
|
|
|
- `overlay_opacity` - 遮罩透明度
|
|
|
- `height` - 视频高度
|
|
|
- `autoplay` - 是否自动播放
|
|
|
- `muted` - 是否静音
|
|
|
- `controls` - 是否显示控制栏
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_download_center` - 下载中心
|
|
|
|
|
|
显示下载中心。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_download_center]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_faq` - 常见问题
|
|
|
|
|
|
显示常见问题列表。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_faq]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_cases` - 案例展示
|
|
|
|
|
|
显示案例展示。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_cases]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## EPC相关短代码
|
|
|
|
|
|
### `nenghui_epc` - EPC解决方案
|
|
|
|
|
|
显示EPC解决方案。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_epc]
|
|
|
```
|
|
|
|
|
|
**自定义参数：**
|
|
|
```php
|
|
|
[nenghui_epc
|
|
|
title="EPC Solutions"
|
|
|
subtitle="Beyond Hardware: Total EPC Solutions from NengHui Design Institute"
|
|
|
bg_image="https://example.com/epc-bg.jpg"]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
### `nenghui_epc_banner` - EPC横幅
|
|
|
|
|
|
显示EPC横幅。
|
|
|
|
|
|
**基本用法：**
|
|
|
```php
|
|
|
[nenghui_epc_banner]
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 使用技巧
|
|
|
|
|
|
### 1. 在页面编辑器中使用
|
|
|
|
|
|
在WordPress页面编辑器中，直接输入短代码即可：
|
|
|
|
|
|
```
|
|
|
[nenghui_products_list per_page="9"]
|
|
|
```
|
|
|
|
|
|
### 2. 在模板文件中使用
|
|
|
|
|
|
在主题模板文件中使用 `do_shortcode()` 函数：
|
|
|
|
|
|
```php
|
|
|
<?php echo do_shortcode('[nenghui_products_list per_page="9"]'); ?>
|
|
|
```
|
|
|
|
|
|
### 3. 组合使用多个短代码
|
|
|
|
|
|
可以在同一个页面中使用多个短代码：
|
|
|
|
|
|
```
|
|
|
[nenghui_banner_title title="我们的产品"]
|
|
|
[nenghui_products_list per_page="9"]
|
|
|
[nenghui_contact_form]
|
|
|
```
|
|
|
|
|
|
### 4. 响应式设计
|
|
|
|
|
|
所有短代码都支持响应式设计，会自动适应不同屏幕尺寸。
|
|
|
|
|
|
### 5. 深色模式
|
|
|
|
|
|
所有短代码都支持深色模式，会自动根据系统设置切换主题。
|
|
|
|
|
|
## 常见问题
|
|
|
|
|
|
### Q: 短代码不显示怎么办？
|
|
|
|
|
|
A: 请确保：
|
|
|
1. 短代码名称拼写正确
|
|
|
2. 主题已正确激活
|
|
|
3. 没有PHP错误（检查调试日志）
|
|
|
|
|
|
### Q: 如何自定义短代码样式？
|
|
|
|
|
|
A: 可以通过以下方式自定义：
|
|
|
1. 在自定义器中修改相关设置
|
|
|
2. 使用CSS覆盖默认样式
|
|
|
3. 修改对应的模板文件
|
|
|
|
|
|
### Q: 短代码参数不生效怎么办？
|
|
|
|
|
|
A: 请确保：
|
|
|
1. 参数名称拼写正确
|
|
|
2. 参数值格式正确
|
|
|
3. 没有特殊字符冲突
|
|
|
|
|
|
### Q: 如何添加新的短代码？
|
|
|
|
|
|
A: 可以在 `inc/shortcode.php` 文件中添加新的短代码函数，参考现有短代码的实现方式。
|
|
|
|
|
|
## 技术支持
|
|
|
|
|
|
如需技术支持，请联系开发团队或查看主题文档。
|
|
|
|
|
|
---
|
|
|
|
|
|
**文档版本：** 1.0
|
|
|
**最后更新：** 2026-02-09
|
|
|
**主题版本：** nenghui-energy-theme-4
|
