DoraCMS/README.md

#DoraCMS
#DoraCMS是基于Nodejs+express+mongodb编写的一套内容管理系统，结构简单，较目前一些开源的cms，doracms易于拓展，特别适合前端开发工程师做二次开发。
#操作文档链接：
#http://www.html-js.cn/details/Ey20NbBi.html
#http://www.html-js.cn/details/VkldQTPs.html
#开发文档链接：
#http://www.html-js.cn/details/VJpfeMYj.html(不断更新)
#开发文档下载
#http://7xkr1n.com1.z0.glb.clouddn.com/@/cms/DoraCMS开发指南.doc
#注意：开源后陆续发现了一些问题，我都提交了，今后也会持续补充，开发文档或遇到问题请直接参考我博客的文章(http://www.html-js.cn/details/VJpfeMYj.html),
#或者在该版块下留言，这里会不断更新，因为精力有限并不保证word版开发指南会保持最新，

#DoraCMS开发指南
#一、 DoraCMS 安装	2
#1.1 安装nodejs	2
#1.2 安装Mongodb。	2
#1.3 运行DoraCMS	3
#1.3.1启动mongodb	3
#1.3.2 插入初始数据	4
#1.3.3运行DoraCMS	5
#1.3.4 访问地址	6
#二、 DorCMS 开发	7
#2.1 配置文件	7
#2.2 关于路由	11
#2.3 关于模板	11
#2.4 实体类	13
#2.5 用到的插件	15
#2.6 关于编码	16
#三、总结	16
#四、FAQ	17


#一、DoraCMS 安装
#1.1 安装nodejs
#DoraCMS 是基于Nodejs 开发的，所以要想正常运行DoraCMS 需要nodejs环境。在Nodejs官网(https://nodejs.org/) 根据电脑版本下载对应的安装文件进行安装，安装完成后，打开命令窗口执行 node -v，如果出现版本号，证明安装成功。我的电脑是64位版本，安装了重启之后才生效。


#1.2 安装Mongodb。
#DoraCMS 使用的是Mongodb 的数据库，至于Mongodb 的特点和nosql的优势在此就不做详细描述了。安装方法很简单，到官网 (https://www.mongodb.org/) 下载对应版本，直接安装就可以了。这里有一点需要注意的是，如果你安装在D盘，安装完成后，在D盘根目录下创建文件夹 data ,不然启动mongo会提示数据库路径错误，当然你也可以通过命令启动mongodb来指定数据库的路径，如果你不想麻烦，就照我说的处理就可以了。

#1、在本地盘建立一个文件夹（最好英文名称），通过svn checkout 出DoraCMS的代码，svn地址：svn://git.oschina.net/doramart/DoraCMS  

#注：.idea 不属于项目文件夹，为webstorm 工程文件，不必理会。

#1.3 运行DoraCMS
#1.3.1启动mongodb
#找到mongodb安装目录下bin文件夹，执行 mongod.exe



#1.3.2 插入初始数据
#在《DoraCMS操作指南》 中有提到插入初始管理数据，因为刚安装的数据是空的，需要插入初始数据来管理后台，这里重新介绍一次：
#①、找到Mongodb安装目录(MongoDB\Server\3.0\bin) 执行 mongo.exe
#②、输入 use doracms
#③、插入用户组数据:

db.admingroups.insert({
  "_id" : "4yTbsWiI",
  "name" : "超级管理员",
  "power" : "{\"sysTemManage_0_1\":true,\"sysTemManage_0_2\":true,\"sysTemManage_0_3\":true,\"sysTemManage_0_4\":true,\"sysTemManage_0_5\":true,
\"contentManage_1_1\":true,\"contentManage_1_2\":true,\"contentManage_1_3\":true,\"userManage_2_1\":true,\"projectManage_3_1\":true,
\"projectManage_3_2\":true,\"projectManage_3_3\":true,\"contentManage_1_4\":true,\"contentManage_1_5\":true,\"sysTemManage_0_6\":true,
\"contentManage_1_6\":true}",
  "date" : ISODate("2015-06-30T08:04:46.092Z"),
  "__v" : 0
})

#④、插入用户数据：
db.adminusers.insert({
  "_id" : "E1jNjZi8",
  "name" : "test",
  "username" : "test",
  "password" : "581fbebb8a5f5827",
  "phoneNum" : 12358563215.0,
  "email" : "doramart@qq.com",
  "group" : "4yTbsWiI",
  "comments" : "doramart",
  "logo" : "/upload/images/defaultlogo.png",
  "date" : ISODate("2015-06-18T01:17:15.007Z"),
  "__v" : 0
})

#⑤、插入数据如果存在格式问题，需要在记事本里编辑一下。如果上述执行正常，那么默认的登录名和密码为  test / 000000  ,这样，您就可以正常登录后台了。

