### SHOPEX48二次开发技术文档解析
#### 一、开发背景与需求
**ShopExV4.8**是一款高效、稳定的电子商务系统，它为用户提供了快速搭建在线商店的能力。该系统集成了基本的电子商务流程和常用功能，能够满足大多数商家的基本开店需求。
随着业务的发展和技术的进步，许多用户希望能够根据自身的需求对系统进行定制化开发，以增加新的功能或改进现有功能。早期版本的ShopEx在进行定制化开发时，往往直接在原有代码基础上进行修改，这种做法虽然简单直接，但也带来了明显的弊端——一旦进行了定制化修改，就很难再应用后续发布的系统补丁或更新，从而影响系统的稳定性和安全性。
为了解决这一问题，**ShopExV4.8**采用了更为先进的MVC（Model-View-Controller）架构，并引入了二次开发的概念。通过这种方式，可以在不影响原有系统核心代码的前提下，方便地扩展新功能或调整现有功能，同时保证系统的可维护性和升级能力。
#### 二、技术实现原理
为了确保二次开发过程中不会与原有的系统代码发生冲突，**ShopExV4.8**提出了一种新的解决方案：
1. **创建独立的开发目录**：首先需要在配置文件`config.php`中定义一个新的常量`CUSTOM_CORE_DIR`，用于指定存放所有二次开发相关程序文件的目录。建议该目录与系统的核心目录`core`处于同一级别，以便更好地组织和管理。
2. **兼容原有功能**：为了确保二次开发的新功能能够与原有功能完美融合，需要在二次开发的程序中包含原有的控制器文件或模型层文件，并通过类继承和函数重载的方式来实现原有功能的保留、修改或扩展。
3. **新建或继承控制器/模型层文件**：二次开发过程中，可以通过新建控制器文件或继承原有控制器来实现新功能；同样，也可以新建模型层文件或继承原有模型层文件来实现数据处理方面的扩展。
#### 三、具体实施步骤
##### 1. 配置`config.php`文件
在配置文件`config.php`中定义`CUSTOM_CORE_DIR`常量，指定二次开发文件的存放路径。例如：
```php
define('CUSTOM_CORE_DIR', '自定义文件路径');
```
建议自定义文件路径与`core`目录位于同一层级。
##### 2. 新增或修改后台菜单规则
在`customSchema.php`文件中，可以通过以下几种方式来新增或调整后台菜单项：
- **新增菜单项**：参照`adminSchema.php`中的格式，定义新的菜单项。数组名称必须为`$cusmenu`。
- **在已有菜单项中添加子菜单**：根据菜单出现的位置，通过设置`position`参数和引用父菜单项(`reference`)来实现在特定位置添加子菜单。例如，在“统计报表”下新增二级菜单“测试二次开发”，可以这样写：
```php
$cusmenu['analytics'] = array(
'items' => array(
array(
'type' => 'group',
'label' => '测试二次开发',
'position' => 'after',
'reference' => '访问统计',
'items' => array(
array(
'type' => 'menu',
'label' => '测试二次开发1',
'link' => 'index.php?ctl=vip/vote&act=index'
),
array(
'type' => 'menu',
'label' => '测试二次开发2',
'link' => 'index.php?ctl=vip/vote&act=index'
)
)
)
)
);
```
- `position`参数的含义如下：
- `after`：在某个菜单项之后。
- `before`：在某个菜单项之前。
- `begin`：在同级目录的最前面。
- `end`：在同级目录的最后面。
##### 3. 控制器文件实现
控制器文件必须以`cct`开头命名。可以采取以下两种方式进行实现：
- **继承原有控制器文件**：如果原有控制器文件存在，则可以通过继承的方式，扩展或重写其中的方法。
```php
cct_原控制器名称 extends ctl_原控制器名称 {
function 新增函数名() {
// 新增功能函数
}
function 原有函数名() {
// 函数重载
}
}
```
- **新建控制器文件**：如果不涉及原有控制器文件，可以直接新建控制器文件，继承`adminPage`、`objectPage`或`shopPage`等基础类。
```php
cct_controlextends adminPage {
function __construct() {
// 自定义操作
}
// 自定义函数
}
```
##### 4. 模型层文件实现
模型层文件必须以`cmd`开头命名。可以采取以下两种方式进行实现：
- **继承原有模型层文件**：如果原有模型层文件存在，则可以通过继承的方式，扩展或重写其中的方法。
```php
cmd_原模型层名称 extends mdl_模型层名称 {
function 新增函数() {
// 新增函数
}
function 原函数名() {
// 重载函数
}
}
```
- **新建模型层文件**：如果不涉及原有模型层文件，可以直接新建模型层文件，继承`shopObject`或`modlFactory`等基础类。
```php
cmd_modelextends shopObject {
function __construct() {
// 自定义操作
}
// 自定义函数
}
```
通过以上步骤，可以有效地实现对ShopExV4.8系统的二次开发，不仅增加了系统的灵活性，还保证了系统的稳定性以及后续的可升级性。
mmbob2012-07-31骗人的文档，内容严重不全。
