织梦CMS二次开发入门

# 织梦CMS二次开发入门

当你需要织梦CMS实现标准功能之外的需求时，就需要进行二次开发。本文介绍织梦CMS的开发基础。

## 一、了解目录结构

织梦CMS的核心目录和文件：

“`
/dede/ 后台管理目录（建议改名）
/templets/ 模板文件目录
/default/ 默认模板
/uploads/ 上传文件目录
/data/ 配置和数据缓存
/include/ 核心类库文件
/a/ 前台PHP文件（如 /a/档案ID）
/plus/ 扩展功能文件
/install/ 安装程序（安装后删除）
“`

**开发最常接触的目录：**
– `/include/` — 核心逻辑，修改需谨慎
– `/templets/` — 模板开发，修改最安全
– `/a/plus/` — 自定义功能脚本

## 二、模型开发

织梦CMS的内容模型是二次开发的核心。通过自定义模型可以创建任意内容类型。

### 2.1 创建自定义模型
1. 后台 → 核心 → 内容模型管理
2. 点击”增加新模型”
3. 填写模型名称、表名等基本信息
4. 添加自定义字段（如价格、规格等）

### 2.2 模型字段类型
– 单行文本（text）
– 多行文本（textarea）
– 下拉选择（select）
– 图片上传（img）
– 文件上传（file）
– 日期时间（datetime）

### 2.3 调用自定义字段
在模板中使用：
“`
{dede:arclist addfields=’自定义字段名’ channelid=’模型ID’}
[field:自定义字段名/]
{/dede:arclist}
“`

## 三、插件开发

### 3.1 插件文件结构
“`
/plus/你的插件名.php 插件主文件
“`

在插件文件中需要引入织梦的公共文件：
“`php
require_once(dirname(__FILE__).’/../include/common.inc.php’);
“`

### 3.2 简单示例：自定义页面
“`php
SetTemplet(DEDETEMPLATE.’/default/custom_page.htm’);
$pv->Display();
?>
“`

### 3.3 后台添加自定义菜单
修改 `/dede/inc/inc_menu.php` 添加菜单项，或通过插件机制注册菜单。

## 四、模板标签开发

### 4.1 自定义函数标签
在 `/include/extend.func.php` 中添加自定义函数：
“`php
function GetMyCustomField($aid) {
global $dsql;
$row = $dsql->GetOne(“SELECT my_field FROMaddonarticle WHERE aid=’$aid'”);
return $row[‘my_field’];
}
“`

模板中调用：
“`
{dede:field.id function=’GetMyCustomField(@me)’/}
“`

## 五、开发规范建议

– 修改核心文件前先备份原文件
– 自定义代码放在独立文件中，方便升级时保留
– 使用织梦提供的 API 获取数据库连接（`$dsql`），不要自己创建新连接
– 注意 SQL 注入防护，使用 `$dsql->GetOne()` 等安全方法
– 开发完成后测试前台显示和后台功能

## 六、学习资源

– 织梦CMS官方文档
– 织梦CMS官方论坛（ask.dedecms.com）
– GitHub 上的织梦CMS源码（可以学习优秀开发者的代码）