推荐商家

它能做什么

• 列表页：一行行商家卡片（主图 + 名称 + 域名 + 一句话简介 + 浏览量）
• 详细页：左侧大图，右侧「商家详情 / 联系方式 / 在线咨询 / 投诉与反馈 / 温馨提示」，下方标签页「商家介绍 · 用户评价」
• 首页板块：勾了「首页推荐」的商家会出现在首页那一节
• 咨询与投诉：访客填表 → 进后台留言 → 同时发通知邮件

后台怎么用

入口：后台左侧「栏目素材 → 推荐商家」。需要的权限项是 merchant.manage。

列表页只管看与删除/隐藏；新增与编辑在独立页面（跟内容、轮播一致）。

「自动获取」是什么

点一次，服务器就去商家地址抓回网页标题、网站图标、主题色，写进「自动获取到的值」。

• 它只在你点按钮时执行；页面渲染时不会去请求对方站点（否则既慢，又等于拿访客流量骚扰别人）
• 「回填」会把抓到的值写进空的输入框。⚠️ 一旦写进「自定义标题」，它就不再跟随对方网站变化 —— 想保持跟随就把该框清空
• 抓取有安全限制：只允许 http/https、拒绝内网与本机地址、不跟随跳转、超时 8 秒、响应体截断

前台标签

{naicha:merchants num="60"}
  <a href="{merchant.url}">
    <img src="{merchant.show_shot}" alt="{merchant.show_name}">
    <b>{merchant.show_name}</b>
    <span>{merchant.intro}</span>
    <span>浏览 {merchant.hits} 次</span>
  </a>
{/naicha:merchants}

只要首页那一节，加 featured="1"：{naicha:merchants featured="1" num="8"}

三条路由

咨询与投诉是怎么走通的

1. 前台弹窗提交到 /message（这是只收 POST 的地址，用普通链接打开一定 404）
2. 后台「留言」里出现一条，来源分别标为商家咨询 / 商家投诉
3. 同时按「站点设置 → 邮件」里配的 SMTP 发一封通知到 notify_email

⚠️ 想收到通知，必须在站点设置里填「通知邮箱」；这个键为空时通知会静默不发，日志也不会报错。

必须避开的坑