快速入门 创建时间:Sep 5, 2021 10:05:36 AM

快速入门快速入门快速入门

产品介绍更新时间：2021-07-11

【ChzzCMS软件V2.0】本系统主要是对内容发布，模板创建进行后台管理，在线发布内容资讯，对内容以及分类管理维护，以及模板创建维护，对网站内容以模板的形式进行动态生成静态页展示的形式进行网站制作。

产品特色

• 安全可靠： 采用 Spring Security 权限框架，支持按钮级别权限控制,同时支持前后端分离的管理操作,可实现内网部署安全可靠；
• 多站点支持： 支持在线维护，多个站点,支持多人协同办公，方便快捷随时切换站点；
• 在线开发： 在线模板管理，可以在线开发网站实现效率翻倍。
• 支持微信公众号 和头条 文章一键同步到本站

框架搭建

1.框架介绍
ChzzCMS 架构介绍： ChzzCMS 采用 SpringBoot + Mybatis Plus + Redis+ Spring Security + OAuth2 + Freemark 搭建的一套cms 系统，数据库采用 mysql 数据库，文件服务器采用 本地服务，可扩展更多文件存储服务 全文检索采用 Solr 。 前端架构采用ant design vue 前后端分离的系统架构。 门户系统采用的 静态模板生成技术，直接生成的静态 html 模板，js + jQuery 作相应的辅助。 部署服务 采用 nginx 门户系统和 后台 管理系统 采用正向代理正常部署，服务端采用反向代理暴露接口。ChzzCMS 的服务端在接口限制方面都可以灵活配置分配权限，保证系统的最大安全。无特殊要求亦可以内网部署服务端

2.项目搭建

搭建 ChzzCMS 2.0 教程说明

step1: 访问 https://gitee.com/slfj/ChzzCMS 该网站 进行 项目 clone 服务，git clone 后 导入 开发工具，标准的 springboot 工程，导入后运行 ChzzCMSApplication 类

main 方法 启动即可。

基础环境搭建：本地安装 jdk8(开发环境为8 更高版本自行测试) + mysql（5.7+）+ redis（5.3+）基础环境搭建完成后就可以实现项目运行了，项目的运行不依赖于 solr。

可运行后期配置

注：新来的小伙伴们如果没有接触过前后端分离的项目请按照教程来，别上来启动 springboot 项目 成功后直接访问 boot 的项目，还在群里问为什么没有权限，显示不出来页面等。

step2: 访问 https://gitee.com/slfj/ChzzCMS-VUE 该网站 进行 项目 clone 服务，git clone 后 切记一定要 git clone 下载 不要 直接下载。clone 后 在当前目录的根目录 执行

yarn install 或者 nmp install 推荐 yarn install,执行安装完成后需要修改项目的接口地地址，也就是第一步的springboot 运行的地址和端口号

找到 项目根目录 的 .env.development 这个文件修改 VUE_APP_API_BASE_URL 这个属性为你自己的服务地址。然后执行 yarn run serve 或者 npm run server 进行项目启动。

项目启动后 就可以正常访问管理端了。

PS: 点击入门视频教程      2.0 solr 文件下载

3.栏目策略配置

  说明：栏目静态化时需要指定的条件出发，比如在发布文章的时候生成栏目列表页，再删除文章的时候可能会生成一下首页，这部分触发事件是需要自己配置的，虽然配置起来有点啰嗦，但是大大提高了灵活性，而且是配置一次就完成的工作。具体配置 需要在栏目中的策略配置 根据需要自行配置即可。

4.证书放置位置

   说明：在项目启动的时候需要将项目的根目录的 license.dat 文件手动复制到 yml 配置的 license: E:\tk\license.dat 自行复制到自己配置的目录即可。复制后重启项目即可生成目录。

模板自带变量

1.模板自带变量介绍
所谓模板自带变量就是指：在模板生成的时候 可以无需任何操作 就可以通过 ${xxx} 获取到当前要操作的 文章 或者 栏目的关键信息

比如我在创建一篇文章的时候如果配置了栏目策略中 创建文章时生成静态内容详情页的时候，那么在当前内容对应的模型 模板文件 上面可以直接

获取内容的标题、作者、内容等等相关属性，如果是生成静态栏目列表页的时候那么则会在栏目首页列表模板 获取当前所操作的数据栏目关键信息

其中模板一般有2个较为重要的地方，其一就是 栏目模板 所谓栏目模板就是指当前栏目 在执行 静态化（就是栏目那个静态化按钮的）   以及 触发策略执行器中的 生成栏目模板首页、生成栏目模板分页列表  执行器的时候时候会执行生成栏目配置栏目的那个模板 如下图：其中该模板 中可以获取自带变量为当前栏目的相关数据 如 栏目id 栏目编码、栏目名称等等

比如本站的 网站部署 栏目 打开就是对应的栏目列表 那么在管理系统当前栏目对应的模板 里面在执行 标黄色的 几个触发事件的时候 就可以直接获取自带变量 ，主要为当前栏目的关键信息

其二就是内容详情页模板，该模板将决定你的文章内容详情以什么样的样式、风格去展示你的文章 比如本站的 内容详情页  该内容详情页 在执行 生成内容详情  策略执行器的时候 

会以当前 栏目所选择的 模型 模板（下图）为 模子去生成当前创建或者修改的记录动态替换内容。那么在替换的时候 同样会携带 自带变量去渲染该模板，

