苹果CMS开发

开发教程简介

苹果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标签、扩展分类、排序规则等条件:

参数示例值是否必需说明
id1是文章分类 ID。
level9否推荐值筛选。
letterA否首字母筛选。
state1否审核状态筛选。
tag八卦否TAG 标签筛选。
class明星否扩展分类筛选。
orderdesc否排序方向,可使用倒序或正序。
bytime否排序依据,支持 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变形金刚是搜索关键词。
year2019否按照年份筛选。
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}
    &nbsp;&nbsp;
    发布时间:{$obj.art_time|date='Y-m-d H:i:s',###}
    &nbsp;&nbsp;
    浏览次数:{$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}:分页正文并处理图片

标签:文章调用