MIPCMS模板开发手册
in 书签 with 0 comment

MIPCMS模板开发手册

in 书签 with 0 comment

MIPCMS是一套免费开源的CMS建站系统,移动网站使用MIP标准的网页,能快速让你的网站被百度收录;MIPCMS所有页面都是经过SEO优化后的,站长可以在短时间内搭建一整套带有PC版和移动版的百度MIP网站,无需再次进行SEO优化。

www.mipcms.com.jpeg

前台模板结构

前台模板:/template/

后台模板:/app/admin/view/admin/

/template/default/ 该套模板为mipcms默认模板,default为模板名称

../main/main.html 模板主文件

../main/header.html 全局头部

../main/footer.html 全局底部

../index/index.html 首页模板

../article/article.html 文章的列表或分类页面模板

../article/articleDetail.html 文章的详情页面模板

../product/product.html 产品的列表或分类页面模板

../product/productDetail.html 产品的详情页面模板

../tag/tagDetail.html 标签的详情页面模板

../page/page.html 单页面模板

../view/demo.html 自定义单页面模板

../block/ 该目录为模块代码

../block/article-list.html 文章列表模块

../block/mip-crumb.html 面包屑导航

../block/mip-friendLink.html 友情链接

../block/tags-hot.html 热门标签

../block/tags-new.html 最新标签

主页面模板结构

<!DOCTYPE html>
<html mip>
<head>
    <meta charset="utf-8">

    //部分代码省略...

    {block name='so'}
      //360结构化数据 主要用于详情页面
    {/block}
    
    <style mip-custom>
      {include file='main/css/mipcms.css'} //引入网站css样式
      {block name="style"}{/block} //支持基本模板独立css样式
    </style>
</head>
<body>

    {include file='main/header'} //引入头部文件 如 导航

    <main class="mipcms-main">
      {block name="main"}
        //基本页面继承此处
      {/block}
    </main>

    {include file='main/footer'} //引入网站底部文件 如 版权 统计 友情链接等

    {block name="script"}
      <script src="https://c.mipcdn.com/static/v1/mip.js"></script>
      //js代码引入
    {/block}

</body>
</html>

基本模板页面结构

基本模板页面结构

{extend name="main/main"/} //解释:该行代码为模板主文件的继承代码,即继承了/main/main.html

{block name="main"}
//解释:所有该模板的代码需写在该标签对中,写在该标签对之外是不显示的

{/block}

独立css样式的模板页面结构

{extend name="main/main"/}

{block name="style"}{__block__}
//解释:该模板页面中用到的css样式可以写在此处
//例如: body {background-color: #fff;}
{/block}

{block name="main"}
//主体模板代码写此处

{/block}

重置自定义本模板页面的标题、关键词、描述写法

重置自定义后,mipcms默认的标题、关键词、描述将被此写法覆盖。

{extend name="main/main"/}

{block name="mipTitle"}MIPCMS示例页面标题{$mipInfo['titleSeparator']}{$mipInfo['siteName']}{/block}

{block name="mipKeywords"}MIPCMS关键词{/block}

{block name="mipDescription"}MIPCMS描述{/block}

{block name="main"}
//主体模板代码写此处

{/block}

全局调用标签

全局调用标签,顾名思义就是这些标签支持在网站的任何页面中调用,那么下面就给大家列举常用的mipcms全局标签的调用代码

{$mipInfo['siteName']} //网站名称

{$mipInfo['keywords']} //网站关键词

{$mipInfo['description']} //网站描述信息

{$mipInfo['template']} //网站当前模板名称

{$mipInfo['domain']} //网站当前使用的域名 自适应站点

{$mipInfo['statistical']} //网站统计代码

{$mipInfo['icp']} //网站备案号

{$mipInfo['systemStatus']} //系统是否开启 1为开启 0为关闭

{$mipInfo['systemType']} //系统类型

{$mipInfo['idStatus']} //uuid是否开启,1位开启 0为关闭

{$mipInfo['articleModelName']} //文章名称 默认:文章

{$mipInfo['articleModelUrl']} //文章别名 默认:article

{$mipInfo['indexTitle']} //网站首页副标题

{$mipInfo['codeCompression']} //页面代码是否压缩

{$mipInfo['localCurrentVersion']} //当前版本

{$mipInfo['titleSeparator']} //网站标题的分隔符 默认:_

{$mipInfo['httpType']} //网站链接协议 默认:http://

{$mipInfo['mipApiAddress']} //mip提交百度API的地址

{$mipInfo['tagModelName']} //标签名称 默认:标签

{$mipInfo['tagModelUrl']} //标签别名 默认:tag

