═══════════════════════════════════════════════════════════════════════════════
35DIR网站目录系统 - 模板标签使用说明文档
Version 2.0 - 详细完整版
═══════════════════════════════════════════════════════════════════════════════

【系统概述】
35dir系统采用Smarty模板引擎，提供强大的模板标签功能。本文档详细介绍所有可用的模板标签、
函数和变量，帮助开发者快速掌握模板开发技巧。

【模板引擎配置】
- 模板引擎：Smarty 3.x/4.x（支持版本升级）
- 标签分隔符：{# 和 #}（可在 source/include/smarty.php 中修改）
- 模板目录：themes/default/（前台）、themes/system/（后台）
- 编译目录：data/compile/
- 缓存目录：data/cache/
- 升级方法：覆盖 source/extend/smarty 目录即可

【标签语法规则】
1. 变量输出：{#$变量名#}
2. 函数调用：{#函数名(参数1, 参数2)#}
3. 循环语句：{#foreach from=数组 item=项目#}...{#/foreach#}
4. 条件语句：{#if 条件#}...{#else#}...{#/if#}
5. 注释语法：{#* 这是注释 *#}

═══════════════════════════════════════════════════════════════════════════════
一、网站通用标签
═══════════════════════════════════════════════════════════════════════════════

【基础站点信息】
{#$site_root#}        ─── 网站根目录路径（如：http://www.example.com/）
{#$site_name#}        ─── 网站名称（后台设置的站点名称）
{#$site_title#}       ─── 网站标题（浏览器标题栏显示）
{#$site_url#}         ─── 网站完整URL地址
{#$site_keywords#}    ─── 网站关键词（SEO用途）
{#$site_description#} ─── 网站描述信息（SEO用途）
{#$site_copyright#}   ─── 网站版权信息（支持HTML代码）
{#$site_rss#}         ─── RSS订阅链接
{#$site_path#}        ─── 当前位置导航（面包屑导航）

【系统配置信息】
{#$cfg#}              ─── 完整的系统配置数组（包含所有后台设置）
{#$cfg.参数名#}       ─── 获取特定配置参数
{#$script_time#}      ─── 页面执行时间和查询统计
{#$login_status#}     ─── 用户登录状态信息

【使用示例】
{#$site_title#}



{#$site_copyright#}

═══════════════════════════════════════════════════════════════════════════════
二、网站函数标签
═══════════════════════════════════════════════════════════════════════════════

【1. 分类列表函数 - get_categories()】
函数原型：get_categories($cate_id = 0, $top_num = 0, $is_best = false)

参数说明：
- $cate_id：分类ID，默认0表示获取根分类，指定ID获取该分类下的子分类
- $top_num：显示数量，默认0表示显示全部，指定数字限制显示条数
- $is_best：是否只显示推荐分类，true显示推荐，false显示全部

返回字段：
- $cate_id：分类ID
- $cate_name：分类名称
- $cate_mod：分类模块（如webdir）
- $cate_childcount：子分类数量
- $cate_postcount：分类下网站数量
- $cate_link：分类链接地址

使用示例：

{#foreach from=get_categories(0, 10, false) item=cate#}

• 
  
  {#$cate.cate_name#}
  
  ({#$cate.cate_postcount#})
  

{#/foreach#}

【2. 网站列表函数 - get_websites()】
函数原型：get_websites($cate_id = 0, $top_num = 10, $is_pay = false, $is_best = false, $field = 'ctime', $order = 'desc')

参数说明：
- $cate_id：分类ID，0表示全部分类
- $top_num：显示数量，默认10条
- $is_pay：是否只显示付费网站
- $is_best：是否只显示推荐网站
- $field：排序字段（ctime-收录时间, views-浏览次数, instat-点入次数, outstat-点出次数）
- $order：排序方式（desc-降序, asc-升序）

返回字段：
- $web_id：网站ID
- $web_name：网站名称
- $web_url：网站URL
- $web_furl：格式化的URL
- $web_pic：网站缩略图
- $web_intro：网站简介
- $web_ai_intro：AI生成的简介
- $web_tags：网站标签数组
- $web_ctime：收录时间
- $web_utime：更新时间
- $web_views：浏览次数
- $web_grank：Google PageRank
- $web_brank：百度权重
- $web_srank：搜狗权重
- $web_arank：Alexa排名
- $web_link：网站详情页链接
- $cate_name：所属分类名称

使用示例：






【3. 友情链接函数 - get_links()】
函数原型：get_links()

返回字段：
- $link_id：链接ID
- $link_name：链接名称
- $link_url：链接地址
- $link_logo：链接LOGO地址

使用示例：


【4. 数据归档函数 - get_archives()】
函数原型：get_archives()

返回格式：二维数组，年份->月份->网站数量

使用示例：


【5. 广告代码函数 - get_adcode()】
函数原型：get_adcode($ad_id)

参数说明：
- $ad_id：广告位ID（后台广告管理中设置）

使用示例：









【6. 自定义标签 - $label】
用法：{#$label.标签名称#}

说明：调用后台自定义标签管理中添加的标签内容

使用示例：









【7. 站点统计 - $stat】
用法：{#$stat.统计项#}

可用统计项：
- category：分类总数
- website：网站总数（已审核）
- article：文章总数
- apply：待审核网站数
- vip：VIP网站数
- recommend：推荐网站数
- blacklist：黑名单网站数
- rejected：审核不通过网站数
- user：用户总数
- adver：广告总数
- link：友情链接总数
- feedback：反馈总数
- label：自定义标签总数
- page：单页总数

使用示例：





═══════════════════════════════════════════════════════════════════════════════
三、页面专用标签
═══════════════════════════════════════════════════════════════════════════════

【列表页通用标签】
适用页面：directory.html, update.html, archives.html, search.html

{#$weblist#}          ─── 网站列表数组（包含分页后的网站数据）
{#$showpage#}         ─── 分页导航HTML代码

使用示例：





【首页专用标签 - index.html】
首页可以使用所有通用标签和函数标签，无特殊限制。

【分类页专用标签 - directory.html】
{#$category_name#}    ─── 当前分类名称
{#$child_category#}   ─── 当前分类下的子分类数组

子分类字段：
- $cate_id：分类ID
- $cate_name：分类名称
- $cate_postcount：分类下网站数量
- $cate_link：分类链接

使用示例：





【更新页专用标签 - update.html】
{#$days#}             ─── 当前选择的时间周期
{#$timescope#}        ─── 时间范围选择数组

时间范围字段：
- $time_id：时间周期ID
- $time_text：时间周期名称（如：24小时内、3天内、1周内）
- $time_link：时间周期链接

使用示例：


【搜索页专用标签 - search.html】
{#$search_word#}      ─── 搜索关键词
{#$search_type#}      ─── 搜索类型（website-网站搜索, tags-标签搜索）
{#$total_found#}      ─── 搜索结果总数

使用示例：


【网站详情页专用标签 - website.html】
{#$website#}          ─── 当前网站的详细信息数组

网站详情字段：
- $web_id：网站ID
- $web_name：网站名称
- $web_url：网站URL
- $web_pic：网站缩略图
- $web_intro：网站简介
- $web_ai_intro：AI生成简介
- $web_tags：网站标签数组
- $web_ctime：收录时间
- $web_views：浏览次数
- $web_grank：Google PageRank
- $web_brank：百度权重
- $web_srank：搜狗权重
- $web_arank：Alexa排名
- $cate_name：所属分类

使用示例：


═══════════════════════════════════════════════════════════════════════════════
四、Smarty内置标签
═══════════════════════════════════════════════════════════════════════════════

【循环控制】
{#foreach from=数组 item=项目 key=键名 name=循环名#}

{#if $smarty.foreach.循环名.first#}第一项{#/if#}
{#if $smarty.foreach.循环名.last#}最后一项{#/if#}
{#$smarty.foreach.循环名.iteration#}
{#$smarty.foreach.循环名.index#}     
{#foreachelse#}

{#/foreach#}

【条件判断】
{#if 条件#}

{#elseif 其他条件#}

{#else#}

{#/if#}

【变量修饰符】
{#$变量|修饰符#}
{#$变量|修饰符:参数#}

常用修饰符：
- truncate:长度 - 截取字符串
- date_format:格式 - 格式化日期
- escape - HTML转义
- nl2br - 换行转

- strip_tags - 去除HTML标签
- upper - 转大写
- lower - 转小写
- capitalize - 首字母大写

使用示例：
{#$web_intro|truncate:100:"..."|escape#}
{#$web_ctime|date_format:"%Y-%m-%d %H:%M"#}
{#$web_name|upper#}

【包含文件】
{#include file="文件名.html"#}
{#include file="header.html" title="页面标题"#}

【赋值操作】
{#assign var="变量名" value="值"#}
{#assign var="current_time" value=$smarty.now#}

═══════════════════════════════════════════════════════════════════════════════
五、高级应用技巧
═══════════════════════════════════════════════════════════════════════════════

【1. 条件显示内容】

{#foreach from=get_websites(0, 10) item=site#}

{#/foreach#}

【2. 多条件筛选】

{#assign var="tech_sites" value=get_websites(1, 8, false, true)#}
{#if $tech_sites#}

{#/if#}

【3. 数据统计显示】

{#foreach from=get_categories(0, 0, false) item=cate#}
{#if $cate.cate_postcount > 0#}

{#/if#}
{#/foreach#}

【4. 响应式布局】



【5. SEO优化】

{#if $category_name#}
{#assign var="page_title" value="`$category_name` - `$site_name`"#}
{#assign var="page_desc" value="`$category_name`分类下的优质网站推荐，包含`$stat.website`个精选网站"#}
{#else#}
{#assign var="page_title" value=$site_title#}
{#assign var="page_desc" value=$site_description#}
{#/if#}

{#$page_title#}



{#if $website#}

{#/if#}

【6. 缓存控制】

{#* 最新网站列表，缓存5分钟 *#}
{#assign var="cache_id" value="latest_sites_`$smarty.now|date_format:'%Y%m%d%H%i'`"#}


{#assign var="hot_cache" value="hot_sites_`$smarty.now|date_format:'%Y%m%d%H'`"#}

【7. 多语言支持】

{#assign var="lang" value=$smarty.get.lang|default:'zh'#}
{#if $lang == 'en'#}
{#assign var="site_title_lang" value=$cfg.site_title_en#}
{#else#}
{#assign var="site_title_lang" value=$cfg.site_title#}
{#/if#}

【8. 错误处理】

{#assign var="latest_sites" value=get_websites(0, 10)#}
{#if $latest_sites && count($latest_sites) > 0#}

{#else#}

{#/if#}

═══════════════════════════════════════════════════════════════════════════════
六、性能优化建议
═══════════════════════════════════════════════════════════════════════════════

【1. 合理使用缓存】
- 启用Smarty模板缓存：在 source/include/smarty.php 中设置
- 对于数据变化不频繁的页面，设置较长的缓存时间
- 使用 cache_id 区分不同的缓存版本

【2. 减少数据库查询】
- 在一个页面中，尽量减少函数调用次数
- 使用 assign 将函数结果赋值给变量，避免重复调用
- 合理设置函数参数，只获取需要的数据

示例：
{#assign var="hot_sites" value=get_websites(0, 8, false, true)#}
{#assign var="new_sites" value=get_websites(0, 10, false, false, 'ctime')#}

【3. 图片优化】
- 使用适当的图片尺寸
- 为图片添加 alt 属性
- 考虑使用懒加载

【4. 代码优化】
- 避免在循环中进行复杂计算
- 使用条件判断减少不必要的HTML输出
- 合理使用 strip 去除多余空白

═══════════════════════════════════════════════════════════════════════════════
七、常见问题解答
═══════════════════════════════════════════════════════════════════════════════

【Q1：如何修改模板标签分隔符？】
A：编辑 source/include/smarty.php 文件，修改以下两行：
$smarty->left_delimiter = "{#";
$smarty->right_delimiter = "#}";

【Q2：模板缓存如何清理？】
A：删除 data/cache/ 目录下的缓存文件，或在后台系统管理中清理缓存。

【Q3：如何在模板中调用自定义PHP函数？】
A：需要在相应的模块文件中定义函数，然后通过 $smarty->assign() 将结果传递给模板。

【Q4：为什么某些标签不显示内容？】
A：检查以下几点：
1. 标签语法是否正确
2. 数据是否存在
3. 权限设置是否正确
4. 缓存是否需要清理

【Q5：如何实现分页功能？】
A：使用 $weblist 和 $showpage 标签，系统会自动处理分页逻辑。

【Q6：如何自定义404页面？】
A：在模板目录中创建 404.html 文件，使用相应的模板标签。

═══════════════════════════════════════════════════════════════════════════════
八、版本更新说明
═══════════════════════════════════════════════════════════════════════════════

【Version 2.0 更新内容】
1. 新增AI智能简介字段 web_ai_intro
2. 增强网站违规检测功能
3. 优化搜索功能，支持标签搜索
4. 新增多种排序方式
5. 改进缓存机制
6. 增强SEO功能

【兼容性说明】
- 向下兼容旧版本模板
- 新增字段在旧模板中不会报错
- 建议升级模板以使用新功能

═══════════════════════════════════════════════════════════════════════════════
结语
═══════════════════════════════════════════════════════════════════════════════

本文档详细介绍了35DIR系统的所有模板标签和使用方法。在实际开发中，建议：

1. 先熟悉基础标签的使用
2. 根据页面需求选择合适的函数
3. 注意性能优化和缓存策略
4. 保持代码的可读性和维护性
5. 定期更新和备份模板文件

如有疑问，请参考Smarty官方文档或联系技术支持。

文档编写：95DIR开发团队
最后更新：2025年
版权所有：保留所有权利