DoraCMS 基于NodeJS 的内容管理系统操作指南

1. 目录
   一、概述   
   二、后台模块   
   1、后台登录   
   2、后台模块简介   
   3、模块详情   
   1、用户组设置   
   2、系统用户管理   
   3、邮件模板   
   4、广告管理   
   5、文件管理器   
   6、数据管理   
   7、文档管理——模板配置   
   8、文档管理——添加文档类别   
   9、文档管理——文档标签管理   
   10、文档管理——文档添加   
   11、文档管理——文档属性管理。   
   12、文档管理——留言管理   
   13、注册会员管理   
   
   

一、概述

DoraCMS是基于Nodejs+express+mongodb编写的一套内容管理系统。前前后后编写和修改大体用了3个月左右的时间（本人也有工作，也是有空就写写）。考虑到准备开源，为更多nodejs初学者提供入门帮助，特编写该文档，对DoraCMS系统做细节说明，并不保证程序没有bug或其它问题，目前我也是边发现边修改存在的问题，希望广大的开发者发现问题能及时反馈给我，我会不断完善，我们一起进步。

二、后台模块

1、后台登录

 

  后台登录比较简单，后台登录的信息需要从后台录入，这就出现一个问题，如果你是第一次安装doracms,数据库是空的，进不来后台设置，如何登录呢？需要通过mongo命令行插入初始的登录数据：

1、找到Mongodb安装目录(MongoDB\Server\3.0\bin) 执行 mongo.exe

2、输入 use doracms

3、插入用户组数据:

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
})

4、插入用户数据：

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
})

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

2、后台模块简介

 

后台模块按功能分为3大部分：系统管理、文档管理、会员管理。

1、系统管理——包含了系统用户管理、用户组设定、邮件模板、广告管理、文件管理器、数据管理。

2、文档管理——包含了文档管理、文档类别管理、文档标签管理、文档模板配置、文档属性管理、留言管理。

3、会员管理——包含注册会员列表。

3、模块详情

1、用户组设置

 

作用：设置管理员组别，同时设置管理权限

操作：组名称可自定义（如：超级管理员），选择需要设定的管理模块

备注：目前的权限设置只针对于大模块，只要对大模块有权限操作，模块中的增删改查都是有权限的。

2、系统用户管理

 

 

作用：管理员用户设置

操作：点击添加用户可以添加新的管理员，在设置用户组之后可以赋予新管理员的用户权限，没有权限的用户无法访问指定的模块。

备注：通过校验的表单才可以提交，其它所有模块都采用了类似的模式。

3、邮件模板

 

作用：邮件模板是为了定义需要发送邮件时调用的模板，通过定义模板然后加入指定的参数，在邮件发送时，给指定参数传入数据，就可以发送带数据的模板给指定用户了。目前在doracms上并没有用到邮件发送功能，但是该功能已测试通过，可以使用。下面通过接口简单介绍一下：

邮件模板的前提是系统支持邮件发送，这一块我用了nodemailer 组件，实现代码：

sendEmail : function(key,user){

        var emailTitle = "Hello";
        var emailSubject = "Hello";
        var emailContent = "Hello";
        var emailLink = "";
        EmailTemp.findOne({type:key},function(err,temp){
            if(temp){
//                设置邮件模板相关参数
                emailTitle = temp.title;
                emailSubject = temp.subject;
                emailContent = temp.comments;
//                根据用户名和邮箱生成加密链接
                var oldlink = user.userName + user.email;
                var newLink = DbOpt.encrypt(oldlink,"dora");
                emailLink = user._id+"/"+newLink;

                var ec1 = emailContent.replace("euserName",user.userName);
                var ec2 = ec1.replace("elink",emailLink);

//                发送邮件
                var transporter = nodemailer.createTransport({
                    service: '163',
                    auth: {
                        user: 'xxx@163.com',
                        pass: 'xxx'
                    }
                });

                var mailOptions = {
                    from: 'xxx@163.com', // sender address
                    to: user.email, // list of receivers
                    subject: emailSubject, // Subject line
                    text: emailTitle, // plaintext body
                    html: ec2 // html body
                };

                transporter.sendMail(mailOptions, function(error, info){
                    if(error){
                        console.log(error);
                    }else{
                        console.log('Message sent: ' + info.response);
                    }
                });
            }
            else
            {
                console.log("邮件模板查询失败，无法正常发送");
            }
        })
    }

可以参照代码查看，注释写的很详细，在需要发送邮件的地方调用sendEmail方法，传入合适的参数就可以了。传入的参数是指定邮件模板的ID，发送邮件时，会根据模板打包详情发送出去，可用户邮件激活和找回密码等功能。这些功能在最初的版本里都有，不过后来去掉了，因为开发的并不完善，有兴趣的童鞋可以接着处理这部分。

4、广告管理

作用：管理员可以添加图片、文字两种广告。针对前台显示单广告、图片轮播广告或者文字广告。

 

文字广告比较简单，直接添加文本和链接就可以了。图片广告规定添加一张图片不轮播，多张图片轮播的形式，单张图片属性设置如图：

 

您可以设置图片的基本属性和打开方式。

