OneThink学习笔记01

OneThink1.0开发手册：

http://document.onethink.cn/manual_1_0.html

简介

 OneThink是一个开源的内容管理框架，基于最新的ThinkPHP3.2版本开发，提供更方便、更安全的WEB应用开发体验，采用了全新的架构设计和命名空间机制，融合了模块化、驱动化和插件化的设计理念于一体，开启了国内WEB应用傻瓜式开发的新潮流。

[ 主要特性 ]

1. 基于ThinkPHP最新3.2版本。
2. 模块化：全新的架构和模块化的开发机制，便于灵活扩展和二次开发。
3. 文档模型/分类体系：通过和文档模型绑定，以及不同的文档类型，不同分类可以实现差异化的功能，轻松实现诸如资讯、下载、讨论和图片等功能。
4. 开源免费：OneThink遵循Apache2开源协议,免费提供使用。
5. 用户行为：支持自定义用户行为，可以对单个用户或者群体用户的行为进行记录及分享，为您的运营决策提供有效参考数据。
6. 云端部署：通过驱动的方式可以轻松支持平台的部署，让您的网站无缝迁移，内置已经支持SAE和BAE3.0。
7. 云服务支持：即将启动支持云存储、云安全、云过滤和云统计等服务，更多贴心的服务让您的网站更安心。
8. 安全稳健：提供稳健的安全策略，包括备份恢复、容错、防止恶意攻击登录，网页防篡改等多项安全管理功能，保证系统安全，可靠、稳定的运行。
9. 应用仓库：官方应用仓库拥有大量来自第三方插件和应用模块、模板主题，有众多来自开源社区的贡献，让您的网站“One”美无缺。

OneThink只是一个内容管理框架，并不是一个真正意义的CMS，所以你不会看到很多的功能，也不要因此而抱怨，因为一切功能都来自于您的创造或者大家的分享。这才是OneThink的理念和定位。OneThink集成了一个完善的后台管理体系和前台模板标签系统，让你轻松管理数据和进行前台网站的标签式开发。

[ 主要功能 ]

1. 用户Passport系统
2. 配置管理系统
3. 权限控制系统
4. 后台建模系统
5. 多级分类系统
6. 用户行为系统
7. 钩子和插件系统
8. 系统日志系统
9. 数据备份和还原

利用OneThink现有的后台功能和标签库机制，你可以轻松的定制或者开发基于OneThink的网站和应用。

[ 最低系统需求 ]

•PHP 5.3.0 或更高版本。
•MySQL 5.0 或更高版本。

[ 系统安装 ]

1. 将OneThink压缩包解压至一个空文件夹，并上传它。
2. 首次在浏览器中访问index.php，将会进入安装向导。
3. 按照安装向导完成安装。若在安装过程中出现问题，请访问官网讨论区寻求帮助。

OneThink支持直接在SAE以及BAE3.0平台上直接安装。

应用架构及目录结构

 

应用目录结构

1. wwwroot
2. ├─index.php OneThink入口文件
3. ├─Addons 插件目录
4. │
5. ├─Application 应用模块目录
6. │ ├─Admin 后台模块
7. │ │ ├─Conf 后台配置文件目录
8. │ │ ├─Common 后台函数公共目录
9. │ │ ├─Controller 后台控制器目录
10. │ │ ├─Model 后台模型目录
11. │ │ ├─Logic 后台模型逻辑目录
12. │ │ └─View 后台视图文件目录
13. │ │
14. │ ├─Common 公共模块目录（不能直接访问）
15. │ │ ├─Conf 公共配置文件目录
16. │ │ ├─Common 公共函数文件目录
17. │ │ ├─Controller 模块访问控制器目录
18. │ │ └─Model 公共模型目录
19. │ │
20. │ ├─Home Home 前台模块
21. │ │ ├─Conf 前台配置文件目录
22. │ │ ├─Common 前台函数公共目录
23. │ │ ├─Controller 前台控制器目录
24. │ │ ├─Model 前台模型目录
25. │ │ └─View 模块视图文件目录
26. │ │
27. │ └─User 用户模块（不能直接访问）
28. │ ├─Api 用户接口文件目录
29. │ ├─Conf 用户配置目录
30. │ ├─Common 后台函数公共目录
31. │ ├─Model 用户模型目录
32. │ └─Service 用户Service文件目录
33. │
34. ├─Public 应用资源文件目录
35. ├─Runtime 应用运行时目录
36. ├─ThinkPHP 框架目录
37. └─Uploads 上传根目录
38. ├─Download 文件上传目录
39. ├─Picture 图片上传目录
40. └─Editor 编辑器图片上传目录