{$mipInfo['loginCaptcha']} //网站登录是否开启验证码 1为开启 0为关闭

{$mipInfo['biaduZn']} //百度站内搜索的key

{$mipInfo['aritcleLevelRemove']} //文章层级去除 1为去除article层级 0为默认

{$mipInfo['superSites']} //超级站 多域名用 1为开启 0为关闭

{$mipInfo['rewrite']} //伪静态 1为开启 0为关闭

{$mipInfo['topDomain']} //顶级站 多域名泛站用 1为开启 0为关闭

{$mipInfo['superTpl']} //超级模板 手机模式下显示手机站模板 1为开启 0为关闭

{$mipInfo['diyUrlStatus']} //自定义页面url,1为开启,0为关闭

{$mipInfo['mipPostStatus']} //mip自动推送状态 默认:为空

{$mipInfo['articlePagesNum']} //文章分页每页数量 默认:1000字符

{$mipInfo['urlPageBreak']} //url分页分格符 默认:_

{$mipInfo['urlCategory']} //文章是否放在分类下 默认:空

{$mipInfo['baiduSearchPcUrl']} //百度站内搜索 提交的结构化数据地址

{$mipInfo['baiduTimePcStatus']} //百度链接推送自动推送状态 默认关闭

{$mipInfo['baiduTimePcUrl']} //百度链接推送API地址

{$mipInfo['baiduYuanChuangStatus']} //百度原创推送自动状态 默认关闭

{$mipInfo['baiduYuanChuangUrl']} //百度原创推送API地址

{$mipInfo['guanfanghaoStatus']} //百度熊掌号开启状态 1为开启 0为关闭 默认关闭

{$mipInfo['guanfanghaoUrl']} //百度熊掌号旧数据推送API地址

{$mipInfo['guanfanghaoStatusPost']} //百度熊掌号自动推送状态 1为开启 0为关闭 默认关闭

{$mipInfo['guanfanghaoCambrian']} //百度熊掌号关注代码

{$mipInfo['guanfanghaoRealtimeUrl']} //百度熊掌号新数据推送API接口

{$mipInfo['topStatus']} //顶级站高级模式状态 1为开启 0为关闭 默认关闭

{$mipInfo['productModelUrl']} //产品别名 默认:product

{$mipInfo['productModelName']} //产品名称 默认:产品

文章列表调用标签

文章列表调用标签也支持全局调用,那么下面就将mipcms支持的文章列表调用标签列举一下,在列举之前先熟悉一下文章列表模块初始化的变量值,这些变量值是文章列表模块自带的变量值。

{$categoryInfo['cid']} //当前分类的ID 为空则当前无分类

{$categoryInfo['page']} //当前分页数 1为无分页

{$categoryInfo['category']} //当前分类url别名

{$categoryInfo['sub']} //当前二级分类url别名

{$categoryInfo['id']} //当前分类ID

{$categoryInfo['pid']} //当前分类父ID 一级分类为0 二级分类PID是一级分类的ID

{$categoryInfo['name']} //当前分类名称

{$categoryInfo['keywords']} //当前分类关键词

{$categoryInfo['description']} //当前分类描述

{$categoryUrlName} 全局分类别名 用于显示导航active

文章列表调用标签(闭合)

{mipcms:article key='键名' value='值名' cid='分类ID' limit='调用数量'  page='分页数' where='查询条件' keywords='关键词' order='排序方式' orderBy='排序条件' category='分类url别名参数' sub='二级分类url别名参数' uuids='指定查询的uuid支持用逗号分开多个调用' notUuids='排除的uuid支持用逗号分开多个uuid' tagIds='标签id,支持多个' tagNames='标签名称,支持多个'}

 //循环代码处
<li>
  <a href="{$v['url']}">{$v['title']}</a>
</li>
{/mipcms:article}

文章列表调用标签(非闭合)

闭合标签通常用于列表的循环,或者是有一定相似度列表循环用,但是在开发模板的时候有些情况下就是不规则列表的调用,此时我们需要非闭合标签单独的调用。

{mipcms:articleinfo key='键名' value='test' cid='分类ID' limit='调用数量'  page='分页数' where='查询条件' keywords='关键词' order='排序方式' orderBy='排序条件' category='分类url别名参数' sub='二级分类url别名参数' uuids='指定查询的uuid支持用逗号分开多个调用' notUuids='排除的uuid支持用逗号分开多个uuid' tagIds='标签id,支持多个' tagNames='标签名称,支持多个' /}
//数组由0开始,为第一个
<a href="{$test[0]['url']}">{$test[0]['title']}</a>

下面就列举常用的调用代码

最新文章

