【最全最详细】publiccms使用教程

痛定思痛。 2022-08-29 00:20 706阅读 0赞

![58cd9e0a444314b294313c1d71577366.png][]

大家好，我是雄雄，欢迎关注微信公众号：雄雄的小课堂

# 拉取项目（项目部署阶段） #

--------------------

1.首先需要从gitee中拉取项目，地址为：public cms项目地址 ，在idea中点击文件--》新建--》来自版本控制的项目，输入连接地址，拉取项目

2.打开主项目publiccms-parent，然后开始配置Tomcat8.0启动。

3.在浏览器中输入：http://localhost:8080/publiccms\_war/ 直接回车。

4.进入欢迎页面之后就别动了。

5.打开mysql，在数据库中新建一个数据库，名字为publiccms.

6.切换到浏览器中，点击下一步，然后按照操作继续往下。此时项目基本部署完成。

7.进入后台，开始进一步设置：http://localhost:8080/publiccms\_war/admin ，默认用户名和密码都是admin

# 配置项目 #

## 站点配置 ##

点击站点--》修改站点--》默认静态化配置--》保存

![f582d01b08b5d389d79d6946b734687b.png][]

## 上传网站的相关素材 ##

点击开发--》网站文件管理--》上传文件--》将本地的压缩包上传上去，然后点击压缩当前目录，

![21d8c607096e6c6f25cba301acf2e12e.png][]

## 模板创建以及修改 ##

点击文件管理中的模板文件管理，两种方式创建，分别为创建模板和上传模板（如果html文件已经写好了，可以直接上传模板文件）。

![5f535c731003fef389aeee582026a08a.png][]

上传完模板文件之后，可以==刷新缓存==，然后会发现css以及js、图片都没有进来，这个时候就需要对模板文件进行修改，模板文件中所有在引入js，css和图片的地方，都需要在前面添加\*\*$\{site.sitePath\}\*\*,或者可以直接点击网站文件选择所需要添加的css等文件即可，这样错不了。

![a3a513609d319facfaf7d7de764be3e8.png][]

## 修改logo为动态上传 ##

由于logo会被好多页面来使用，所以不用模板的方式更改，直接在站点里面设置。

点击开发，选择配置管理中的站点配置管理，进去找到\[site系统配置项\]，进去之后增加一行，点击保存。

![b41354e8937d2250f53b2923c693980f.png][] ![2f7c4b112bac35a70dd6a71503166f40.png][]

最后点击维护，系统维护里面的站点配置，进入site系统配置项，点击修改配置数据，进去里面就可以上传动态的上传logo了。

在模板中替换logo:

打开模板文件，找到logo的地方，点击上面的模板帮助，然后进去选择配置参数，选择图标。最后将src中的路径替换掉，需要稍微的改改：

<img src=" <@_sysConfigData code='site'>${site.sitePath+object.logo}</@_sysConfigData>" />

![86b039ecb20439f5a5dc17abf7c534a8.png][] ![fd9b0ff56555802e9ea8a265b28bd11d.png][]

## 分类扩展字段 ##

点击内容,点击分类类型，点击增加分类类型。

![7f41176db8008de4521720c4cb6b3369.png][]

该方法主要用于关于我们的页面等。

## 创建分类的页面 ##

点击开发 ，选择模板 文件管理， 然后选择\*\*创建模板  \*\*，填写完可接受参数外，一定要点击后面的==增加==按钮方可生效 。

![fd264d032d2b320cffb4f9ac154a1546.png][]

## 动态加载分类菜单 ##

打开开发中的模板文件管理，找到==index.html==,然后找到导航菜单的代码块，直接替换成：

或者也可以：点击模板帮助，选择常用指令、方法，选择分类。

## 制作一些公共的区块 ##

比如网站中的一些公共的部分，头部或者侧边栏，再或者是底部都是共用的，那么就可以把这一块儿的内容提取出来作为一个小模块，别的页面需要用的时候直接引入即可。

下面是操作步骤：

*  进入开发--》页面片段管理，点击创建页面片段，然后起个名字，比如==Head==
 *  数据条数填写0，因为头部和尾部不需要数据，点击保存
 *  将页面中头部公共部分复制到该页面片段中
 *  切换到`index.html`中，将公共部分删掉，直接用`页面片段`替换即可。
 *  代码如下：
    
        <head>
          <@_includePlace path="/040c12ca-a5b4-4267-af96-39a5bdb64a14.html"/> <#-- Head META -->
         </head>

## 将带文章的分类页面数据换成动态的 ##

1.在分类页面的上面添加代码：

<#assign attribute=getCategoryAttribute(id)/>

2.找到原来放内容的地方 ，写如下代码：