#1.3.3运行DoraCMS
#在刚刚svn下载的代码目录下 调出cmd命令窗口，执行npm start 



#如果没有报错，证明运行成功了。
#注意：DoraCMS 指定了默认端口号为80，如果您的机器已经占用了80端口，这里会报错，如果想修改默认端口号，可以到代码的bin目录下 www 文件修改，当然修改完成，访问路径记得带上端口号：



#至此，doraCMS就运行起来了


#1.3.4 访问地址
前台：127.0.0.1 (默认80端口)
后台：127.0.0.1/admin


#二、DorCMS 开发
#2.1 配置文件
#DoraCMS 的主要配置在 settings.js 中设置（/onlineCMS/models/db/settings.js）:

//    数据库配置
    COOKIE_SECRET: 'doramart.com',
    URL: 'mongodb://127.0.0.1:27017/doracms',
    DB: 'doracms',
    HOST: '127.0.0.1', // 数据库地址
    PORT: 27017, // 数据库端口号
    USERNAME: 'doracms', // 数据库用户名
    PASSWORD: '000000', // 数据库密码

//    站点基础信息配置
    SITETITLE : '前端开发俱乐部', // 站点名称
    SITEDOMAIN : 'http://www.html-js.cn', // 站点域名
    SITEICP : '粤ICP备111111号-2', // 站点备案号
    SYSTEMMAIL : 'xxxx@163.com', //站点邮箱
    UPDATEFOLDER : process.cwd()+'/public/upload', // 默认上传文件夹本地路径
    TEMPSFOLDER : process.cwd()+'/views/web/temp', // 默认模板文件夹本地路径
    DATAOPERATION : process.cwd()+'/models/db/bat', //数据库操作脚本目录
    DATABACKFORDER : 'C:/softbak/xxxx/', // 服务端数据库操作脚本目录
    CMSDISCRIPTION : '前端开发俱乐部,分享前端知识,丰富前端技能。汇集国内专业的前端开发文档,为推动业内前端开发水平共同奋斗。html,js,css,nodejs,前端开发,jquery,web前端, web前端开发, 前端开发工程师',
    SITEKEYWORDS : '前端开发俱乐部,前端俱乐部,DoraCMS内容管理系统, 前端开发, web前端, web前端开发, 前端开发工程师, 设计, 开发, 前端资源, angularjs, JavaScript,js, Ajax, jQuery, html,html5,css3,浏览器兼容, 前端开发工具, nodejs , node , boostrap',
    SITEBASICKEYWORDS : '前端开发俱乐部,前端开发,前端俱乐部,DoraCMS', // 基础关键词
    STATICFILEPATH : '', // 静态文件空间地址
    UPDATEFILEPATH : '', // 上传文件空间地址
    QINIUACCESS_KEY : '',  // 七牛秘钥
    QINIUSECRET_KEY : '',  // 七牛秘钥
QINIUCMSBUCKETNAME : '',  // 七牛Bucket_Name

#针对上面这些静态参数都进行了详细的注释，如果你设置了数据库账号密码，则需要在这里做相应的配置，同时需要在 Dbopt.js 中做相应的数据库连接设置。



#Settings.js 中有四个参数需要注意一下：
#UPDATEFOLDER : process.cwd()+'/public/upload', // 默认上传文件夹本地路径
#TEMPSFOLDER : process.cwd()+'/views/web/temp', // 默认模板文件夹本地路径
#DATAOPERATION : process.cwd()+'/models/db/bat', //数据库操作脚本目录
#上面三个参数原则上不用修改，UPDATEFOLDER 指定上传文件的目录，TEMPSFOLDER 为指定的模板文件夹，DATAOPERATION 为执行数据备份的脚本目录文件夹

#DATABACKFORDER : 'C:/softbak/xxxx/', // 服务端数据库操作脚本目录
#DATABACKFORDER 指定数据备份的本地路径。

#下面的配置都是后台模块的静态参数：

SYSTEMMANAGE : 'sysTemManage_0',  // 后台模块(系统管理)
    ADMINUSERLIST : 'sysTemManage_0_1',
    ADMINGROUPLIST : 'sysTemManage_0_2',
    EMAILTEMPLIST : 'sysTemManage_0_3',
    ADSLIST : 'sysTemManage_0_4',
    FILESLIST : 'sysTemManage_0_5',
    DATAMANAGE : 'sysTemManage_0_6', // 数据管理
    BACKUPDATA : 'sysTemManage_0_6_1', // 数据备份


    CONTENTMANAGE : 'contentManage_1', // 后台模块(内容管理)
    CONTENTLIST : 'contentManage_1_1',
    CONTENTCATEGORYS : 'contentManage_1_2',
    CONTENTTAGS : 'contentManage_1_3', //标签管理
    CONTENTTEMPS : 'contentManage_1_4', //模板管理
    CONTENTTYPES : 'contentManage_1_5',  // 内容属性管理
    CONTENTFILMTYPES : 'contentManage_1_5_1',  // 内容属性管理
    CONTENTCOUNTRYTYPES : 'contentManage_1_5_2',  // 内容属性管理
    CONTENTYEARSTYPES : 'contentManage_1_5_3',  // 内容属性管理
    MESSAGEMANAGE : 'contentManage_1_6', // 留言管理

    USERMANAGE : 'userManage_2', // 后台模块(会员管理)
