《ThinkOX开发手册.doc》由会员分享，可在线阅读，更多相关《ThinkOX开发手册.doc（12页珍藏版）》请在金锄头文库上搜索。
1、ThinkOX二次开发手册 想天软件工作室ThinkOX开发手册想天软件工作室版本号修订人修订时间备注0.01蔡培超、陈一枭2014.4.4初稿0.02陈一枭2014.4.23补充AdminBuilder搜索部分，JS常用函数部分，重新排版0.03陈一枭2014.4.26补充点赞插件0.04陈一枭2014.5.4补充模态窗口0.05陈一枭2014.6.18补充后台权限0.06陈一枭2014.6.18加入目录结构说明，排版0.07陈一枭2014.7.1加入控制器的SEO优化说明目录目录3一、 文件结构4二、 常用函数5（一） PHP函数5（二） JS函数6三、 后台管理页面6（一） 后台权限约定
2、6（二） 配置页面6（三） 列表页面8（四） 排序页面9四、 积分提示10五、 点赞插件的使用10六、 模态窗口的使用10一、 文件结构+Addons 插件目录+Application 模块目录+Admin 后台模块+Api Api模块，放置一些可用于手机应用开发的接口+Common 公共模块，放置一些通用的模型，视图模板+Forum 贴吧模块+Home 主模块，主要包含了登陆和注册的页面+Install 程序安装模块+Issue 专辑模块+People 会员模块+User 用户中心，只存放用户中心的接口，没有模板+Usercenter 新增的个人中心，资料修改等的操作均放于此+Weibo 微
3、博模块+Data 数据库备份文件存放处+Database 存放临时的sql升级。+Public 静态文件存放处，一般存放js和css+static 公共静态文件+oneplus 存放thinkox的css和js+css 样式-oneplus.less 样式的less模板-oneplus.css 通过less编译生成的样式+js js文件+ext 第三方js插件+atwho 插件+magnific 弹窗插件+placeholder input组件占位符IE8兼容插件+slimscroll 滚动条插件+toastr 提示插件+images 公共用到的图片+QuickPacks v0.5版新增的补丁
4、存放位置+Runtime 动态缓存存放文件夹+Thinkphp TP内核+Uploads 上传文件夹+Avatar 头像存放文件夹二、 常用函数（一） PHP函数is_login()返回当前登录的用户编号。如果没有登录，则返回0。op_t($text)过滤html代码，防止XSS。参数：$text 字符串。返回值：经过过滤的字符串。getPagination($totalCount, $countPerPage=10)获取翻页html代码。参数：$totalCount：数据总数。$countPerPage：每页显示的数据数量。返回值：翻页的html代码。用法举例：class TestContr
5、oller extends Controller public function test($page=1)$list = D(MyData)-page($page,10)-select();$totalCount = D(MyData)-count();$this-assign(totalCount, $totalCount);$this-display();test.html.:getPagination($totalCount,10)query_user($fields,$uid=0)获取用户的详细信息。参数：$fields，字符串数组，表示需要获取的字段。目前支持：uid userna
6、me mobile email signature avatar32 avatar64 avatar128 avatar 256 avatar512 space_url icons_html title。$uid，可选，表示用户编号。默认值是当前登录的用户编号。举例：$user = query_user(array(username,avatar32);返回array(username=test, avatar32=/Uploads/Avatar/2014/03/31/5ab5d615a6_32_auto.jpg);getThumbImage ($filename, $width, $heig
7、ht, $cut, $replace)获取本地图片的缩略图。参数：$filename 图片的本地路径。$width 需要的图片宽度$height 需要的图片高度，可不填写，表示等比缩放。$cut true表示裁剪图片，false表示拉伸图片。$replace true表示重新缩放图片，false表示使用已经缩放的图片。friendlyDate($sTime)获取友好时间。参数：$sTime时间戳。（二） JS函数function op_success(text, title)/成功提示function op_info(text, title) /信息提示function op_warning(
8、text, title) /警告提示function friendlyDate(sTime, cTime)/友好时间function U(url, params, rewrite)/JS版U函数三、 后台管理页面（一） 后台权限约定凡是涉及到表单的action url，尽可能提交到本页面，通过IS_POST判断是否为表单提交。如不这么做，必须在菜单配置里加入该url的菜单，并设为隐藏，否则权限无法赋予。为了便于对后台进行二次开发，我们创造了AdminBuilder系列的辅助函数来快速创建后台管理页面。其中包括了配置页面（AdminConfigBuilder），列表页面（AdminListBui
9、lder），以及排序页面（AdminSortBuilder），以后还会继续增加新的辅助页面，并完善各页面的功能。参考页面WeiboController，ForumController。（二） 配置页面AdminConfigBuilder生成配置页。方法：title() 配置页的标题填入字段：keyHidden() 隐藏字段keyReadOnly() 只读字段keyText() 单行文本keyTextArea() 多行文本keyInteger() 整数字段keyUid() UID字段keyStatus() status字段keySelect() 下拉框字段keyRadio() 单选字段keyCh
10、eckBox() 多选字段。逗号分隔。keyEditor() 编辑器字段keyTime() 时间字段keyCreateTime() 创建时间字段keyBool() 是否字段keyUpdateTime() 更新时间字段keyTitle() 标题字段keyId() ID字段keyMultiUserGroup() 多个用户组字段keySingleUserGroup() 单个用户组字段填入数据：data($list)添加按钮buttonSubmit() 提交按钮buttonBack() 返回按钮用法示例：class TestController extends AdminController publ
11、ic function config($id)$data = D(MyData)-where(array(id=$id)-find();$builder = new AdminConfigBuilder();$builder-title(测试配置);$builder-keyId()-keyTitle()-keyCreateTime()-keyText(test_field,测试字段);$builder-data($data);$builder-buttonSubmit(U(myPostUrl)-buttonBack();$builder-display();（三） 列表页面AdminListB
12、uilder生成列表页。基本配置title() 页面标题setStatusUrl() 设置状态的地址buttonNew() “新增”按钮buttonDisable() “禁用”按钮buttonEnable() “启用”按钮buttonDelete() “删除”按钮buttonRestore() “还原”按钮buttonSort() “排序”按钮增加字段keyText() 文本字段keyHtml() Html字段keyMap() 映射字段。将字段的值映射到另一个值。keyId() ID字段keyLink() 带链接的字段keyStatus() status字段keyYesNo() 是否字段key
13、Bool() 是否字段，同keyYesNokeyTime() 时间字段keyCreateTime() 创建时间字段keyUpdateTime() 更新时间字段keyUid() 用户编号字段keyTitle() 标题字段keyDoAction() 添加操作字段keyDoActionEdit() 操作字段中添加编辑链接keyDoActionRestore() 操作字段中增加还原链接keyTruncText($name,$title,$length) 截断的字段。最多显示$length长度的字段。加入翻页组件pagination($totalCount,$listRow) 加入查询组件 /陈一枭public function search($title = 搜索,$name=key, $type = text, $des = , $attr) 加入一个文本类型搜索框设置搜索表单提交的URL /陈一枭setSearchPostUrl($url)，默认情况下提交到当前页面，所以无需设置传入数据data()用法演示：class TestController extends Controller public function listTest($page=1,$r=20)$list = D(MyTest)-page($p