静态资源目录结构

1. ├─Public 应用资源文件目录
2. │ ├─Admin 后台资源文件目录
3. │ │ ├─css 样式文件目录
4. │ │ ├─images 图片文件目录
5. │ │ └─js 脚本文件目录
6. │ │
7. │ ├─Home 前台资源文件目录
8. │ │ ├─css 样式文件目录
9. │ │ ├─images 图片文件目录
10. │ │ └─js 脚本文件目录
11. │ │
12. │ └─static 公共资源文件目录

==============================================================

模板开发指南

 

基础知识

见 ThinkPHP3.2手册 视图部分

Onethink后台模板

后台使用了模板继承，基础模板位于 View/Public/base.html。其他模板都位于对应的控制器模板目录。

后台公共js文件位于Public/Admin/Js/common.js,这个js文件是在页面主体内容之后加载。

后台公共css文件位于Public/Admin/Css/base.css

在具体的控制器模板中，你可以通过继承重置<block name="script"></block>来向当前模板加入新的js。这些代码在common.js之后执行。

Onethink前台模板

前台模板比较少，通常二次开发时会删除所有模板，根据设计重新组织和编写前台模板，所以这里对模板文件和目录不做介绍。

标签库

OneThink定义了两个标签库Think和Article，类文件位于ThinkPHP/Library/OT/TagLib，文件名为Article.class.php和Think.class.php，如有需要，您可以在该目录下创建自己的标签库。

Think标签库

Article标签库

1. 'partlist' => array('attr' => 'id,field,page,name', 'close' => 1), //段落列表
2. 'partpage' => array('attr' => 'id,listrow', 'close' => 0), //段落分页
3. 'prev' => array('attr' => 'name,info', 'close' => 1), //获取上一篇文章信息
4. 'next' => array('attr' => 'name,info', 'close' => 1), //获取下一篇文章信息
5. 'page' => array('attr' => 'cate,listrow', 'close' => 0), //列表分页
6. 'position' => array('attr' => 'pos,cate,limit,filed,name', 'close' => 1), //获取推荐位列表
7. 'list' => array('attr' => 'name,category,child,page,row,field', 'close' => 1), //获取指定分类列表

Article:list 标签补充说明

category 属性 最好是带单引号， 如 category="'0'" 因为标签库里判断了empty， 可能导致0 相当于没传参数

Article:position 标签补充说明：

1. pos 是数字，后台有 ：
2. 1:列表推荐
3. 2:频道推荐
4. 4:首页推荐

所以一般前台读取的时候，一般传指定的数字如 pos="1" 这种

而cate 这边比较坑， 默认你传指定的45 单数字没问题， 传多个分类 45,46 这样不行的，必须带单引号 如 cate="'45,46'"

 

onethink常用标签的使用示例

 

首页文章模型列表输出：

<article:list name="article" category="2" row="3" order="update_time desc" limit="0,1" child="true">