REGUSERSLIST: 'userManage_2_1'

#改参数对应后台模板文件 adminTemp.ejs 中的模块列表的：


#也就是说，如果新增模块，需要在配置文件(settings.js) 和 adminTemp.ejs 中配置相应的cid。
#这个属性是权限控制需要的，除此之外，加入新模块后，需要在权限管理模块加入新模块，并配置对应的cid





#2.2 关于路由

#DoraCMS 中所有的请求都是通过nodejs的路由来处理的，原理类似于java中的 struts 。
路由文件在routes文件夹下



Admin.js , 后台所有模块管理路由
Content.js 前台文档相关
Index.js 首页相关（也包含文档列表和文档相亲）
System.js 系统操作的相关路由 （比如文件上传、邮件发送等）
Users.js 用户中心的相关请求走这里
Validat.js 后台权限控制（没有授予管理权限(session)会直接过滤掉请求）


#2.3 关于模板
#DoraCMS 是基于ejs 模板引擎来表现前台页面的，选择ejs 是因为比jade更好理解一些。属性js的童鞋也好接受ejs的语法来展示数据。DoraCMS 的模板文件都在 views 文件夹下：



#解析：
#1、views 下的 index.ejs 为首页主体内容，sitemap.ejs 是站点地图的主体内容，sitemap.ejs是展示给用户看的，不需要手动更新。
#2、Web 为前台的所有模板文件，web根目录下的 do404.ejs, do505.ejs , dosuccess.ejs 是处理操作过程结果反馈的模板，这些是普遍需要用到的。
#3、Users 是用户相关页面模板。
#4、Temp中包含了公共header和footer，以及文档模板，aboutMe、blog、lab 都属于文档模板，可以根据自己的需要自行添加。


#5、public 文件夹中的模板暂时没用到。
#6、Manage 里是后台的所有页面模板，adminTemp.ejs 是模板外壳，里面包含了各个模块列表和一些公共的引用。


#7、public 文件夹下是公共目录，主要放置静态文件，包括前台和后台的静态js，css，以及DoraCMS 用到的jquery插件等。Public 下的文件都是公开的，在app.js 中设置。

#2.4 实体类
#这里称为“实体类”可能有些不妥，在java中，这部分确实就叫实体类，代表每个对象所具有的属性，文件存放于models 文件夹中。




#每个对象都有详细注释，开发者自己去查看就可以了。


#2.5 用到的插件
#开发过程中，很多功能并不是自己写的，用到了npm上比较优秀的一些插件，在此选出一些做介绍，所有插件在 node_modules 下



#1、Express nodejs 框架，是DoraCMS的基础框架
#2、Gm 图片缩略图，为上传图片生成指定大小的缩略图
#3、Moment 时间格式化工具，功能非常强大
#4、Nodemailer nodejs邮件发送组件
#5、Formidable 文件上传组件
#6、Qiniu 七牛云存储组件，用于将文件上传到七牛上
#7、Qr-image 用户将自定义链接生成二维码图片的组件，轻量级 很方便
#8、Archiver 文件夹压缩工具，将指定文件夹压缩为zip
#9、Shortid 用在了实体类中，用于生成短id替代 mongodb 的长id
#10、Validator 用户服务端数据校验，提供很多方法对数据进行校验
#11、Ueditor-nodejs 将nodejs和百度的ueditor整合，这个组件感觉很有用
#12、Mongoose 用于nodejs 连接 mongodb，并提供了丰富的数据处理的接口


#2.6 关于编码
#1、DoraCMS 的编码，前台主要用到了 ejs 模板和ejs语法 展示数据；后台主要用到了ejs和 angularjs 来展示数据。不熟悉 angularjs 的童鞋和简单了解一下，对于后台展示数据非常方便，但是不适合前台，因为angularjs 不适合做seo 。
#2、DoraCMS 基于 nodejs + express 编写，所以前端基本是div+css+js ,服务端主要是js，对js比较了解的前端开发者很容易就能上手。
#3、DoraCMS 80%的代码都有注释，详细介绍了接口的用途和细节处理，方便查看。



#三、总结

