DoraCMS开发指南.docx
- 文档编号:24949111
- 上传时间:2023-06-03
- 格式:DOCX
- 页数:23
- 大小:880.06KB
DoraCMS开发指南.docx
《DoraCMS开发指南.docx》由会员分享,可在线阅读,更多相关《DoraCMS开发指南.docx(23页珍藏版)》请在冰豆网上搜索。
DoraCMS开发指南
DoraCMS开发指南
DoraCMS开发指南1
一、DoraCMS安装2
1.1安装nodejs2
1.2安装Mongodb。
2
1.3运行DoraCMS3
1.3.1启动mongodb3
1.3.2插入初始数据4
1.3.3运行DoraCMS5
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
四、FAQ17
1、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、在本地盘建立一个文件夹(最好英文名称),通过svncheckout出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
②、输入usedoracms
③、插入用户组数据:
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@",
"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命令窗口,执行npmstart
如果没有报错,证明运行成功了。
注意:
DoraCMS指定了默认端口号为80,如果您的机器已经占用了80端口,这里会报错,如果想修改默认端口号,可以到代码的bin目录下www文件修改,当然修改完成,访问路径记得带上端口号:
至此,doraCMS就运行起来了
1.3.4访问地址
前台:
127.0.0.1(默认80端口)
后台:
127.0.0.1/admin
2、DorCMS开发
2.1配置文件
DoraCMS的主要配置在settings.js中设置(/onlineCMS/models/db/settings.js):
//数据库配置
COOKIE_SECRET:
'',
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-',//站点域名
SITEICP:
'粤ICP备111111号-2',//站点备案号
SYSTEMMAIL:
'xxxx@',//站点邮箱
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、Expressnodejs框架,是DoraCMS的基础框架
2、Gm图片缩略图,为上传图片生成指定大小的缩略图
3、Moment时间格式化工具,功能非常强大
4、Nodemailernodejs邮件发送组件
5、Formidable文件上传组件
6、Qiniu七牛云存储组件,用于将文件上传到七牛上
7、Qr-image用户将自定义链接生成二维码图片的组件,轻量级很方便
8、Archiver文件夹压缩工具,将指定文件夹压缩为zip
9、Shortid用在了实体类中,用于生成短id替代mongodb的长id
10、Validator用户服务端数据校验,提供很多方法对数据进行校验
11、Ueditor-nodejs将nodejs和XX的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、DoraCMS80%的代码都有注释,详细介绍了接口的用途和细节处理,方便查看。
三、总结
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-基于DoraCMS定制的博客系统
基于DoraCMS定制的视频分享站点
4、为什么上传图片失败?
DoraCMS默认在3个地方用到了上传:
用户上传头像、添加文档主图、内容详情中文件、图片或附件上传。
其中用户上传头像、添加文档主图默认使用七牛,所以如果您没有配置七牛云存储开发者相关信息,就会上传失败,需要在/models/db/setting.js下进行配置:
(七牛免费10G空间,注册账号就可以获取到相关信息了)。
当然,有的童鞋不想用七牛,想直接传到网站相关目录,也是可以的。
DoraCMS预留的有通过uploadify上传图片或文件,而且上传接口自带了图片缩略图截取功能。
您可以通过查看 /public/javascripts/webapp.js下的 initUploadLogoBtn方法:
//初始化用户上传头像按钮
functioninitUploadLogoBtn($scope){
$("#uploadify").uploadify({
//指定swf文件
'swf':
'/plugins/uploadify/uploadify.swf',
//后台处理的页面
'uploader':
'/system/upload?
type=images&key=userlogo',
//按钮显示的文字
'buttonText':
'选择图片',
//显示的高度和宽度,默认height30;width120
'height':
40,
'width':
138,
//上传文件的类型默认为所有文件'AllFiles';'*.*'
//在浏览窗口底部的文件类型下拉菜单中显示的文本
'fileTypeDesc':
'ImageFiles',
//允许上传的文件后缀
'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:
事件对象(theeventobject)
//ID:
该文件在文件队列中的唯一表示
//fileObj:
选中文件的对象,他包含的属性列表
//response:
服务器端返回的Response文本,我这里返回的是处理过的文件名称
//data:
文件队列详细信息和文件上传的一般数据
alert("文件:
"+fileObj.name+"上传成功!
");
},
//上传错误
'onUploadError':
function(file,errorCode,errorMsg,errorString){
alert('Thefile'+file.name+'couldnotbeuploaded:
'+errorString);
},
'onError':
function(event,queueID,fileObj){//当单个文件上传出错时触发
alert("文件:
"+fileObj.name+"上传失败!
");
}
});
}
通过上面的初始化按钮方法,您可以找到后台上传接口和处理方式。
这两种上传方式您可以自己选择。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DoraCMS 开发 指南