ECTouch使用基础手册专业资料.doc

ECTouch 协助中心
1. 使用手册 1
1.1商店设立 1
1.1.1网店设立 如图1 2
1.1.2基本设立 如图2 2
1.1.3显示设立 如图3 3
1.1.4商品显示设立 如图5 5
1.1.5短信设立 如图6 5
1.2菜单管理 5
1.2.1添加导航 5
1.2.2编辑导航 6
1.3分类图标 6
1.4品牌管理 8
1.4.1添加品牌 8
1.5支付方式 10
1.6广告管理 11
1.7 优惠活动 11
1.8团购活动 12
1.9文章管理 13
2.0授权管理 13
2. 二次开发 14
2.1 入门基本 14
2.1.1服务器规定 14
2.1.2模型-视图-控制器(MVC) 14
2.2 构造设计 14
2.2.1文献目录构造 14
2.2.2 url访问 15
2.2.3模块和操作办法 16
2.2.4 控制器 16
2.2.5 命名规范 17
2.2.8 配备文献调用 17
2.2.9 二次开发技巧 17
2.3 构建模块 17
2.3.1开发流程 17
2.3.2创立模块 18
2.3.3创立模块控制器 18
2.3.4 创立数据库模型类 18
3. 常用问题 18
4. 数据构造 18

ECTouch官方交流QQ群：
1. 使用手册
1.1商店设立
1.11网店设立 如图1

1.1.2基本设立 如图2

1.1.3显示设立 如图3

1.1.4商品显示设立 如图5

1.1.5短信设立 如图6

1.2菜单管理
1.2.1添加导航
进入后台中心 全局设立 -> 菜单管理 ，界面如图 6 所示：

点击添加导航 如图7所示：

（1） 名称:必填项，例如全某些类
（2） 链接地址：前台点击名称时跳转地址
（3） 图片地址：前台显示图标
（4） 排序：前台显示先后顺序
（5） 与否显示：前台与否显示该导航
（6） 与否新窗口：点击名称时跳转是本窗口打卡还是新窗口模式打开
点击拟定 ，提交信息。前台显示如图：

1.2.2编辑导航

选取要编辑导航 如图 8 点击编辑 操作同添加
1.3分类图标
进入后台中心 全局设立 -> 分类图标 ，界面如图 9 所示：

选中一种分类，点击编辑 如图10所示

点击分类小图标后‘浏览’可以上传图标（其她分类名称、上级分类等同电脑版后台）。上传成功后，前台显示如图11

1.4品牌管理
1.4.1添加品牌
进入后台中心 全局设立 -> 品牌管理 ，界面如图 12 所示：

点击添加品牌 界面如图13所示：

(1) 品牌名称：前台品牌页面显示品牌名称
(2) 品牌网址：此品牌地址
(3) 品牌LOGO：前台品牌显示logo
(4) 品牌Banner：前台显示此品牌广告位
(5) 品牌描述：此品牌描述
(6) 品牌详情：此品牌详细信息
(7) 排序：前台品牌列表显示顺序
(8) 与否显示：与否显示在前台
前台显示界面如图 13：

1.5支付方式
进入后台中心 全局设立 -> 支付方式 ，界面如图 12 所示：

（此列表所有支付方式都为手机版独立支付方式）
点击编辑(或安装)， 如图13：（以手机版支付宝为例）

这个里面东西需要你去支付宝申请帐号，申请帐号填写在这里才可以使用。
注意：使用签约支付宝账号登录，订单状态为“已完结”表达手机网页支付权限已开通
点击确认安装后打开页面如图 14 所示

注意：每个支付方式安装信息也许不同，详细请见有关开发文档
1.6广告管理
1.7 优惠活动
进入后台中心 全局设立 -> 优惠活动 ，界面如图 15 所示：

点击编辑 界面如图 16所示：

点击浏览可以上传优惠活动banner图。上传完毕拟定之后，前台显示界面如图 17 所示：

1.8团购活动
进入后台中心 全局设立 -> 团购活动 ，界面如图 18 所示：

点击编辑 显示界面如图19 所示：

点击浏览可以上传团购活动banner图。上传完毕拟定之后，前台显示界面如图 20 所示：

