使用文档

2. 填写授权码

程序装好后默认未激活，后台除了授权页以外会被锁定。授权服务器与通信密钥已经内置，站长只需要填一枚授权码。

1. 打开授权管理登录主程序后台，左侧菜单点「授权管理」。页面会显示一串「本站指纹」（8 位），申领授权码时把「域名 + 这串指纹」一起发给老李。
2. 粘贴授权码授权码一栏粘贴老李发的那串，形如 DTR-XXXXXXXX-XXXXXXXX-XXXXXXXX，第一段就是本站指纹，注意大小写与横线。
3. 保存并校验点「保存并校验」。状态显示「授权有效」、方案与到期时间即为开通，不需要填授权服务器、密钥或绑定域名。
4. 域名自动识别程序按当前访问域名自动校验；换域名或换服务器联系老李重新换绑，换绑会给出一枚新码，替换后点「立即联网检测」即可，不用重装。
5. 离线宽限在线校验成功后结果缓存 12 小时；授权服务器暂时连不上时，站点在默认 7 天宽限期内照常运行，恢复后自动重验。

授权状态、到期时间、绑定域名、本站指纹、上次校验时间都在「授权管理」页显示，随时可以点「立即联网检测」强制刷新。

常见校验提示

不要为了跳过校验去改授权文件：改坏之后换绑、续费都会失效，而且无法自动恢复。授权问题直接找老李处理最快。

4. 开发新模板

一套模板就是 templates/ 下的一个文件夹，纯 PHP 写页面，没有模板标签、没有编译缓存。 做好后丢进目录，后台「模板管理」自动列出来，点「启用」就切换；删掉整个文件夹就能干净移除，不留残余。

4.1 目录结构

templates/你的模板名/
 ├─ Dtr.php            模板信息（后台模板列表读取）
 ├─ Config.php         模板配置默认值（后台改过的值存数据库）
 ├─ Form.html          后台「模板配置」表单
 ├─ pic.png            模板预览图
 ├─ views/             前台视图
 │   ├─ layout.php     公共外壳（有它就不用每页写头尾）
 │   ├─ index.php  sort.php  site.php  search.php  pager.php
 │   ├─ nav.php  ranking.php  ranking_body.php  404.php
 │   ├─ apply.php  daishen.php  about.php  tongji.php
 │   ├─ wz_all.php  wz_show.php  wz_sort.php
 │   └─ user.php  login.php  register.php
 └─ public/pc/         本模板自带的 css / js / img

最快上手方式：把 templates/default 整个复制一份改名，先改 Dtr.php 的 name 与 title、再换 public/pc/ 里的配色，前台就能跑；之后逐步替换页面。 缺哪个视图文件，引擎会自动回退到 default 的同名文件，所以可以只做首页、其余页面先沿用默认。

4.2 模板信息 Dtr.php

// Dtr.php —— 键名固定，值随便改；name 必须等于目录名
return [
    'title'   => '我的模板',
    'name'    => 'mytpl',
    'author'  => '张三',
    'version' => '1.0.0',
    'pic'     => 'pic.png',
    'link'    => 'https://wpa.qq.com/msgrd?v=3&uin=1735737677&site=qq&menu=yes',
    'set'     => '1',               // 1 = 允许后台「模板配置」
    'desc'    => '一句话介绍这套模板。',
];

后台模板列表靠这个文件识别模板：没有 Dtr.php 的目录不会出现在列表里，name 必须和目录名一致。

4.3 模板配置 Config.php + Form.html

// Config.php —— 键名自定义，视图里用 tplcfg('键名') 取
return [
    'hero_title'   => 'DTR 自动收录导航',
    'hero_desc'    => '专注优质站点收录，自动抓取、人工审核、快速上线',
    'theme_main'   => '#2fadf8',
    'foot_link'    => "首页,/\n关于,/about.html",   // 多行值必须用双引号
    // 开关型字段列在这里：未勾选存 0，勾选存 1
    '_switch'      => 'hero_open,show_tui,show_new,show_hot',
];

<!-- Form.html：字段名必须和 Config.php 的键一一对应 -->
<input class="input" name="hero_title" value="<?php echo e(tplcfg('hero_title')); ?>">

<label class="switch">
  <input type="checkbox" name="hero_open" value="1" <?php echo tplcfg('hero_open') == '1' ? 'checked' : ''; ?>>
  <i></i><span>显示首页横幅</span>
</label>

默认值写在 Config.php，站长在后台「模板配置」改过的值存进数据库，不会覆盖你的文件； 点「恢复默认」就删掉数据库里那份，重新读你的文件。视图里一律用 tplcfg('键名') 取值。

两个最容易踩的坑：① 多行默认值（比如页脚链接）必须用双引号写 "a\nb"，单引号里的 '\n' 是两个字符； ② 勾选类字段要在数组里写一行 '_switch' => 'a,b,c' 把开关字段名列出来，没列出的字段按普通文本保存。

4.4 视图里能用的函数与变量

<?php /* views/ 里能直接用的函数 */ ?>
<?= e(tplcfg('hero_title')) ?>                   模板配置（后台改过就用改后的）
<?= e(dtr('name')) ?>                            站点名称
<?= tpl_url('css/style.css') ?>                  本模板静态资源 → templates/当前模板/public/pc/css/style.css
<?= url('index') ?>                              首页地址（自动带伪静态后缀与子目录）
<?= url('sort', ['alias' => 'gongju']) ?>        分类地址 → /list/gongju.html
<?= e(cut($site['description'], 80)) ?>          截断输出
<?= ad(1) ?>                                     广告位 1（后台「系统设置 → 广告位」里贴代码）

<?php /* 控制器传什么变量，视图里就有什么 */ ?>
index.php：$sorts / $recommend / $latest / $topView / $recent / $notice / $links / $articles
sort.php：$sort / $sites / $total / $pages / $cur
site.php：$site / $sort / $domain / $related
wz_show.php：$article / $sortwz

数据由控制器传进来，模板不做查询；静态资源一定要用 tpl_url() 输出，这样才会指向本模板自己的目录， 写死 /public/... 会串到插件目录去。所有输出用户内容的地方都要用 e() 转义。

4.5 给插件留钩子

插件靠模板里的钩子把入口挂进页面（比如插件在页脚挂一个入口链接）。这几个钩子建议照着 default 全部保留， 新模板少写一个，对应插件在前台就没有入口：

<?php \DTR\Core\Hooks::fire('front_head', ['page' => $page]); ?>         <!-- </head> 前：插件插 css/js -->
<?php \DTR\Core\Hooks::fire('front_nav_extra', ['navs' => $navs]); ?>   导航条末尾
<?php \DTR\Core\Hooks::fire('front_footer_extra'); ?>                   页脚链接区（插件入口挂这里）
<?php \DTR\Core\Hooks::fire('front_body_end', ['page' => $page]); ?>    </body> 前：统计脚本等

# 内容插槽（模板里留位置，插件或广告往里放内容）
front_slot_head   front_slot_home   front_slot_side   front_slot_detail