分享

OneThink学习笔记

 quasiceo 2016-08-05

OneThink学习笔记

时间:2016-05-07 12:38:36      阅读:671      评论:0      收藏:0      [点我收藏+]

标签:

 

OneThink1.0开发手册:

http://document./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. ├─Application 应用模块目录
  5. ├─Admin 后台模块
  6. ├─Conf 后台配置文件目录
  7. ├─Common 后台函数公共目录
  8. ├─Controller 后台控制器目录
  9. ├─Model 后台模型目录
  10. ├─Logic 后台模型逻辑目录
  11. └─View 后台视图文件目录
  12. ├─Common 公共模块目录(不能直接访问)
  13. ├─Conf 公共配置文件目录
  14. ├─Common 公共函数文件目录
  15. ├─Controller 模块访问控制器目录
  16. └─Model 公共模型目录
  17. ├─Home Home 前台模块
  18. ├─Conf 前台配置文件目录
  19. ├─Common 前台函数公共目录
  20. ├─Controller 前台控制器目录
  21. ├─Model 前台模型目录
  22. └─View 模块视图文件目录
  23. └─User 用户模块(不能直接访问)
  24. ├─Api 用户接口文件目录
  25. ├─Conf 用户配置目录
  26. ├─Common 后台函数公共目录
  27. ├─Model 用户模型目录
  28. └─Service 用户Service文件目录
  29. ├─Public 应用资源文件目录
  30. ├─Runtime 应用运行时目录
  31. ├─ThinkPHP 框架目录
  32. └─Uploads 上传根目录
  33. ├─Download 文件上传目录
  34. ├─Picture 图片上传目录
  35. └─Editor 编辑器图片上传目录

静态资源目录结构

  1. ├─Public 应用资源文件目录
  2. ├─Admin 后台资源文件目录
  3. ├─css 样式文件目录
  4. ├─images 图片文件目录
  5. └─js 脚本文件目录
  6. ├─Home 前台资源文件目录
  7. ├─css 样式文件目录
  8. ├─images 图片文件目录
  9. └─js 脚本文件目录
  10. └─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.phpThink.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了。

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多