阅读：{$article.view}
发布时间：{$article.create_time|date='m-d',###}
作者：{$article.uid|get_username}

文章标题：{$article.title}
原文链接：{:U('Article/detail?id='.$article['id'])}
文章描述：{$article.description}

封面图片：<img src="{$article.cover_id|get_cover=###,'path'}" />

分类链接：{:U('Article/lists?category='.get_category_name($article['category_id']))}
分类标题{$article.category_id|get_category_title}

</article:list>

首页简介（单个文章）输出：

{$wdjj.content|strip_tags|mb_substr=0,150,"UTF8"}

文章详情页：

标题：{$info.title}

作者：{$info.uid|get_username}

时间：{$info.create_time|date='Y-m-d H:i',###}

内容：{$info.content}

下载尺寸：{$info.size}

下载次数：{$info.download}

描述：{$info.description|default='暂无描述'}

分页：

<article:prev name="prev" info="info">
<a href="{:U('?id='.$prev['id'])}">上一篇</a>
</article:prev>

<article:next name="next" info="info">
<a href="{:U('?id='.$next['id'])}">下一篇</a>
</article:next>

分类列表：

<volist name="category" id="cate">
    <eq name="current" value="$cate['id']">
        <li class="active">
            <a href="{:U('Article/lists?category='.$cate['name'])}">
                <i class="icon-chevron-right"></i>{$cate.title}
            </a>
        </li>
    <else/>
        <li>
            <a href="{:U('Article/lists?category='.$cate['name'])}">
                <i class="icon-chevron-right"></i>{$cate.title}
            </a>
        </li>
    </eq>
</volist>

oneThink后台添加插件步骤详解

 

内容管理框架：oneThink

版本：V1.1.141212 (注：v1.1也有很多版本，一不小心就下到V1.1.140202 去了，还有其他版本，建议去代码托管平台下载最新版本)

我也不偷懒，把每一步步骤都记录下来。

一、进入后台，创建插件

这里的钩子我新建了一个indexFooter，因为我只需在前台首页底部显示友情链接即可。我们把上面所有要勾的地方都勾上，至于有什么区别，大家可以自己建几个例子区分一下，生成的文件是否一样。OK！到这里 我们的友情链接插件就创建好了！点击“确定”。(这里的自定义模板什么的，通通不填，我会在下篇文章演示添加自定义模板的效果)

二、点击“安装” 即可，找到我们刚安装好的Links插件，点击“设置”,你会看到它有个默认的“是否开启随机”的选项，这里我们不管它，因为我们用不上，等下要删掉的。安装后，我们可以在左侧导航“已安装插件后台”看到我们新建的“友情链接”

三、当我们点击左侧导航的“友情链接”，你会发现报错，大概就是说的某个表不存在。是的，我们刚才只是建了插件，如果涉及到数据存储到数据库， 还需要建表。这里不直接去数据库里建，因为这样做，是很不人性化的。那我们就找到安装插件的函数，在安装插件的时候建立数据库，这样就好了。首先系统的插件全部存放在 根目录/Addons/ 文件夹下面，打开此文件夹，我们看到有个Links文件夹，这就是我们刚创建的插件，一个插件对应一个文件夹。打开Links文件夹，里面有2个文件和2个文件夹。

四、其实现在oneThink做的越来越简洁了，不懂PHP的人照样创建插件，之后你就会发现。当然，如果你有自己的想法，不想局限于官方的限制，那还是要把php学好的。

五、打开插件入口文件：LinksAddon.class.php 里面有个类 LinksAddon，先来分析一下这个文件吧

我这里把 $admin_list 数组的model 值改成links了，为了与插件对应。接下来我们在install方法里添加新建数据库的语句，这样我们在安装插件的时候，就会新建数据库了，我的代码如下：

 1     public function install(){　　//安装插件的方法
 2         //1、添加数据表
 3         $model = D();
 4         $db_prefix = C('DB_PREFIX');
 5         $table_name = "{$db_prefix}links";
 6
 7         $sql=<<<SQL
 8 CREATE TABLE IF NOT EXISTS `$table_name` (
 9   `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
10   `title` varchar(80) NOT NULL DEFAULT '' COMMENT '站点名称',
11   `link` varchar(140) NOT NULL DEFAULT '' COMMENT '链接地址',
12   `summary` varchar(255) NOT NULL DEFAULT '' COMMENT '站点描述',
13   `mailto` varchar(100) NOT NULL DEFAULT '' COMMENT '站长联系方式',
14   `sort` int(3) unsigned NOT NULL DEFAULT 0 COMMENT '优先级',
15   `nofollow` tinyint(1) unsigned NOT NULL DEFAULT 0 COMMENT '是否追踪',
16   `type` tinyint(3) unsigned NOT NULL DEFAULT 1 COMMENT '类型分组',
17   `cover_id` int(11) unsigned NOT NULL DEFAULT 0 COMMENT '封面图片',
18   `status` tinyint(2) NOT NULL DEFAULT 1 COMMENT '状态（0：禁用，1：正常）',
19   `create_time` int(11) unsigned NOT NULL DEFAULT 0 COMMENT '添加时间',
20   PRIMARY KEY (`id`)
21 ) ENGINE=MyISAM AUTO_INCREMENT=4 DEFAULT CHARSET=utf8 ROW_FORMAT=DYNAMIC COMMENT='友情连接表';
22 SQL;
23
24         $model -> execute($sql);//执行sql语句
25
26         //2、返回true，表示插件安装成功
27         return true;
28     }

我这里省略了很多细节判断，大家自己完善。

六、既然在安装插件的时候，新建了表，我们在卸载的插件的时候就要把表给删除，不然下次安装该插件的时候就会出问题。所以我们uninstall 方法代码如下：

        public function uninstall(){ //卸载插件的方法
            $model = D();
            $db_prefix = C('DB_PREFIX');
            $table_name = "{$db_prefix}links";
            $sql="DROP TABLE IF EXISTS `".$table_name."`;";
            $model -> execute($sql);//执行sql语句    

            return true;
        }

好了，到这里就差不多了，保存一下LinksAddon.class.php 文件，应该可以正常显示了，我们来看看。进入插件列表，先把Links插件卸载，然后重新安装。点击左侧菜单“友情链接”，可以看到

之所以能正常显示这个列表，是因为系统有默认的模板，在\Application\Admin\View\Addons 文件夹里，有兴趣的同学可以研究一下这几个模板文件，其中这个列表的模板就是adminlist.html，那么我们要把封面、书名、描述等等这些字眼改掉，要去模板里改吗？细心的同学估计注意到了，在LinksAddon.class.php 文件 的$admin_list 数组里配置的，其他的看后面的注释就明白，这里详细说一下 list_grid 关联的数组。我们刚才新建的links数据表有id、title、link等字段，你想在这个列表显示什么字段，都可以添加。我这里代码如下：

'list_grid'=>array(         //这里定义的是除了id序号外的表格里字段显示的表头名和模型一样支持函数和链接
                'title:网站名称',
                'link:链接',
                'summary:描述',
                'create_time|time_format:添加时间', //time_format 是一个函数，把时间格式化，其他地方想使用什么函数也可以按照这种格式书写
                'id:操作:[EDIT]|编辑,[DELETE]|删除'
            ),

保存，刷新后台友情链接列表

我们点击“新增” 来增加一个友情链接吧，你会发现，只有一个书名字段。我们打开Model/LinksModel.class.php 文件，我这里分别解释一下这两个自带的数组，具体看下面代码里的注释

class LinksModel extends Model{
    public $model = array(
        'title'=>'',//新增[title]、编辑[title]、删除[title]的提示
        'template_add'=>'',//自定义新增模板自定义html edit.html 会读取插件根目录的模板
        'template_edit'=>'',//自定义编辑模板html
        'search_key'=>'',// 搜索的字段名，默认是title
        'extend'=>1, //在后台列表是否显示 “增加”、“删除” 按钮，0-不显示 1-显示
    );

    public $_fields = array(
        'id'=>array(
            'name'=>'id',//字段名，与数据库的字段对应
            'title'=>'ID',//显示标题
            'type'=>'num',//字段类型：num、string、textarea、datetime、bool、select、radio、checkbox、editor、picture（封面）、file（附件）、
            'remark'=>'',// 备注，相当于配置里的tip
            'is_show'=>3,// 1-始终显示 2-新增显示 3-编辑显示 0-不显示
            'value'=>0,//默认值
        ),
　　　　//下面演示一下 select字段怎么显示 radio、checkbox同理
        'type'=>array(
            'name'=>'type',
            'title'=>'类型',
            'type'=>'select',
            'remark'=>'请选择所属类型',
            'is_show'=>1,
　　　　　　　'extra'=>'0:友情链接,1:合作站点',
            'value'=>0,
            'is_must'=>1,
        ),
    );
}

ok,我最后的效果是这样的：

添加一条数据看看吧：

这里要显示具体类型、显示图片等，需要自定义adminlist.html模板了。关于自定义模板，我们下一篇文章再说。关于钩子，其实就是写一个函数从数据库读取数据，然后在前台需要的地方调用钩子就行。如果需要模板，则在钩子函数里解析模板。钩子调用格式一般：

{:hook("钩子名称"),"[参数]"} 没参数就不写。直接写成这样{:hook("钩子名称")}

到此为止就是用系统默认的模板，一步一步的建立自己的插件，是不是很简单，就像填空题一样，只要按照它的规则填空，就ok了。

==================================================