1.9文章管理
进入后台中心 全局设立 -> 文章分类 ，界面如图 21 所示：
点击编辑 显示界面如图22所示 ：

与否在touch端显示，选取“是”，则显示在手机版网站，否则不显示
2.0授权管理
进入后台中心 全局设立 -> 授权管理 ，界面如图 23 所示：

点击编辑 显示界面如图 24所示：

填写开放平台申请App Key 和 App Secret 点击拟定后，第三方登录信息就配备完毕了
2. 二次开发
2.1 入门基本
2.1.1服务器规定
1.Windows 平台：
IIS/Apache/Nginx + PHP + MySQL5

2.Linux/Unix 平台
Apache/Nginx + PHP+ MySQL5 (PHP必要在非安全模式下运营)

建议使用平台：Linux + Apache2.2 + PHP5.2/PHP5.3 + MySQL5.0

3.PHP必要环境或启用系统函数：
curl
allow_url_fopen
GD扩展库
MySQL扩展库
系统函数 —— phpinfo、dir
2.1.2模型-视图-控制器(MVC)
MVC是一种设计模式，它强制性使应用程序输入、解决和输出分开。使用MVC应用程序被提成三个核心部件：模型（M）、视图（V）、控制器（C），它们各自解决自己任务。
2.2 构造设计
2.2.1文献目录构造
根目录
|  –  admin 默认后台管理目录（可任意改名）
|  –  data 静态资源和系统缓存、配备项目录(必要可写入)
       |  – assets 静态资源目录
       |  – attached 附件目录
|  – cache缓存目录
|  – common 公共静态文献目录
|  –  include 核心程序目录
       |  – apps 主程序
|  – admin 后台模块
|  – install 安装模块
|  – default 前台默认模块
|  – common 公共办法
|  – controller 控制器
|  – language 语言包
|  – model 模型
       |  – base 基本程序
       |  – driver驱动程序
       |  – library 主类库
       |  – vendor 第三方扩展类
|  –  plugins 插件程序目录
       |  – connect授权登录
       |  – wechat 微信
       |  – integrates 第三方顾客整合
|  – payment 支付方式
|  – shipping 配送方式
|  –  themes系统默认模板目录
2.2.2 url访问
ECTouch是采用个MVC设计模式开发，基于模块和操作方式进行访问，并且使用单一入口模式进行项目布置和访问，任何功能和模块访问，只有通过此入口文献。