{mipcms:article value="v"}
  <li>
    <a href="{$v.url}" data-type="mip" data-title="{$v.title}" title="{$v['title']}">{$v.title}</a>
  </li>
{/mipcms:article}

value的值为v,则在循环列表中使用{$v['title']}{$v.title}调用文章的字段。

注:默认调用10条最新文章

热门文章

{mipcms:article value="v" cid='$categoryInfo["cid"]' orderBy='views' limit='6'}
  <li>
    <a href="{$v.url}" data-type="mip" data-title="{$v.title}" title="{$v['title']}">{$v.title}</a>
  </li>
{/mipcms:article}

value的值为v,则在循环列表中使用{$v['title']}或{$v.title}调用文章的字段

cid的值$categoryInfo["cid"] 为文章模板页初始化系统变量标签,注意在{}花括号中写变量标签无需再加{};

orderBy的值为views,排序条件为文章的浏览数

limit的值为6,指调用的数据条数为6条

注:省略cid 为调用全部

文章详情调用标签

文章详情支持调用文章字段,包括自定义字段。当然文章详情页面系统也自带了常用调用标签

{$itemInfo['firstImg']} //文章第一张图片url

{$itemInfo["tagsListString"]} //标签字符串列表 如:seo,sem

{$itemInfo['img_url']} //自定义图片url地址

{$itemInfo['title']} //标题

{$itemInfo['views']} //浏览数

{$itemInfo['publish_time']|date='Y-m-d',###} //发布时间

{$itemInfo['content']} //内容

下面是列举常用文章列表调用代码

猜你喜欢

{mipcms:article value="v" keywords='$itemInfo["tagsListString"]' notUuids="$itemInfo['uuid']" limit='5'}  
  <li>
    <a href="{$v.url}" data-type="mip" data-title="{$v.title}" title="{$v['title']}">{$v.title}</a>
  </li>
{/mipcms:article}

value的值为v

keywords值为标签列表,表示搜索带有标签列表的文章标题列表

notUuids的值为$itemInfo['uuid']当前文章uuid,表示去除含有当前文章的查询数据

limit的值为5 表示查询5条数据

相关文章

{mipcms:article value="v" tagNames='$itemInfo["tagsListString"]' notUuids='$itemInfo["uuid"]' limit='5'} 
  <li>
    <a href="{$v.url}" data-type="mip" data-title="{$v.title}" title="{$v['title']}">{$v.title}</a>
  </li>
{/mipcms:article}

value的值为v

tagNames值为标签列表,表示查询标签下的文章数据

notUuids的值为$itemInfo['uuid']当前文章uuid,表示去除含有当前文章的查询数据

limit的值为5 表示查询5条数据

查询上一篇文章

{mipcms:articleinfo value="itemUpPage" where='"publish_time < " . $itemInfo["publish_time"]' limit='1' /}  
<a href="{$itemUpPage[0]['url']}" data-type="mip" data-title="{$itemUpPage[0]['title']}" title="{$itemUpPage[0]['title']}">{$itemUpPage[0]['title']} </a>

value的值为 itemUpPage

where的值为 "publish_time < " . $itemInfo["publish_time"] 发布时间小于当前文章的表达式

limit的值为1 表示查询1条数据

注:该标签为非闭合标签,因为查询数据仅为一条,可不需要用循环标签

自定义页面

自定义页面主要是为了解决单页面需要在网站后台添加才能显示的不足。自定义页面也是为了给站长自定义页面内容而开发的功能,自定义页面支持站长自己编写网站代码。

自定义的模板存放于 /template/default/view/demo.html

自定义访问的域名为 域名/demo/

如果需要多个或者是修改demo名称,直接复制demo.html和修改文件名称即可。

自定义的页面的好处是如果站长在开发一款模板售卖的时候,可以直接用此自定义页面制作,而无需让站长在网站后台新建单页面才可使用的烦恼。

当然自定义页面支持标题、关键词、描述,也支持独立css和独立js引入。更是支持各种全局标签的调用,站长可以用自定义页面做专题页面,如:

{mipcms:article value="v" keywords='seo' }
//循环代码
{/mipcms:article}
查询带有seo关键词的标题数据列表,因为没有写limit,默认10篇。然后站长可以将此页面链接于网站侧边栏加上链接即可做文章的seo专题用。当然关键词支持多个同时调用,需要英文状态下逗号分隔即可,也区别于标签页面单个标签调用的文章数据的重复问题。当然这这是举例,更多的用法等着站长们去自己研究

本文转载自:http://www.mipwiki.cn/manual/mipcmstemplatedev/jianjie.html , 查看完整版开发手册请点击这里

Responses