Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

老模版升级

Tip

也可以参考网络博文 记一次免费开源的Java cms系统MCms模板下载与使用且升级一套旧的皮肤

MStore 模板标签语法兼容性与修改指南

当使用 MStore 模板遇到标签生成失败或渲染报错时,请按以下步骤将旧版标签格式批量替换为标准格式:

情况一:将所有的 [] 标签格式替换为 ${}

  • 修改规则: [field.xxx/] 替换为 ${field.xxx}
  • 示例: [field.xxx/] 替换为 ${field.title}

情况二:将 {ms:field.*/}${field:*} 替换为 ${field.*}

  • 修改规则: {ms:field.xxx/}${field:xxx} 替换为 ${field.xxx}
  • 示例: {ms:field.content/} 替换为 ${field.content}

情况三:将图片 [field.litpic/] 修改为 {@ms:file field.litpic/}

  • 修改规则: [field.litpic/] 替换为 {@ms:file field.litpic/}
  • 示例: <img src="{ms:global.host/}[field.litpic/]"> 替换为 <img src="{ms:global.host/}{@ms:file field.litpic/}">

情况四:将时间${field.date?date?}或者[[field.date?/]]修改为$

  • 修改规则: ${field.date?date?...}[[field.date?.../]] 替换为 ${field.date?...}
  • 示例: ${field.date?date?string("yyyy-MM-dd")} 替换为 ${field.date?string("yyyy-MM-dd")}

情况五:将字符串截取函数修改为 {@ms:len} 标签

  • 修改规则: [field.xxx.substring(0, N)]${field.xxx[0..N]} 替换为 {@ms:len field.xxx N/}
  • 示例 1: [field.content.substring(0,255)] 替换为 {@ms:len field.content 255/}
  • 示例 2: ${field.content[0..140]} 替换为 {@ms:len field.content 140/}

情况六:将channel标签和arclist里的typeid替换为自己的栏目id

Tip

老模板没有逻辑标签,如果需要可自行添加。有些老模板使用include标签引入了搜索模板,但搜索模板并没有创建,静态化可能会报错,这时可以删除引入搜索模板的include标签或创建搜索模板

情况七:静态资源路径修改


static.ming-soft.net/base/ms.base.min.js
static.ming-soft.net/util/ms.util.min.js
static.ming-soft.net/people/ms.people.min.js
/static/plugins/ms/1.0.0/ms.util.js
/static/plugins/ms/1.0.0/ms.http.js
/static/plugins/ms/1.0.0/ms.js
修改成
static/plugins/ms/2.0/ms.umd.js

第三方static的资源可以替换对应的最新路径。例如:

/static/plugins/element-ui/2.12.0/index.js
修改成
static/plugins/element-ui/2.15.8/index.js

/static/plugins/element-ui/2.12.0/index.css
修改成
/static/plugins/element-ui/2.15.8/index.css

Tip

1.有些模板资源路径错误报404错误,重新正确引入正确路径,但是有些静态文件版本对不上(如element-ui),所以修改成现有的静态资源版本。

2.静态文件是有加载顺序,vue.js必须在ms.umd.js前面

情况八:search模板修改

在head和search中的form表单,action属性为 {ms:global.host/}mcms/search.do 表单中的查询关键字的name属性值,需按下面要求填写

  • 查询关键字设置 (模糊查询)
    • 文章标题 name必须为content_title 下面同理
    • 文章作者 content_author
    • 文章详情 content_details,更多字段参考下方文档
  • 根据栏目查询
    • 文章栏目 categoryIds