参数名称
描述
位置
备注
m
模型/模块名称
include/apps/中模块目录名称
必要
c
控制器名称
include/apps/模块/controller/*.php 文献名称
必要
a
事件名称
include/apps/模块/controller/*.php中办法名称

 模块访问办法[示例]：
index.php?m=default&c=category&a=index&id=2
其中
m = default 为模块名称位于include/apps/
c = category 为控制器名称位于include/apps/default/controller/IndexController.class.php
a = index 控制器访问办法名称 位于include/apps/default/controller/IndexController.class.php 中index()办法
id = 2 为其她参数 与正常get传递参数形式相似
2.2.3模块和操作办法
ECTouch中模块，位于include/apps/目录中 每一种目录称之为一种模块。即url访问中m
[示例]：
index.php?m=default&c=index
那么您访问就是ECTouch/include/apps/default这个模块。
如果创立一种前台模块，只要在 include/apps/default 目录下创立:模块名称+Model.class.php

2.2.4 控制器
ECTouch控制器就是模块文献下面controller下类文献，位于include/apps/模块/controller/下面。命名规则为：文献名+Controller.class.php，文献名开头字母大写，例如一种名为test控制器,那么她命名为TestController.class.php即可。控制器类类名称与控制器文献名必要相似。
如果您创立了一种TestController.class.php在default模块下，那么咱们在浏览器里面输入URL：
http://localhost/ectouch/mobile/index.php?m=default&c=test
如果你添加控制器类继承了其她类，那么要注意你类中办法名称不能和父类办法名称重复，否则会覆盖原有或者浮现程序运营错误。例如default模块类继承了CommonController类，而这个类中定义了view办法那么就不能再重复定义这个办法了。

2.2.5 命名规范
使用ECTouch做二次开发，应当遵循其开发规范。规范如下：

核心程序目录（includes）类文献需要以.class.php 为后缀名称，开头第一种字母大写。例如：IndexModel.class.php

控制器和模型中类名和文献名一致，例如IndexModel.class.php类名为：IndexModel

2.2.8 配备文献调用
网店配备文献在 data/ache/static_caches/touch_shop_config.php，在BaseMode.class.php中通过load_config 办法调用
连接数据库配备文献在：data/fonfig.php
return array(
'DB_TYPE' => 'mysql',
'DB_HOST' => 'ocalhost',
'DB_NAME' => 'ectouch,
'DB_USER' => 'root',
'DB_PWD' => 'root123',
'DB_PORT' => '3306',
'DB_PREFIX' => 'ecs_',
'DB_CHARSET' => 'utf8'
);

2.2.9 二次开发技巧
对已经存在控制器开发，对数据库操作需要放在模型文献 =model中，在控制器使用时只需调用model(‘模型名称’)->调用办法()，例如调用CommonModel模型中get_navigator 办法，可以这样调用：model('Common')->get_navigator()
2.3 构建模块
2.3.1开发流程
为ECTouch创立一种模块普通开发流程是：

1. 创立数据库和数据表；（没有数据库操作可略过）
2. 创立模块目录
3. 创立模块控制器类；
4. 创立模块类与模块函数；（如果只是简朴模块可以不必创立）
5. 创立模板文献；
6. 运营和调试。

2.3.2创立模块
2.3.3创立模块控制器
3. 常用问题
3.1商品图片不显示？
看一下图片途径与否是你所配备环境途径，如果不是进入后台中心 全局设立 -> 商店设立->网店信息，配备电脑端地址为你所在网站电脑版地址，配备完毕之后点击确认，清空缓存。
3.2菜单图标不显示？
进入后台中心 全局设立 ->菜单设立查看环节1.2.1 设立导航栏图片地址即前台图标
3.3商品分类图标不显示？
进入后台中心 全局设立 ->分类图标查看环节13 设立分类小图标
3.4后台登录不进去？无法提交订单？等
数据表也许是2.72版本，程序版本则是2.73版本，查看数据表 admin_user 表中与否存在ec_salt，没有话，执行下列语句添加数据表字段。注意数据表前缀
-- `ecs_shipping`修改
ALTER TABLE `ecs_shipping` ADD `shipping_order` TINYINT(3) UNSIGNED NOT NULL DEFAULT '0';
--`ecs_virtual_card`修改
ALTER TABLE `ecs_virtual_card` CHANGE `crc32` `crc32` VARCHAR( 12 ) NOT NULL DEFAULT '0';
--`ecs_users`修改
ALTER TABLE `ecs_users` ADD `ec_salt` VARCHAR( 10 ) NULL AFTER `salt` ;
--`ecs_admin_user`修改
ALTER TABLE `ecs_admin_user` ADD `ec_salt` VARCHAR( 10 ) NULL AFTER `user_name` ;

4. 数据构造
表1：ecs_touch_activity (touch优惠活动扩展表)
字段
类型
Null
默认
注释
act_id
Int(10)
否

优惠活动自增id 取值favorable_activitycat_id
act_banner
varchar(255)
否

优惠活动banner图

表2：ecs_touch_ad (touch广告表)
字段
类型
Null
默认
注释
ad_id
smallint(5)
否

广告自增id
position_id
smallint(5)
否
0
0,站外广告;从1开始代表是该广告所处广告位,同表ad_postition中字段position_id值
media_type
tinyint(3)
否
0
广告类型,0图片;1flash;2代码3文字
ad_name
varchar(255)
否

该条广告记录广告名称
ad_link
varchar(255)
否

广告链接地址
ad_code
text
否

广告链接体现,文字广告就是文字或图片和flash就是它们地址
start_time
Int(11)
否
0
广告开始时间
end_time
Int(11)
否
0
广告结速时间
link_man
varchar(60)
否

广告联系人
link_email
varchar(60)
否

广告联系人邮箱
link_phone
varchar(60)
否

广告联系人电话
click_count
mediumint(8)
否
0
该广告点击数
enabled
tinyint(3)
否
1
该广告与否关闭;1启动；0关闭；关闭后广告将不再有效

表3：ecs_touch_ad_position (touch广告位表)
字段
类型
Null
默认
注释
position_id
tinyint(3)
否

广告位自增id
position_name
varchar(60)
否

广告位名称
ad_width
smallint(5)
否
0
广告位宽度
ad_height
smallint(5)
否
0
广告高度
position_desc
varchar(255)
否

广告位描述
position_style
text
否

广告位模板代码

表4：ecs_touch_article_cat (touch 文章分类扩展表)
字段
类型
Null
默认
注释
cat_id
smallint(8)
否

文章分类id 取值article_catcat_id
is_mobile
Tinyint(2)
否

与否在手机版显示 0 不显示 1 显示

表5：ecs_touch_brand (touch 品牌扩展表)
字段
类型
Null
默认
注释
brand_id
iint(8)
否

品牌id 取值brand brand_id
brand_banner
varchar(255)
否

品牌banner

表6：ecs_touch_category(touch 分类扩展表)
字段
类型
Null
默认
注释
cat_id
iint(10)
否

分类id 取值 category cat_Id
cat_image
varchar(255)
否

分类图标

表7：ecs_touch_feedback(touch 留言扩展表)
字段
类型
Null
默认
注释
msg_id
mediumint(8)
否

反馈信息自增id 取自feddback msg_id
msg_read
int(1)
否
0
与否已读

表8：ecs_touch_goods (商品扩展表)
字段
类型
Null
默认
注释
goods_id
int(10)
否

反馈信息自增id 取自feddback msg_id
sales_volume
Int(10)
否

销量记录

表9：ecs_touch_goods_activity (促销活动扩展表)
字段
类型
Null
默认
注释
cat_id
iint(10)
否

分类id 取值 category cat_Id
act_banner
varchar(255)
否

活动banner
sales_count
iint(10)
否

销量记录
click_num
iint(10)
否

点击量

表10：ecs_touch_nav(菜单表)
字段
类型
Null
默认
注释
id
mediumint(10)
否

分类id 取值 category cat_Id
ctype
varchar(10)

cid
smallint(5)

name
varchar(255)

菜单显示名称

表11：ecs_touch_payment(支付方式表)
字段
类型
Null
默认
注释
pay_id
tinyint(3)
否

已安装支付方式自增id
pay_code
varchar(20)
否

支付方式 英文缩写,其实是该支付方式解决插件不带后缀文献名某些
pay_name
varchar(120)
否

支付方式名称
pay_fee
varchar(10)
否
0
支付费用
pay_desc
text
否

支付方式描述
pay_order
tinyint3)
否
0
支付方式在页面显示顺序
pay_config
text
否

支付方式配备信息,涉及商户号和密钥什么
enabled
tinyint(1)
否
0
与否可用;0否;1是
is_cod
tinyint(1)
否
0
与否货到付款，0否;1是
is_online
tinyint(1)
否
0
与否在线支付;0否;1是

表12：ecs_touch_shop_config (配备表)
字段
类型
Null
默认
注释
id
smallint(5)
否

全站配备信息自增id
parent_id
smallint(5)
否
0
父节点id，取值于该表id字段值
code
varchar(30)
否

跟变量名作用差不多，其实就是语言包中字符串索引，如$_LANG[''cfg_range''][''cart_confirm'']
type
varchar(10)
否

该配备类型，text，文本输入框
store_range
varchar(255)
否

当语言包中code字段相应是一种数组时，那该处就是该数组索引，如$_LANG[''cfg_range''][''cart_confirm''][1]；只有type字段为select,options时才有值'
store_dir
varchar(255)
否

当type为file时才有值，文献上传后保存目录
value
text
否

该项配备值
sort_order
tinyint(3)
否
1
显示顺序，数字越大越靠后

表13：ecs_touch_user (授权配备表)
字段
类型
Null
默认
注释
id
int(8)
否

自增id
app_id
varchar(50)
否

申请时提供应开发者 APP KEY
app_secret
varchar(50)
否

申请时提供应开发者 APP SECRET
from
varchar(20)
否

授权登录名称 例如：qq ,sina

表13：ecs_touch_user_ifo (授权配备表)
字段
类型
Null
默认
注释
user_id
int(10)
否

取自user表user_id
aite_id
varchar(200)
否

此顾客授权登录唯一表达， 例如qq_CBFE5166681A713F637F43EF3F84BE96