苹果CMS自定义标签调用，看完这篇你就能自己动手改了

时间：2026年06月10日 14:51:24 来源：易频IT社区

你是不是也遇到过这种情况？看到别人的苹果CMS网站做得特别酷，某个位置展示的内容特别合适，但自己后台翻了个遍，就是找不到那个设置选项。或者，你想在侧边栏加个“猜你喜欢”，在文章底部加个“相关推荐”，模板里却没有现成的模块。

别急，这多半是因为人家用了“自定义标签”。听起来好像很高深，是程序员的事？其实真不是。说白了，它就是一套告诉网站“在这个位置，给我显示那种内容”的简单规则。今天，我就用最直白的话，手把手带你弄懂它，让你也能自由地“指挥”你的网站内容出现在任何地方。

一、先搞懂：自定义标签到底是个啥？

你可以把苹果CMS的模板文件（.html那些）看成是房子的毛坯房。自定义标签，就是你在墙上预留好的电源插座和网线接口。

你不需要懂墙里的电线怎么走（程序逻辑），你只需要知道，把电视插头（调用代码）插到这个插座（标签位置）上，电视（你想显示的内容）就能用了。

所有自定义标签，干的事都一样：从数据库里，按照你的条件，挑出一批内容，然后按你定的样子显示出来。

条件包括：看哪个栏目？最近更新的还是最热的？要多少条？按什么顺序排？

样子包括：每条内容显示标题、简介还是图片？标题多长？点开链接到哪？

在模板里，它通常是这样一段代码：

``` {apple:content 参数1="值1" 参数2="值2"}

{/apple:content} ```

别怕，你不需要会写。你只需要会认和会改里面的参数就行了。上面例子中，`参数1="值1"`就是你需要动手改的地方。

原理懂了，我们来点实在的。你只要记住下面这几个参数，就能解决80%的需求。

order：排序方式。最常用的：`order="id desc"`（按ID倒序，即最新发布的在前），`order="hits desc"`（按点击量倒序，最热的在前）。
where：高级筛选。比如 `where="is_top=1"` 就只调用推荐（置顶）的文章。

避坑提醒：`order`参数里，`desc`是倒序（从大到小），`asc`是正序。搞反了顺序就全反了。

现在，我们假设你想在网站首页侧边栏，加一个“本周热门”列表，显示点击量最高的5篇文章。

登录你的网站后台，进入“模板管理”。找到你当前使用的模板，然后找到首页的模板文件，通常是 index.html 或 index_xxx.html。用编辑器打开它。

在模板里，找到侧边栏的大概区域（一般有`sidebar`、`aside`这类英文注释）。在你希望“本周热门”模块出现的地方，空一行，准备插入代码。

苹果CMS自定义标签调用，看完这篇你就能自己动手改了

把下面这段代码复制进去：

```

```

我来解释一下你刚写的“命令”：

type="1"：调用文章。
order="hits desc"：按点击量从高到低排。
num="5"：只取前5条。
where="DATEDIFF(NOW(), input_time) <= 7"：这是个时间筛选魔法，意思是只选发布时间在7天内的文章。这样就真的是“本周”热门了。
[apple:content.title len='20']：控制标题最多显示20个字符，防止标题太长破坏布局。
([apple:content.hits])：在标题后面显示这篇文章的点击量数字。