你是不是做苹果CMS站时，想按年份规整内容？比如把所有2020年的电影归成一类？结果搜的教程全是“自定义字段关联”这种云里雾里的话？折腾半天要么调不出来，要么跑错页面？别慌，今天给你讲的，复制代码就能用，看完直接搞定。
一、先做2件准备工作（不然调用必翻车）
说白了，调用年份标签不是随便放代码就行，得先确认2件事，省得后面白忙活。
1. 确认你的苹果CMS版本（只有v10通用）
先登后台，点系统设置，拉到最下面看版本号。如果是v10，下面的方法直接用。如果是其他版本，去对应版本的教程改代码。举例子，我之前帮朋友弄v8的，代码差个参数，白忙活半小时，所以版本先确认，别省这一步。
2. 给内容补全年份自定义字段
你传内容的时候，是不是只填了标题分类？记得给每个内容加个叫「year」的自定义字段，值是四位数字的年份，比如2021、2022。别写21或者二零二一，代码识别不了。举例子，上周帮我哥弄站，他写21，调用出来全是空，改了四位才好。如果你的内容已经传了很多，不用一个个改，用苹果CMS的批量编辑，全选内容，统一修改year字段，直接填年份，省不少时间。
二、核心调用代码（复制直接用，不用改太多）
这部分是干货中的干货，所有代码都是实测能用的，重点改的地方我会加粗标出来。
1. 调出单一年份的内容列表
比如你要做个2023年的内容页，直接把这段代码放到你要放的模板里：
```
{cms:content action="list" catid="你的分类ID" year="2023" order="time desc" row="10"}
{cms:title}
{/cms:content}
```
重点改的地方：
把代码里的2023换成你要的年份，还有
catid改成你内容的分类ID，比如电影是5，动漫是6。row是显示条数，要改就改数字。举例子，我之前弄的时候，分类ID填成2，结果全是电视剧，改回5就对了。如果要按其他顺序，比如热门优先，把order改成hits desc就行。
2. 调出导航栏的年份筛选
比如你要在顶部导航做个下拉，点2020就跳对应页面，用这段代码，不用自己一个个写年份：
```
{cms:loop start="2018" end="2024" name="year"}
{cms:name}
{/cms:loop}
```
这里的start和end是你内容的年份范围，比如你的内容从2018到2024，就填这两个数。这个代码循环输出所有年份，点击跳转到对应内容页，省很多时间。要是你想加个“全部”选项，在循环前面加个
全部就行。
三、3个避坑提醒（看完少走1小时弯路）
这几个坑都是站长常踩的，别等出错了才来补救。
1. 自定义字段的键名不能写错
你加的年份字段叫year，代码里的year参数就不能写成Year或者年份，大小写都不行。举例子，上次有个站长把键名写成Year，结果调用不出内容，改回小写就好。还有，别加多余的空格，比如「year 」，代码识别不了。
2. 改完代码一定要清缓存
苹果CMS改了模板或者代码，前台可能不更新，这时候要登后台，点系统设置里的「清理缓存」按钮，再刷新页面，就能看到效果。别等，我之前改完忘清，以为代码错了，折腾半小时，清完就好。要是清了还不行，再看看有没有开页面缓存，临时关掉测试。
3. 分类ID一定要填对
代码里的catid要对应你内容的分类，比如你要的是动漫内容，就填动漫的分类ID，不然会把其他分类的内容调出来。举例子，你要电影，填成动漫的ID，结果全是动漫，白忙活。找不到分类ID的话，去后台的分类管理里，把鼠标放在分类上，链接最后那个数字就是ID。
今天别拖，打开你的苹果CMS后台，先确认版本，再找一条内容检查year字段有没有填对。然后复制代码，改自己的年份和分类ID，放到模板里，刷新看看。要是遇到问题，先核对键名、分类ID，再清缓存，大概率就能搞定。就这几步，比你查教程瞎琢磨快多了。