#DoraCMS 开发时间比较短，功能并不是很丰富，但是麻雀虽小、五脏俱全，基本功能都是具备的。由于DoraCMS是本人独立开发，由于技术有限难免会有些处理不好的地方，或者一些很明显的bug（虽然我也在不断的改善），如果您发现了问题，请您不佞赐教，如果确实存在问题，我会不断的更新上去，这也是开源的目的之所在。如果您有更好的解决方案或者对DoraCMS有更好的想法，也可以通过我的博客联系我，让我们一起探讨，共同进步。


#四、FAQ

#1、一直没看到说设置数据库密码，这样安全么？
#当然不安全，本地调试可以不用设置密码，程序部署上去肯定是要设置数据库账号密码的，怎样设置呢，给个链接大家可以参考下：
#http://ibruce.info/2015/03/03/mongodb3-auth/

#2、网络上很多cms都很强大，为什么要选择DoraCMS ？
#当然，目前很多成熟的cms（织梦、phpcms等），DoraCMS 刚起步自然比不了，首先DoraCMS创建的目的是为了更深入的了解nodejs并付诸实践，开源的目的也是为了通过案例来不断改进我们的nodejs水平，共同提高；其次DoraCMS结构清晰、模块简单，上手很容易。目前市面的cms结构复杂，想要自己修改定制学习成本比较高。初识nodejs的开发者可以了解一个cms实现的基础过程，熟悉nodejs的也可以用DoraCMS 来进行二次开发，不用再从头开始。DoraCMS 遵循MIT协议完全开源，您可以自由定制属于你自己的网站而不必花很多时间去处理最基础的一些东西，为了让更多的人去了解和认识nodejs，于是DoraCMS 诞生了。

#3、演示地址在哪里?
 
#http://www.html-js.cn  基于DoraCMS 定制的博客系统
#http://www.dailyads.cn 基于 DoraCMS 定制的视频分享站点

4、为什么上传图片失败？

#DoraCMS 默认在3个地方用到了上传：用户上传头像、添加文档主图、内容详情中文件、图片或附件上传。
#其中用户上传头像、添加文档主图默认使用七牛，所以如果您没有配置七牛云存储开发者相关信息，就会上传失败，需要在 /models/db/setting.js 下进行配置:

#(七牛免费10G空间，注册账号就可以获取到相关信息了)。
#当然，有的童鞋不想用七牛，想直接传到网站相关目录，也是可以的。DoraCMS 预留的有通过 uploadify 上传图片或文件，而且上传接口自带了图片缩略图截取功能。您可以通过查看 /public/javascripts/webapp.js 下的 initUploadLogoBtn 方法：
//初始化用户上传头像按钮
function initUploadLogoBtn($scope){
    $("#uploadify").uploadify({
        //指定swf文件
        'swf': '/plugins/uploadify/uploadify.swf',
        //后台处理的页面
        'uploader': '/system/upload?type=images&key=userlogo',
        //按钮显示的文字
        'buttonText': '选择图片',
        //显示的高度和宽度，默认 height 30；width 120
        'height': 40,
        'width': 138,
        //上传文件的类型  默认为所有文件    'All Files'  ;  '*.*'
        //在浏览窗口底部的文件类型下拉菜单中显示的文本
        'fileTypeDesc': 'Image Files',
        //允许上传的文件后缀
        'fileTypeExts': '*.gif; *.jpg; *.png',
        //发送给后台的其他参数通过formData指定
//                    'formData': { 'type': 'images', 'key': 'ctTopImg' },
        //上传文件页面中，你想要用来作为文件队列的元素的id, 默认为false  自动生成,  不带#
        //'queueID': 'fileQueue',
        //选择文件后自动上传
        'auto': true,
        //设置为true将允许多文件上传
        'multi': true,
        //上传成功
        'onUploadSuccess' : function(file, data, response) {
                alert("上传成功");

//            $('#logoPath').val(data);
            $scope.logoFormData.logo = data;
            $("#myImg").attr("src",data);
            $('#submitLogo').removeClass('disabled');
        },
        'onComplete': function(event, queueID, fileObj, response, data) {//当单个文件上传完成后触发
            //event:事件对象(the event object)
            //ID:该文件在文件队列中的唯一表示
            //fileObj:选中文件的对象，他包含的属性列表
            //response:服务器端返回的Response文本，我这里返回的是处理过的文件名称
            //data：文件队列详细信息和文件上传的一般数据

            alert("文件:" + fileObj.name + " 上传成功！");
        },
        //上传错误
        'onUploadError' : function(file, errorCode, errorMsg, errorString) {
            alert('The file ' + file.name + ' could not be uploaded: ' + errorString);
        },
        'onError': function(event, queueID, fileObj) {//当单个文件上传出错时触发
            alert("文件:" + fileObj.name + " 上传失败！");
        }
    });
}

#通过上面的初始化按钮方法，您可以找到后台上传接口和处理方式。这两种上传方式您可以自己选择。