${(attribute.article?no_esc)!}

`no_esc`是为了避免编译器转义

`article`是分类扩展里面的带文章分类的字段名

## 配置分类为静态路径 ##

1.在模板文件中新建一个模板文件

![ec09de0ae67c9e45940f5e8fab143243.png][]

2.在内容--》分类管理--》增加一个分类，相关信息如下：

![606f32db25ee924afef9fcc142d26df9.png][]

注意`分类访问路径`下面选择的是静态路径 ，指定的就是上面`分类静态模板化`

![a7a92a7b0bf295c04907a0e1574d7b71.png][]

最后点击分类的时候就进入了静态的分类。

## 添加其他自定义分类 ##

在添加自定义模板分类之前，需要在模型文件中新建一个模型，比如叫`list_pic.html`

![d5ba097447031b3496aad41db75e91ca.png][]

点击==内容==，选择菜单分类管理，点击增加分类，注意分类访问的路径，一定要修改，修改成自己新建的==模板文件==。

## 添加子分类 ##

还是在分类管理中，点击增加分类，和创建父分类不一样的地方，就是在此需要选择父分类，因为我们创建的是子分类，需要注意的是，在创建的时候一定要添加==可接收参数id==这个选项，不然就是个静态页面。如下：

![53fb69511c727c21d4f598f34f5324f2.png][]

在模型文件中，如何获取改分类下的子分类？代码如下：

文件的开头：

<@_category id=id>
        <#assign category=object/>
    </@_category>

获取子分类：

<div class="hot_content">
       <@_categoryList parentId=category.id>
            <#list page.list as a>
         <div class="hot_content_box">
           <div class="hot_content_box_title">
             <img src="${site.sitePath}蓝色政府警务门户网站模板/img/hot_list_ico.png" />${a.name}
           </div>
         </div>
        </#list>
       </@_categoryList>
     </div>

![4afdf64d5d428c1778c83d36b4f63dfa.png][]

## 动态修改网页中的标题或者搜索引擎关键词 ##

在模型文件的最上面添加代码：

<#-- id:分类ID,code:分类编码 -->
    <@_category id=id >
    <#assign category=object/>
    <#-- 参数:分类ID -->
    <#assign attribute=getCategoryAttribute(id)/>
    
    </@_category>

在搜索引擎优化部分修改内容：

## 展示动态内容列表 ##

1.新建一个模型文件，为展示内容列表做准备

2.在循环显示动态内容的地方，写如下代码：

<ul>
           <#-- categoryId:分类ID,containChild:包含子分类内容,categoryIds:多个分类ID,modelId:模型ID,parentId:父内容ID,onlyUrl:外链["true":是,"false":否],hasImages:拥有图片列表["true":是,"false":否],hasFiles:拥有附件列表["true":是,"false":否],hasCover:拥有封面图["true":是,"false":否],orderField:排序字段["scores":分数,"comments":评论,"clicks":点击数,"publishDate":发布日期,"checkDate":审核日期,"updateDate":更新日期,默认:排序、发布日期字段倒序],orderType:排序类型["asc":正序,"desc":倒序],pageIndex:页码,pageSize:每页数据条数 -->
    <@_contentList categoryId=id  pageIndex=pageIndex pageSize=category.pageSize>
        <#list page.list as a>
            
             <li><img src="${site.sitePath}蓝色政府警务门户网站模板/img/list_con_ico.png"><a href="${a.url!}">${a.title}</a><span>${a.publishDate?string(yyyy-mm-dd)}</span></li>
            <a href="${a.url!}">${a.title}</a>
        </#list>
    </@_contentList>
            
           </ul>

注意需要修改几个参数：

*  `categoryId=id`,获取分类的编号
 *  `pageSize=category.pageSize`目的就是为了能在后台可控的去更改列表数量
 *  总记录数：`${page.totalCount}`
 *  总页数：`${page.totalPage}`
 *  首页：`<a href="?id=${id}">首页</a></li>`
 *  上一页：`<a href="?id=${id}&&pageIndex=${page.prePage}">《</a>`
 *  下一页：`<a href="?id=${id}&&pageIndex=${page.nextPage)"}》</a>`
 *  末页：`<a href="?id=${id}&&pageIndex=${page.totalPage}">末页</a>`

一定要级的在该页面中在添加一个参数`pageIndex`

## 给分类中添加文章 ##

进入内容中的分类管理，选中需要的添加文章的分类，点击==修改分类==，选择可发布内容模型，然后新增个内容模型，基础的就可以。

![e308d00390c3f21c7d9019af6e6c9a68.png][]

新增之后的界面：

![6e54b38433a5f75ee2b3f0bc421ef955.png][]

设置文章的访问路径：

