苹果cms教程

苹果CMS V10用户收藏记录模板调用与功能开发教程

发布时间：2025-03-10共9人阅读

一、收藏记录模板基础说明

苹果CMS V10 用户中心收藏记录专属模板文件为 html/user/favs.html，该页面用于集中展示用户账号下所有收藏内容，支持视频、文章、专题等多类型数据展示，同时配备完善的收藏记录删除管理功能。页面数据由系统 $list 数组统一输出，通过 volist 标签循环渲染列表内容。

二、基础数据遍历调用方式

收藏列表依托系统数组与标签实现数据循环读取，可快速调取收藏记录编号、内容名称等核心基础字段，是收藏页面开发的基础语法。

{volist name="list"}
    {$vo.ulog_id}
    {$vo.data.name}
{/volist}

循环内通过 $vo 变量接收单条收藏数据，ulog_id 代表收藏记录唯一ID，data.name 为用户收藏的内容标题名称。

三、完整收藏记录列表模板源码

以下为可直接使用的收藏记录页面完整代码，以表格形式规整展示数据，自动区分视频、文章、专题等不同收藏类型，集成多选、单删操作功能。

<table width="770" border="0" cellspacing="1" cellpadding="0" class="table">
    <tr>
        <td width="66" height="36" align="center" valign="middle" bgcolor="#f7f7f7">选择</td>
        <td width="80" align="center" valign="middle" bgcolor="#f7f7f7">编号</td>
        <td width="317" align="center" valign="middle" bgcolor="#f7f7f7">名称</td>
        <td width="120" align="center" valign="middle" bgcolor="#f7f7f7">进度</td>
        <td width="100" align="center" valign="middle" bgcolor="#f7f7f7">消费积分</td>
        <td width="80" align="center" valign="middle" bgcolor="#f7f7f7">操作</td>
    </tr>
    <form name="form1" method="post">
        {volist name="list"}
            {if condition="$vo.ulog_mid eq 1"}
            <tr>
                <td height="36" align="center" valign="middle" bgcolor="#FFFFFF">
                    <input type="checkbox" name="ids[]" value="{$vo.ulog_id}"/>
                </td>
                <td align="center" valign="middle" bgcolor="#FFFFFF">
                    {$vo.ulog_id}
                </td>
                <td align="left" valign="middle" bgcolor="#FFFFFF" class="pad">
                    {if condition="$vo.ulog_mid eq 1"}
                    <a target="_blank" href="{$vo.data.link}">[{$vo.data.type.type_name}] {$vo.data.name}</a>
                    {elseif condition="$vo.ulog_mid eq 2"}
                    <a target="_blank" href="{$vo.data.link}">[{$vo.data.type.type_name}] {$vo.data.name}</a>
                    {elseif condition="$vo.ulog_mid eq 3"}
                    <a target="_blank" href="{$vo.data.link}">{$vo.data.name}</a>
                    {/if}
                </td>
                <td align="center" valign="middle" bgcolor="#FFFFFF"></td>
                <td align="center" valign="middle" bgcolor="#FFFFFF"></td>
                <td align="center" valign="middle" bgcolor="#FFFFFF">
                    <a href="javascript:;" onclick="delData({$vo.ulog_id},0)" class="delete">删除</a>
                </td>
            </tr>
            {/if}
        {/volist}
    </form>
</table>
<!-- 删除记录脚本 -->
<script>
	function delData(ids,all){
		var msg ='删除';
		if(all==1){
			msg='清空';
		}
		if(confirm('确定要'+msg+'记录吗')){
			$.post("{:url('user/ulog_del')}",{ids:ids,type:2,all:all},function(data) {
				if (data.code == '1') {
					alert('删除成功');
					location.reload();
				}else {
					alert('删除失败：' + data.msg);
				}
			}, 'json')
		}
	}
	$("#btnClear").click(function(){
		delData('',1);
	});
	$("#btnDel").click(function(){
		var ids = MAC.CheckBox.Ids('ids[]');
		if(ids==''){
			alert("请至少选择一个数据");
			return;
		}
		delData(ids,0);
	});
</script>

四、收藏数据类型判断规则

模板通过 ulog_mid 字段自动识别收藏内容所属模块，适配不同类型内容的展示格式，字段对应规则固定：

  • ulog_mid eq 1：匹配视频类收藏数据

  • ulog_mid eq 2：匹配文章类收藏数据

  • ulog_mid eq 3：匹配专题等其他模块收藏数据

针对视频、文章数据，模板自动调取分类名称与内容链接组合展示，让收藏信息更直观；专题类数据则直接展示内容名称，适配不同数据结构。

五、核心收藏字段调用解析

所有收藏详情数据均通过 $vo.data 变量调取，常用核心字段可满足绝大多数模板展示需求：

{$vo.data.name}
{$vo.data.link}
{$vo.data.type.type_name}

  • $vo.data.name：输出收藏内容的标题名称

  • $vo.data.link：输出收藏内容的详情访问链接

  • $vo.data.type.type_name：输出内容所属分类名称

六、收藏删除功能原理详解

1. 单条记录删除

页面每条收藏记录绑定独立删除点击事件，传递当前记录ID与删除类型参数，精准删除单条数据。

<a href="javascript:;" onclick="delData({$vo.ulog_id},0)" class="delete">删除</a>

参数 0 代表仅删除指定单条记录，不影响其他收藏数据。

2. 批量删除功能

通过系统自带 MAC.CheckBox.Ids 方法获取页面选中的多条收藏ID，批量提交删除请求，同时增加空选校验，避免无效操作。

$("#btnDel").click(function(){
    var ids = MAC.CheckBox.Ids('ids[]');
    if(ids==''){
        alert("请至少选择一个数据");
        return;
    }
    delData(ids,0);
});

3. 清空全部收藏功能

修改请求参数为 1 即可开启一键清空功能，自动切换提示文案，批量清空用户所有收藏记录。

$("#btnClear").click(function(){
    delData('',1);
});

4. 删除接口逻辑

所有删除操作统一调用系统原生接口 user/ulog_del，通过 type 参数固定为收藏数据类型，操作完成后根据返回状态弹窗提示并自动刷新页面，同步最新数据。

七、模板修改注意事项

  • 修改模板前备份 favs.html 原文件，避免代码出错导致收藏页面功能异常。

  • 禁止修改、删除 user/ulog_del 系统接口地址，否则会导致收藏删除功能失效。

  • ulog_mid 类型判断、$vo.data 数据字段为系统固定参数，不可随意更名。

  • 页面样式、表格布局可自由美化调整，不会影响收藏数据读取与删除核心功能。

八、功能总结

苹果CMS V10收藏记录页面依托 $list 数组和 volist 标签实现数据渲染，通过 ulog_mid 区分多类型收藏内容，搭配系统原生删除接口，一站式实现收藏展示、单条删除、批量删除、一键清空等完整管理功能。模板结构简洁、兼容性强，可直接用于站点搭建，也可在此基础上拓展分页、排序等自定义功能。

相关标签