苹果CMS V10文章模型标签与模板调用开发教程
开发教程简介
苹果CMS V10文章模型标识为Art,MID固定为2,配套模板统一存放路径html/art,模板里可以通过{$maccms.mid}读取当前模型编号。这个模型适配资讯、教程类内容发布,内置一套独立的标签体系、页面模板和链接生成方法,和视频模型的数据对象、参数不能混用。
开发教程内容
文章列表标签maccms:art
文章内容的列表渲染依靠{maccms:art}标签,基础书写格式如下:
{maccms:art}{/maccms:art}标签支持丰富的控制参数,用来控制数据筛选、排序、数量、分页、缓存等行为:
| 参数 | 说明 |
|---|---|
order | 排列顺序,desc 倒序,asc 正序。 |
by | 排序依据,支持 id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd 等。 |
start | 从第几条数据开始获取。 |
num | 设置获取的数据条数。 |
ids | 指定文章 ID,多个 ID 使用逗号分隔,例如 1,2,3。 |
not | 排除指定 ID,多个 ID 使用逗号分隔。 |
type | 指定分类数据,all 表示所有分类,也可以指定分类 ID,例如 1,2,3。 |
class | 按照扩展分类筛选,支持多个值。 |
tag | 按照 TAG 标签筛选,支持多个值,例如 aaa,xxx。 |
level | 按照推荐值筛选,支持多个值。 |
rel | 指定关联数据,可以使用 ID 或相关关键词。 |
timeadd | 按照文章添加时间筛选,例如 -1 day、-1 week、-1 month、-1 hour。 |
timehits | 按照点击时间筛选,例如 -1 day、-1 week、-1 month、-1 hour。 |
time | 按照更新时间筛选,例如 -1 day、-1 week、-1 month、-1 hour。 |
hitsmonth | 按照月点击量筛选,例如 gt 1000、lt 1000、between 1000,2000。 |
hitsweek | 按照周点击量筛选,例如 gt 1000、lt 1000、between 1000,2000。 |
hitsday | 按照日点击量筛选,例如 gt 1000、lt 1000、between 1000,2000。 |
hits | 按照总点击量筛选,例如 gt 1000、lt 1000、between 1000,2000。 |
paging | 是否开启分页,使用 yes 开启。 |
pageurl | 指定分页地址。 |
cachetime | 自定义缓存时间,单位为秒。 |
列表循环内部统一通过$vo读取单篇文章字段,下面是读取最新10篇文章的基础示例:
{maccms:art type="all" by="time" num="10" order="desc"}
<img src="{$vo.art_pic|mac_url_img}" alt="{$vo.art_name}"/>
<h5>{$vo.art_name}</h5>
<!-- 更多文章字段可使用 $vo.xxx 方式调用 -->
{/maccms:art}在分类页面调用当前分类文章,将type参数设置为current即可,同时支持开启分页:
<!-- 列表 -->
{maccms:art num="24" paging="yes" type="current" order="desc" by="time"}
<li>
<a href="{:mac_url_art_detail($vo)}" title="{$vo.art_name}">
<img src="{:mac_url_img($vo.art_pic)}" alt="{$vo.art_name}"/>
<h2>{$vo.art_name}</h2>
<p>{$vo.art_actor}</p>
<i>{$vo.art_version}</i>
</a>
</li>
{/maccms:art}筛选页面开发
筛选页模板文件为html/art/show.html,页面AID值是22,当前分类数据存放在$obj。生成筛选入口链接的写法:
{:mac_url_type(['type_id'=>2],['by'=>'hits'],'show')}筛选依靠URL传参控制,支持分类ID、推荐值、首字母、TAG标签、扩展分类、排序规则等条件:
| 参数 | 示例值 | 是否必需 | 说明 |
|---|---|---|---|
id | 1 | 是 | 文章分类 ID。 |
level | 9 | 否 | 推荐值筛选。 |
letter | A | 否 | 首字母筛选。 |
state | 1 | 否 | 审核状态筛选。 |
tag | 八卦 | 否 | TAG 标签筛选。 |
class | 明星 | 否 | 扩展分类筛选。 |
order | desc | 否 | 排序方向,可使用倒序或正序。 |
by | time | 否 | 排序依据,支持 id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd、in 等。 |
组合筛选地址示例:
/index.php/artshow/1/by/time/class/明星/letter/A.html
筛选页面使用$param数组读取地址携带的筛选参数,筛选结果列表调用示例:
<!-- 筛选结果列表 -->
{maccms:art num="20" paging="yes" pageurl="art/show" type="current" order="desc" by="time"}
<li>
<a href="{:mac_url_art_detail($vo)}" title="{$vo.art_name}">
<img src="{:mac_url_img($vo.art_pic)}" alt="{$vo.art_name}"/>
<h2>{$vo.art_name}</h2>
<p>{$vo.art_actor}</p>
<i>{$vo.art_remarks}</i>
</a>
</li>
{/maccms:art}
<!-- 通用分页代码 -->搜索页面开发
搜索页面模板为html/art/search.html,AID值是23,搜索参数同样读取$param数组。搜索链接生成:
{:mac_url_search(['wd'=>'关键词'],'art')}| 参数 | 示例值 | 是否必需 | 说明 |
|---|---|---|---|
wd | 变形金刚 | 是 | 搜索关键词。 |
year | 2019 | 否 | 按照年份筛选。 |
tag | 国产大片 | 否 | 按照 TAG 标签筛选。 |
class | 科幻片 | 否 | 按照扩展分类筛选。 |
搜索URL示例:
index.php/artsearch/变形金刚-------------.html
搜索表单与热搜关键词的模板代码:
<!-- 搜索表单 -->
<form id="search" name="search" method="get" action="{:mac_url('art/search')}" onSubmit="return qrsearch();">
<input type="text" name="wd" class="mac_wd" value="{$param.wd}" placeholder="请输入文章关键词"/>
<input type="submit" class="mac_search" value="搜索"/>
</form>
<!-- 后台预设关键词 -->
<div class="hotkeys">
热搜:
{maccms:foreach name=":explode(',',$maccms.search_hot)" id="vo2" key="key2"}
<a href="{:mac_url('art/search',['wd'=>$vo2])}">{$vo2}</a>
{/maccms:foreach}
</div>文章详情页开发
详情页模板文件html/art/detail.html,AID值14,页面数据对象切换为$obj,需要传递文章ID才能正常访问。调试字段可以直接输出对象:
{:print_r($obj)}详情页支持文章内容分页,调用分页标题、正文、来源、发布时间、浏览量等字段:
<h1>
{$obj.art_name} - {$obj.art_page_list[$param['page']]['title']}
</h1>
<div class="source">
来源:{$obj.art_from}
发布时间:{$obj.art_time|date='Y-m-d H:i:s',###}
浏览次数:{$obj.art_hits}
</div>
<div class="content">
{$obj.art_page_list[$param['page']]['content']|mac_url_content_img}
</div>
<!-- 可使用通用分页类获取文章内容分页 -->详情页内可以通过PHP代码查询并展示上一篇、下一篇文章:
<!-- 上下篇 -->
<div class="next">
{php}
$where = [];
$where['art_status'] = ['eq',1];
$where['art_id'] = ['lt',$obj['art_id']];
$pre_info = model('art')->infoData($where,'*',1);
$where['art_id'] = ['gt',$obj['art_id']];
$next_info = model('art')->infoData($where,'*',1);
{/php}
{if condition="$pre_info['code'] eq 1"}
<a href="{:mac_url_art_detail($pre_info['info'])}">
上一篇:{$pre_info['info']['art_name']}
</a>
{/if}
{if condition="$next_info['code'] eq 1"}
<a href="{:mac_url_art_detail($next_info['info'])}">
下一篇:{$next_info['info']['art_name']}
</a>
{/if}
</div>配套提示模板与RSS模板
权限购买提示模板文件:html/art/confirm.html,用于需要付费、扣积分才能阅读的文章,根据用户组别展示登录、充值和购买按钮。
<div class="mac_msg_jump">
<div class="msg_jump_tit">系统提示</div>
<div class="title">亲爱的用户:</div>
<div class="text">
{$popedom.msg}
<p>提示:一次支付,永久观看,不重复扣费,谢谢支持。</p>
{if condition="$user.group.group_id eq 1"}
<a href="javascript:;" class="mac_user">马上登录</a>
{else/}
<a href="{:url('user/buy')}" target="_blank">马上充值</a>
<a href="javascript:;"
onclick="MAC.User.BuyPopedom(this)"
data-id="{$obj.art_id}"
data-sid="{$param.sid}"
data-nid="{$param.nid}"
data-mid="2"
data-type="1">
确认购买
</a>
{/if}
</div>
</div>版权提示模板文件:html/art/copyright.html,用于文章无法正常展示时给出提示,支持设置自动跳转链接。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no">
<title>系统提示【{$obj['art_name']}】</title>
<link rel="stylesheet" href="__STATIC__/css/home.css">
</head>
<body>
<div class="mac_msg_jump">
<div class="msg_jump_tit">系统提示</div>
<div class="title">亲爱的用户:</div>
<div class="text">
【{$obj['art_name']}】{$GLOBALS['config']['app']['copyright_notice']}
</div>
{if condition="$obj['art_jumpurl'] neq ''"}
<div class="jump">
页面自动
<a id="href" href="{$obj['art_jumpurl']}">跳转</a>
等待时间:<b id="wait">3</b>
</div>
{/if}
</div>
{if condition="$obj['art_jumpurl'] neq ''"}
<script>
(function(){
var wait = document.getElementById('wait');
var href = document.getElementById('href').href;
var interval = setInterval(function(){
var time = --wait.innerHTML;
if(time <= 0){
top.location.href = href;
clearInterval(interval);
}
},1000);
})();
</script>
{/if}
</body>
</html>访问密码模板文件:html/art/detail_pwd.html,文章设置访问密码后加载此页面,支持输入密码校验和密码获取链接。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no">
<title>系统提示</title>
<link rel="stylesheet" href="__STATIC__/css/home.css">
<script src="{$maccms.path}static/js/jquery.js"></script>
<script>
var maccms = {
"path":"__ROOT__",
"mid":"{$maccms['mid']}",
"url":"{$maccms['site_url']}",
"wapurl":"{$maccms['site_wapurl']}",
"mob_status":"{$maccms['mob_status']}"
};
</script>
<script src="{$maccms.path}static/js/home.js"></script>
</head>
<body>
<div class="mac_msg_jump">
<div class="msg_jump_tit">系统提示</div>
<div class="title">亲爱的访问此数据需要密码哦~~~</div>
<div class="text">
<form id="form1" name="form1" action="" method="post">
<div class="item">
<label>密码:</label>
<input type="password"
name="pwd"
placeholder="请在此输入访问密码..." />
{if condition="$obj.art_pwd_url neq ''"}
<a href="{$obj.art_pwd_url}" target="_blank">
点击获取密码
</a>
{else/}
<span>密码:{$obj.art_pwd}</span>
{/if}
</div>
<div class="item">
<a class="submit_btn"
href="javascript:;"
onclick="MAC.Pwd.Check(this)"
data-mid="2"
data-id="{$obj.art_id}"
data-type="1">
点击确认
</a>
</div>
</form>
</div>
</div>
</body>
</html>RSS输出模板:html/art/rss.html,用来输出标准化RSS内容,可按需调用标题、链接、摘要、正文等字段。
模板开发常用对象与方法
$vo:循环列表内单篇文章数据$obj:详情页当前文章完整数据$param:读取筛选、搜索、分页请求参数{:print_r($obj)}:打印文章对象,用于字段调试{:mac_url_art_detail($vo)}:生成文章详情链接{:mac_url_img($vo.art_pic)}:处理文章图片地址{$obj.art_page_list[$param['page']]['content']|mac_url_content_img}:分页正文并处理图片