![0779b02177d04c1baa7db6608c634886.png][]

注意，内容模型里面一定要把正文的复选框勾上：

![ce599bb0a38c4157ccf05d68693357ca.png][]

## 在publiccms内部查询接口 ##

在浏览器的地址栏中输入：http://localhost:8080/publiccms\_war/interface.html，可以返回接口的列表。

![2e8f83cff32bb5866a7bc25a74432883.png][]

比如像查询一下`contentList`的用法，点击`send`按钮，就会出来具体的信息。

![ae96307c86662de822e587ad0be20b90.png][]

## 动态获取文章信息 ##

1.进入内容菜单，点击内容管理，左边选择分类，然后右边就可以添加文章了。

![f7c73318d2b07a1b407c4effa141266f.png][]

## 将文章设置成动态 ##

1.在模板文件中，添加文章的模板。

2.在模板的最开头添加如下代码：

<#-- id:内容ID -->
    <@_content id=id>
       <#assign content=object/>
    <#-- 参数:内容Id -->
    <#assign attribute=getContentAttribute(id)/>
    
    </@_content>

3.正文的替换代码：

${(attribute.text?no_esc)!}

本文所有图片均来自publiccms，版权归publiccms方所有。官网地址：http://www.publiccms.com/

[58cd9e0a444314b294313c1d71577366.png]: /images/20220829/deb959072493423b83e197851245757e.png
[f582d01b08b5d389d79d6946b734687b.png]: /images/20220829/6ee6e944d7764533bba31f0c58ef8773.png
[21d8c607096e6c6f25cba301acf2e12e.png]: /images/20220829/8b912ac672ff4a0e97c32793088ce2b6.png
[5f535c731003fef389aeee582026a08a.png]: /images/20220829/9751cf71fc4f47b7a111a6874859977d.png
[a3a513609d319facfaf7d7de764be3e8.png]: /images/20220829/d267643e0bd94395b0779ed5eed97003.png
[b41354e8937d2250f53b2923c693980f.png]: https://img-blog.csdnimg.cn/img_convert/b41354e8937d2250f53b2923c693980f.png
[2f7c4b112bac35a70dd6a71503166f40.png]: /images/20220829/b53d082abffa4b4abe00210b3c31ca27.png
[86b039ecb20439f5a5dc17abf7c534a8.png]: https://img-blog.csdnimg.cn/img_convert/86b039ecb20439f5a5dc17abf7c534a8.png
[fd9b0ff56555802e9ea8a265b28bd11d.png]: /images/20220829/980c563a67954750bb334020bf9fa549.png
[7f41176db8008de4521720c4cb6b3369.png]: /images/20220829/1ff6bc00e0c2412d8b3e00aad077374f.png
[fd264d032d2b320cffb4f9ac154a1546.png]: /images/20220829/2e59854bf3534931a28815795cad77e4.png
[ec09de0ae67c9e45940f5e8fab143243.png]: /images/20220829/158590e3feaa4b79a2f7072ff6bf3301.png
[606f32db25ee924afef9fcc142d26df9.png]: /images/20220829/1f0df14213ca4f69a333023ebb40401b.png
[a7a92a7b0bf295c04907a0e1574d7b71.png]: /images/20220829/7b5deed60b9f4be0b7663ae0ab80e6d7.png
[d5ba097447031b3496aad41db75e91ca.png]: /images/20220829/9f55d10f89b0423a8da16777379bb3df.png
[53fb69511c727c21d4f598f34f5324f2.png]: /images/20220829/b37c7175c7824a82858c41ab97f72dc8.png
[4afdf64d5d428c1778c83d36b4f63dfa.png]: /images/20220829/b3af991a99a044f18c3d92f79d45df91.png
[e308d00390c3f21c7d9019af6e6c9a68.png]: /images/20220829/d61f652856444b1789e9542a9d3c5871.png
[6e54b38433a5f75ee2b3f0bc421ef955.png]: /images/20220829/4f75a026ff7a460ea3b30c56cdb87db7.png
[0779b02177d04c1baa7db6608c634886.png]: /images/20220829/357f8a432ee14cc79f4b07c2d9ee8f77.png
[ce599bb0a38c4157ccf05d68693357ca.png]: /images/20220829/fb55e6af30364996a9189527f9adb973.png
[2e8f83cff32bb5866a7bc25a74432883.png]: /images/20220829/02123cdb557a43ddba4cc23d2ad67b4d.png
[ae96307c86662de822e587ad0be20b90.png]: /images/20220829/37a270d8482044faa7e4018145a14638.png
[f7c73318d2b07a1b407c4effa141266f.png]: /images/20220829/67e4531d13864e44a40fbb97a0ce9080.png