即可以直接在 当前内容模板 中通过 ${xx} 来获取当前要操作的该条文章记录 不如 文章 id 文章标题 、文章作者、内容等等。你可以理解为 传统的 jsp 在跳转页面的时候，

在跳转页面之前 一般会 request.setAttrbute(key,value) 或者 model 设置 key value 等 将当前记录放进去，然后在 jsp页面上直接获取，道理差不多。

那么在页面上获取自带变量有啥用呢？一是可以直接展示当前 自带变量，而是可以结合指令来 获取 更多的信息 比如 我们要在内容详情页获取 栏目的扩展属性怎么办？

如下：我们可以通过<@category id=categoryId></@category> 这样来在当前文章详情页获取当前文章的所属栏目信息。其中 categoryId  是自带模板变量 且为动态的，

你可以等向理解为传统 jsp 在跳转页之前 在 request.setAttrbute("categoryId","1000000") 作用域中设置了 当前 categoryId 为100000 了那么 在调用  <@category> 的时候

会自动获取到当前值。freemarker 一样的道理在生成内容详情页的时候 框架自动加载了当前操作内容数据的所有字段 然后都放在了当前作用域中了，这样在配置标签的时候

可以作为参数值直接传入。

产品参数说明

chzz:
   gateway: http://127.0.0.1:8115 
   portal: http://www.chzzcms.com
   license: E:\tk\license.dat
   path:
     rootPath: E:\tk
     site:
       pathName: site
     source:
       pathName: source
       templates: templates
       fileServer: local
       fileServerIp: ${chzz.portal}

配置前缀
网关地址,即当前springboot 的地址
资源目录地址：用于nginx 映射上传资源地址
证书存放路径
站点配置前缀
资源根目录
     site:
站点资源目录
     source:
上传资源以及模板目录
模板目录
上传方式：保留字段
文件服务器路径基础地址

非商用永久证书申请条件

1）个人非商用，用于研究性学习，或者出于个人兴趣爱好搭建自己个人网站或者博客等
2）严禁进行二次私有化包装售卖，请自觉遵守开源规定
3）用于公益网站的搭建建设以及出于人道主义项目建设等。

商用说明

 凡个人、企业、事业单位使用本系统用于商业行为请联系 作者 自觉购买授权，为了开源项目能更好的发展感谢您的支持。

本站模板免费获取

关注公众号 "码农程序猿" 账号：codecopyer 

或者直接扫码关注 后 回复： ChzzCMS模板    后即可下载。下载后可通过模板管理进行导入

操作流程

注：操作手册可以加入qq 群：313095864 查看下载。本文档再次只做简单流程说明 

• 新建一个站点，在站点管理菜单，创建一个站点，并将该站点设置为默认站点否则，没有当前要操作的站点 则 没有数据展示，设置默认站点 请点击右上方的小球 按钮设置，
  没有站点的话新建后刷新一下页面 

• 创建完一个站点后 开始创建模板，在模板管理创建一个模板，模板创建完成后就可以开发模板了，模板的根目录 必须包含一个 index.html 作为 入口需要自行创建。
  模板设置为安装即可成功生成 index.html

• 模板创建完成后自己可以点击模板 后面的开发按钮 创建一个 index.html 后就可以在线生成了，前提是 需要设置一下当前模板为默认模板，在站点管理里面选择模板，把刚才创建的
  模板设置为安装即可生成index.html 到 当前站点对应的资源目录下了。（资源目录的结构为yml 上诉配置 基础路径+当前站点的域名或者 ip 文件夹，自行了解查看就明白了）

• 上诉步骤操作完成即可进一步进行模板开发了，有问题加群进行咨询或者自己查阅文档进行查看
   
• 模板开发教程请看下面教程

  PS：总体流程为 先创建一个站点--> 创建模板--> 开发模板-->尝试在模板根目录创建一个index.html 文件--> 文件创建完成后 模板创建完成

     模板创建完成后并不能马上使用，因为此时你当前的默认站点没有任何可用的模板此时你需要把你现在创建的模板进行应用到当前站点，

     操作如下--> 站点管理 菜单 然后找到你当前创建的模板 进行安装就可以了。安装完成后 你就可以执行以下 生成首页 就是底部那个小圆球 操作，

     这个时候 如果运行成功右下角底部会提示您当前的静态页的生成进度和位置。然后您根据 nginx 配置一下 root 根目录 就可以进行 访问了。

     需要注意的一点就是：多站点的话 nginx 的 root 需要    动态配置一下 

    看如上配置：  $host; 该变量代表您当前访问的域名 如果您访问 http://www.chzzcms.com/ 那么对应的

    文件路径为     E:\\tk\\site\\www.chzzcms.com\\index.html 这样就完成了多站点的支持

    其中：/chzzcmsresource/ ：该路径的配置是用于本地 文件上传文件的路径映射 ，关于文件路径映射 如访问量不大 可使用 框架自带的 映射 。

    如果大的话建议 单独这样配置；具体表现为

    yml 的 fileServerIp 配置项 取值为 chzz.gateway和 chzz.resourceServe   前者为 springboot 框架作为资源和程序服务器，

     后者为 nginx 作为资源服务器  springboot 为程序服务器，较少线程池的占用 节省内存

版权声明如下：

本接口及文档资料由ChzzCMS 提供。