苹果CMS指南

苹果CMSV10常用处理函数大全

2024-08-16 共人阅读

苹果CMS V10模板提供了丰富的内置处理函数,可以直接在模板标签中对数据进行统计、截取、过滤、格式化以及生成链接等操作。多个处理函数可以连续使用,并使用 | 进行分隔。

数据统计函数

{:mac_data_count(0,'all','vod')} 获取视频总数量
{:mac_data_count(0,'today','vod')} 获取今日更新视频总数量
{:mac_data_count(0,'all','art')} 获取文章总数量
{:mac_data_count(0,'today','art')} 获取今日更新文章总数量
{:mac_data_count(1,'all')} 获取指定分类下的数据总量,支持视频和文章
{:mac_data_count(1,'today')} 获取指定分类下今日更新的数据总量,支持视频和文章

mac_data_count主要用于统计网站的视频、文章以及指定分类下的数据数量。使用分类统计时,可以传入对应的分类ID。

网站链接函数

{:mac_url('map/index')}

mac_url用于生成站内链接,其中参数代表对应的模块和页面,例如 map/index 表示地图页面。

图片地址转换

{$vo.vod_pic|mac_url_img}

mac_url_img用于自动处理图片地址,可以将数据库中的图片地址转换为模板所需要的图片URL格式。

字符串截取

{$vo.vod_content|mac_substring=100}

mac_substring用于截取指定长度的字符串。例如设置为 100,可以返回截取后的100个字符内容,适合用于列表页简介、SEO摘要等场景。

过滤HTML代码

{$vo.vod_content|mac_filter_html}

mac_filter_html用于过滤内容中的HTML代码,只保留文本内容,适合在需要纯文本显示的场景中使用。

生成搜索链接

{$vo.actor|mac_url_create='actor','vod','search'}

mac_url_create可以将使用逗号分隔的一串内容生成多个搜索链接。例如演员字段中存在多个演员名称时,可以将每个演员名称分别转换为对应的搜索链接。

示例中的参数用于创建演员搜索链接,后两个参数可以省略,省略时默认生成 vod 模块的搜索链接。该函数可以用于演员、导演、TAG以及扩展分类等字段的链接生成。

日期格式化

{$vo.vod_time|mac_day}

mac_day用于对时间数据进行日期格式化,可以将时间字段转换为模板页面中需要显示的日期格式。

友好时间显示

{$vo.vod_time|mac_friend_date}

mac_friend_date用于生成更加友好的时间提示,例如“几秒前”“几分钟前”“几小时前”“几天前”等,适合用于显示内容的发布时间或更新时间。

默认值处理

{$vo.vod_year|mac_default='未知'}

mac_default用于设置默认显示内容。当原字符串为空时,可以返回指定的默认字符串。例如影视年份没有填写时,可以显示“未知”。

IP地址格式化

{$user.user_login_ip|mac_long2ip}

mac_long2ip用于将数字形式的IP地址转换为常见的IP地址格式,方便在模板页面中直接显示用户登录IP。

多个函数连续使用

苹果CMS V10模板中可以根据实际需求连续使用多个处理函数,各函数之间使用 | 分隔。例如可以先过滤HTML代码,再进行字符串截取:

{$vo.vod_content|mac_filter_html|mac_substring=100}

这样可以先去除内容中的HTML标签,再对处理后的文本进行截取。实际使用时应根据函数的处理顺序进行组合,以获得预期的输出结果。

总结

以上是苹果CMS V10模板开发中比较常用的一些处理函数,涵盖数据统计、链接生成、图片处理、字符串截取、HTML过滤、时间格式化、默认值处理以及IP地址转换等功能。熟悉这些函数后,可以减少模板中的重复代码,并方便对数据库字段进行二次处理。