SiteServer CMS 5.0 源码入门

• 开发者中心
• STL 语言
• 文 档
• 博 客
• 论 坛
• Github

二次开发

提示：文档中心正在完善中，我们将不断发布新文档，敬请期待...

 

新手入门

• SiteServer CMS 能做什么
• SiteServer CMS 术语大全
• SiteServer CMS 运行环境要求
• SiteServer CMS 安装前准备工作
• 安装 SiteServer CMS
• 系统升级说明
• SiteServer CMS 创建第一个网站
• 新建站点说明
• SiteServer CMS 备份与恢复
• SiteServer CMS SEO优化
• 后台实用技巧（一）
• 权限分配及审核设置
• 用户投稿说明

二次开发

• SiteServer CMS 5.0 源码入门
• SiteServer CMS 5.0 数据字典
• 源码解读之登录
• 源码修改实战之多线程生成页面

代码地址

http://docs.siteserver.cn/development/introduction-to-the-source-code.html

SiteServer CMS 5.0 源码入门

一、准备开发环境

想学习SiteServer CMS的或者想利用SiteServer CMS源码进行项目定制开发的程序员，需要提前准备好开发环境。具体要求如下：

1、.net framework 4.5.2或以上版本；

2、Visual Studio 2015或以上版本；

3、SQLServer 2008及以上版本或MySql 5.0 及以上版本；

4、NodeJS 最新版（可选）；

说明：如果需要修改用户中心的前台页面代码，或者需要重新制作安装包或升级包，才需要安装NodeJS。

二、获取代码

官方在GitHub上提供的源码，地址为：https://github.com/siteserver/cms

通过Git命令或者从上图页面直接下载最新源码。

产品使用文档或开发文档，请关注官方的开发者中心：http://developer.siteserver.cn/

三、源码结构初析

1、解压源码压缩包

注意：如果只修改SiteServer CMS后台功能或后台界面的话，只需要关注source文件夹里的代码即可。

2、Visual Studio 打开C#代码

注意：

• SiteServer.API 项目对应源代码解压出来的文件夹是source文件夹下的SiteServer.Web文件夹，并没有一个名叫SiteServer.API的文件夹。

• SiteServer.API 并不是提供给第三方系统与SiteServer数据交换用的，而是SiteServer系统内部使用的一些API接口，比如用户中心现在前后端完全分离，前端用ReactJS来实现，和后端的数据交换就是通过SiteServer.API来实现的。

• SiteServer.Plugins才刚刚开始，标准格式还没完全定下来，现在官方已经开发了第一个插件：阿里云存储插件，即站点文件可以支持云存储。具体源码在：https://github.com/siteserver/Plugin.Oss

四、安装SiteServer CMS

1、新建空数据库，设为启动项目

在Sql Server Management Studio中新建名为cms5.0的空数据库。在Visual Studio中把SiteServer.API设置为启动项目。

2、安装SiteServer CMS

如果是下载完源码第一次运行程序，则会需要进入安装SiteServer CMS的流程。具体是在Visual Studio中按F5开始调试，出现如下空白界面：

然后在浏览器地址中后面加入/siteserver，再回车，即地址变成：

http://localhost:58059/siteserver，则会出现如下安装界面：

按界面提示点下一步即可完成安装。具体安装说明可参考：http://docs.siteserver.cn/getting-started/index.html

安装完成之后点击进入后台管理，需要新建站点，如下图：

输入站点名称即可以创建一个空的新站点，并自动进入后台站点管理界面：

五、开始修改调试源代码

经过前面的操作，我们已经把SiteServer CMS运行起来了，并已经经入了调试状态。现在我们就以一个具体例子来演示一下如何进行代码修改并调试。

任务：把下图中的红框内容部分改成“欢迎使用SiteServer CMS 管理后台”

1、找到对应前台页面文件

运行程序，登录后台，进入到主界面。然后在红框位置按鼠标右键，点击“查看框架源代码”，弹出如下图：

通过上图可以看到，本页面路径是在siteserver文件夹里的pageRight.aspx文件，好对应源代码解压出来的位置就是：source\SiteServer.Web\SiteServer\pageRight.aspx。此时我们可以通过Visual Studio、Visual Studio Code或Atom编辑器打开此文件：

通过上图两个黄框，我们可以找到两个重要信息：

一个是控制pageRight.aspx文件业务逻辑的CS代码文件类：SiteServer.BackgroundPages.PageRight；

另一个是显示欢迎信息的asp.net服务器控件ID为LtlWelcome。

2、找到前台页面对应的后端c#代码文件

通过前一步找到控制pageRight.aspx文件业务逻辑的CS代码文件类是SiteServer.BackgroundPages.PageRight，这很清楚就是在SiteServer.BackgroundPages项目中，在Visual Studio中很容易就找到PageRight.cs文件：

在Visual Studio中打开PageRight.cs文件：

很清楚就看到了控制显示欢迎信息的服务器控件LtlWelcome。

3、修改并调试代码

在修改代码之前需要停止调试，然后把代码进行如下修改，并设置断点（F9），然后启动F5运行程序并进入调试状态，登录之后会是这样：

点击继续之后，出来的结果就是这样：

至此，我们就完成了开始提出的修改任务，并也能断点进行调试。