FreeCMS商业版二次开发文档教材.doc

FreeCMS商业版二次开发文档 目 录 1、文档概述 1 1.1 文档的建立 1 1.2 文档的目标 1 2、FreeCMS二次开发概述 2 2.1 概述 2 2.2 系统目录框架 3 2.3 搭建开发环境 4 3、后台功能开发 10 3.1后台菜单项配置 10 3.2后台功能开发 10 4、前台模板开发 16 4.1基本概念 16 4.2模板制作流程 19 4.3开发模板标签 20 FreeCMS商业版二次开发文档 1、文档概述 1.1 文档的建立 本文档是专门针对FreeCMS商业版产品的二次开发而编写的指导性手册；它从后台功能配置、前台模板开发和二次开发所需的接口三个方面详细阐述了有关二次开发中所涉及的问题。 本文档是由FreeCMS产品开发组共同建立和维护的。在实际的应用中，FreeCMS开发组有义务不断更新和补充完善本文档。 1.2 文档的目标 本文档旨在解决以下问题： 如何应用和扩展FreeCMS体系； 如何对后台权限及后台功能菜单等进行配置； 如何利用模板机制开发集成所需功能； 如何使用FreeCMS系统提供的二次开发接口。 2、FreeCMS二次开发概述 2.1 概述 本文档假设您熟悉java开发及相关开发工具的使用。 FreeCMS主要使用的技术有:mybatis3、spring、spring mvc、freemaker、jquery、jsp。 FreeCMS是作为一个开放的平台设计的，遵从以下几个原则： 可自由配置 无论前台页面还是后台功能，系统都坚持可配置的原则，后台管理菜单项可以通过简单的配置自定义。第三章将详细介绍如何配置各功能项。 数据与显示分离 后台录入的数据与前台显示的样式分离已经成为网站建设者的共识，分离能够随意更改数据或者界面而不影响到另一方。FreeCMS通过强大模板机制将数据与显示结合在一起，同时能够将二次开发的功能加入模板中。第四章将详细介绍如何实现。 提供丰富的二次开发接口 通过二次开发接口，FreeCMS使用者能够方便的获取系统数据、集成相关功能。 2.2 系统目录框架 /admin 系统后台管理程序使用的静态资源，如js。 /admin/cms cms内容管理系统相关程序使用的静态资源，如js。 /cms 存放CMS前台使用的程序使用的静态资源，如js。 /member 存放前台中的会员功能程序使用的静态资源，如js。 /site 存放生成的站点静态页面文件 /templet 存放站点模板文件 /WEB-INF/views/admin 系统后台管理程序。 /WEB-INF/views/admin/cms cms内容管理系统相关程序。 /WEB-INF/views/cms 存放CMS前台使用的程序。 /WEB-INF/views/member 存放前台中的会员功能程序。 2.3 搭建开发环境 FreeTeam使用myeclipse 6.5 开发FreeCMS，推荐使用myclipse 6.5搭建开发环境。 打开myeclise,新建项目。 填写项目属性后,点击Finish按钮。 把下载的源码包解压，然后把所有文件复制到项目工程的src文件夹中。 把下载的安装包解压，然后把ROOT文件夹下的所有文件复制到项目工程的WebRoot文件夹中。 最后需要将项目的编码设置为UTF-8。 项目会提示有错误，主要在jsp和html文件的语法检测，只要src文件夹不提示有错误，项目就可以正常运行。 数据库的安装可以参考FreeCMS用户手册，此处不再赘述。 如果项目没有作为tomcat的根目录运行，请重新静态化演示站点的相关页面。 3、后台功能开发 3.1后台菜单项配置 系统中各项菜单都是可以配置的，如果需要添加新的功能菜单可以通过菜单管理功能进行配置。可参考用户手册的菜单管理部分，在此不再赘述。 3.2后台功能开发 本文档以一个单表维护作示例，向大家演示后台功能的开发流程。 1.添加管理菜单 添加菜单项目二次开发演示，设置地址为demo.do，代表/admin/demo_list.do。 点击“管理操作按钮”，添加需要的操作按钮。 2.创建数据库表 数据库表设计(freecms_demo) 字段 类型 说明 id varchar(50) 唯一标识，使用uuid textdemo varchar(50) 文本框 radiodemo varchar(50) 单选框 checkboxdemo varchar(50) 复选框 selectdemo varchar(50) 下拉列表 textareademo text 文本区域 由于FreeCMS同时支持mysql和mssql两种数据，所以要在两种数据库中都创建表。 Mysql Mssql 3.