苹果cms教程

苹果CMS网址详情页模板字段调用与功能开发教程

发布时间:2025-03-26共14人阅读

一、网址详情页基础参数说明

苹果CMS网址详情页用于展示单个网址资源的完整信息,包含专属模板文件、访问参数与固定页面标识,是网址模块核心展示页面。

  • 模板文件路径:html/website/index.html

  • 详情页链接标签:{:mac_url_website_detail($vo)},仅可在 maccms:website 循环标签内部通过 $vo 变量调用

  • 页面专属ID:114,可通过 {$maccms.aid} 标签动态获取

  • 必要访问参数:页面访问URL必须携带 id 参数,用于匹配对应网址资源数据

  • 数据承载数组:当前网址全部信息统一封装在 $obj 数组中

模板开发调试阶段,可使用 {:print_r($obj)} 代码打印输出当前网址的全部字段数据,快速查阅所有可调用参数,适配自定义模板开发需求。

二、网址详情页基础展示示例代码

以下为网址详情页通用基础模板代码,涵盖网站名称、域名、LOGO图标、详细介绍等核心字段,可直接用于详情页基础布局搭建。

<h1>网站名称:{$obj.website_name}</h1>
<p>域名:{$obj.website_jumpurl}</p>
<img src="{:mac_url_img($obj.website_logo)}" alt="logo" />
<!-- 网站详细介绍 -->
<div class="content">{$obj.website_content}</div>
<!-- 详情页当前网址数据为 {$obj} 数组,如下查询全部字段可以参考网址字段 -->

三、页面核心功能:来路统计

网址详情页自带来路数据统计功能,无需开发者自定义编写JS逻辑。系统 static/js/home.js 公共脚本中已内置统计方法 MAC.Website.Referer();。

模板页面正常引入home.js文件后,来路统计功能会自动生效,实时统计网址访问来路数据,无需额外二次开发。

四、模板调用注意事项

  • 详情页所有资源数据依赖 $obj 全局数组,不可随意修改变量名,否则字段无法渲染。

  • 详情页专属链接标签仅支持在网址列表循环内部调用,脱离循环环境会导致链接生成失效。

  • 页面访问依赖URL中的id参数,参数缺失会造成数据读取失败、页面空白。

  • LOGO图片字段需搭配 mac_url_img 函数解析图片地址,保证图片正常加载显示。

  • 来路统计功能依赖系统公共JS文件,需确保脚本正常引入加载,功能方可自动生效。