二次开发


1.二次开发概述

sitesCMS的二次开发可以大致的分为两种情况:

  • 基于sitesCMS现有功能,开发一个单独站点,可以是公司网站、个人博客等;
  • 深度改造siteCMS以开发出更加符合自己需求的系统,可以是各种系统;

深度改造这个情况复杂多变,不同的场景有不同的需求,需要对源码有足够的了解了才可以进行,这里我们只对第一种情况的二次开发进行介绍,也就是基于sitesCMS现有功能开发一个单独站点。

2.二次开发新站点

sitesCMS是面向二次开发设计的多站点管理系统,对二次开发新的站点有很友好的支持,不需要写一句java代码就可以完成一个新站点开发,大致流程如下:

1. 新增站点 :使用管理员账号登录sitesCMS后台,在【站点管理】-【新增站点】功能中新增一个目标站点,填写站点名称、站点标识、访问日志等信息后进行保存即完成了一个站点的新增(需要初始化站点数据需要耐心等待)。需要注意的是“站点标识”要有意义且记住,后续还要使用这个信息;

2. 添加站点目录 :在webapp/cds目录下添加一个站点目录,这个目录名必须是上一步的“站点标识”完全一致,不然该站点无法访问;

3. 添加站点页面 :在站点根目录下添加该站点的各种页面和静态资源即可,我们假定在根目录下已经添加了一个index.html页面,这个就是我们站点的首页;

4. 切换主站点 :回到sitesCMS管理后台,在【站点管理】-【站点列表】界面找到刚才新增的站点,这里有两个功能,其中有一个是【设为主站点】,通过这个功能将新增的站点设置为当前的主站点。设置后sitesCMS会自动进行站点数据的同步刷新,会自动退出系统,这个是正常的。此时刷新系统首页,比如你的端口是80,那么浏览器访问地址应该是 http://localhost/ 即可看到上一步添加的首页了;

5. 完善站点 :上面我们只是添加了一个简单的首页,一个完整的网站还是有栏目、文章等多个页面的,还需要逐步的去完善。栏目、文章等数据可以直接使用现有功能在后台维护,栏目页面、文章页面等则需要在index.html同级目录添加,页面名称需要参考CdsController中的方法返回页面来指定。页面跳转和数据获取已经提供了多个内置方法,都在CdsController中,方法都比较简单,浏览下就知道具体用途了。对于有些在页面跳转方法中不能提供的数据,sitesCMS还内置了多个自定义指令,可以更加灵活的获取数据,自定义指令请移步至自定义指令

注意 :

  1. 内置的页面跳转方法几乎能满足绝大多数场景,并在方法中尽可能多的携带了可能用的到的参数,所以有需求的时候先研究已有的方法和数据是否能满足,不要盲目的新增方法;
  2. 同上,内置的自定义指令也是这个道理,灵活地应用自定义指令可以满足绝大多数的数据获取场景,实在不能满足的时候再参考内置自定义指令新增即可;
  3. sitesCMS已经内置了多个参考站点,都在/webapp/cds/目录下,新增站点前可以先浏览下已有的例子,对跳转方法应用、自定义指令都会有很大的帮助;