调用方式：<div id="exampleId"><script>initAds(key,"exampleId");</script></div> ，其中key 是广告ID，在创建完广告后可以在广告列表获取，exampleId 可以自定义。

5、文件管理器

做文件管理器是一个朋友提出的，最初的设想是管理上传文件，目前的功能比较简单。

 

 

用户可以对上传文件进行修改、删除等操作。目前只定义了对图片进行重命名和删除操作，对html等静态文件进行内容修改的操作，而且加入了列表和缩略图视图，对于图片缩略图是可以点击查看的。做这个模块也是为了巩固nodejs 文件操作的方式和方法。

6、数据管理

数据管理功能是后来加的，考虑到以后博客是数据会越来越多，于是数据备份是很有必要的。

 

这里利用了mongodb自带的数据备份脚本，通过Nodejs执行脚本的命令来执行数据库备份，数据按时间戳命名，备份完成后执行打包操作，形成完整的备份数据压缩文件。

7、文档管理——模板配置

文档管理是DoraCMS的核心模块，DoraCMS的基础就是文档管理，在这里可以先简单看下界面：
 

    为什么要先说模板配置呢，因为在做文档管理之前，需要给文档配置模板，这是内容管理的前提，这里引入了模板的概念，好处是文档风格更加灵活多变，可以根据自己的需要针对不同的板块配置不同的模板，而不是千篇一律的风格。但是目前的模板配置还不是做的很自动化，配置完模板还需要开发人员对模板里的内容进行处理，加需要的变量等。你可以这么做：

1、在/doracms/views/web/temp 路径下建立文件夹，如blog (这里规定，模板需要建立在temp目录下，改目录可以在/doracms/models/dbsettings.js)
 

2、在blog 文件夹下添加 contentList.ejs(列表页),和detail.ejs(详情页) 约定这两个文件名是不能改其它名称的，因为改了就无法确认哪个是列表页，哪个是详情页。模板中的内容你可以先加入自定义的html代码，等看到效果后再做进一步调整。
3、添加模板。

 

当在指定目录下新建blog文件夹之后，在添加新模板的 模板组合下拉菜单中会显示出来，例如你想添加一个博客模板，选中它，添加模板名称和备注后保存，这样一个模板就添加成功了。

 

8、文档管理——添加文档类别
在添加完模板之后，你需要添加文档类别，doraCMS的文档类别支持无限极分类。

 

你可以通过“增加顶级分类”的按钮添加一级分类，在非一级分类下添加子类。这里要注意的是，一级分类和其它分类有点小区别，就是设置模板，添加一级分类必须选择指定模板。

 

除了设置模板，对其它几项也非常重要，下面做简单介绍：

1、URL 这部分是在浏览器地址栏中显示的名称，有助于搜索引擎识别

 

2、排序，很好理解，控制类别的前端显示顺序。
3、关键字和描述会显示在前台当前分类下的keywords 和 content meta标签下，有利于seo优化和搜索引擎收录。


9、文档管理——文档标签管理
标签管理的作用是为文档添加合适的标记，属于某一关键字范畴，给文档添加标签有助于用户更好的检索自己需要的文档。
 

 

添加标签需要填写标签名称和别名、备注。别名必须为合适格式的英文，作为标签的唯一识别。

10、文档管理——文档添加
做了以上这些准备工作，接下来就可以添加文档了。


 

文档管理包含了文档的基本操作：增、删、改、查；已经文档推荐等。这里需要提出的是，您可以根据需要添加不同类型的文档：

 

什么意思呢？因为我们之前就针对不同的文档类型，可以定义不同的模板。而不同的模板，当然可以定义不同的文档，每种类型的文档添加的字段可能是不一样的，举个例子吧，下边是添加普通文档和Jquery插件文档的添加界面：

普通文档：
 

jquery 插件文档：

 

可以看到，我们定义了不同的添加文档的板式，因为用普通文档的板式去添加jquery插件，就会有些字段用不上，有些字段又不能满足要求。这种方式就很方便解决了该问题。您可以根据自己的需要去添加不同类型的文档。后台也预留了接口供大家拓展，至于如何添加文档内容就非常简单了，在此不做赘述

11、文档管理——文档属性管理。
 

    文档属性管理目前在演示站上没有用到，但确实一个很有用的模块，改模块只用了一个表。
文档属性有什么作用呢，有点类似标签的功能，但又不全是。因为单一的标签或者分类信息并不能完整的表达出文档的所有属性，所以就需要属性管理去拓展了。比如你想开发个影视分享站，内容体当然就是电影了，那么电影大类有了，电影的基本属性呢（影片类型，所属地区、发行时间），等怎么处理呢，当然不止这些属性，又或者针对产品，产品的材质、品牌、制造商。这些并不唯一可以作为筛选条件的属性，都可以放到文档属性管理中去统一管理，非常灵活。

 

添加属性的界面比较简单，大家尝试下就会了。


12、文档管理——留言管理

 

留言管理的功能比较简单，包含了留言信息查看和删除。

13、注册会员管理
注册会员主要是对会员信息的编辑、修改和删除功能。

DoraCMS操作文档下载 （右键另存为）

转载于:https://my.oschina.net/doracms/blog/493642