=====================================================
炎酷CMS 网站内容管理系统 V1.2  使用说明
=====================================================

一、环境要求
-----------------------------------------------------
- PHP 7.4 ~ 8.2（需启用 pdo_mysql 扩展）
- MySQL 5.6+ / MariaDB 10+
- Nginx 或 Apache
- 推荐宝塔面板部署，PHP 版本在【网站 → 设置 → PHP版本】中切换

二、目录结构（安全设计：仅 public/ 对外公开）
-----------------------------------------------------
  public/          网站根目录（宝塔【网站 → 设置 → 网站目录】指向此目录）
    index.php      前台入口（首页/栏目/文章/单页 路由）
    install.php    一键安装向导（安装后自动删除）
    admin/         后台管理
    api/           上传接口（upload.php、ueditor.php）
    assets/        公共静态资源（css/js/ueditor）
    uploads/       上传文件（按 20260804 日期目录归类）
  inc/             前台核心（db.php、functions.php、render.php）
  template/        全部模板（外网无法直接访问，防源码泄露）
  cache/           文件缓存
  data/            配置文件、安装锁、数据库备份
  nginx-rewrite.txt  Nginx 伪静态与保护规则
模板、配置、程序源码均在 public/ 之外，外网无法跨目录读取。

三、安装步骤
-----------------------------------------------------
1. 将本程序全部文件上传到站点目录（如 /www/wwwroot/你的域名），
   并将网站运行目录设置为 public/。
2. 确保 public/uploads/、cache/、data/ 三个目录可写
   （宝塔文件管理中设置权限 755，所有者 www）。
3. 浏览器访问 http://你的域名/install.php ，按向导完成安装：
   步骤1 许可协议 → 步骤2 环境检测 → 步骤3 目录权限校验
   → 步骤4 数据库与管理员表单 → 步骤5 执行安装 → 步骤6 完成。
4. 安装完成后 install.php 会自动删除；若删除失败，请手动删除该文件。
5. 如需重新安装：删除 data/install.lock 和 data/config.php，
   并清空数据库中对应前缀（默认 yk_）的数据表后，重新访问 install.php。

四、后台管理
-----------------------------------------------------
- 后台地址：http://你的域名/admin/login.php
- 账号密码为安装时设置的管理员账号；连续输错 5 次锁定 10 分钟。
- 功能一览：
  · 站点设置：基本信息、LOGO/微信二维码/favicon（上传+图片库选择）、
    全局主题颜色（导航条背景/文字、底部背景/文字、侧栏标题背景/文字）、
    客服浮动条（开关/电话/微信二维码）、上传限制（大小/后缀）、
    顶部广告条（图片行编辑器+公告）。
  · 在线编辑（可视化模板设置）：左侧卡片点选、右侧真实页面实时预览，
    覆盖首页（导航 1-5、广告条 1-8、客服浮动条 1-3、底部 1-2）、
    首页区块（模块模板与标题样式）、文章列表（12 套）、文章内容（3 套）、
    单页面（10 套）；主题色即调即见，支持电脑/手机双端预览，
    预览不写数据库、不计访问统计，点「保存并生效」后前台正式更新。
  · 首页区块：关于我们/文章/产品（案例）三类模块，
    可添加多个、排序、开关显示、标题颜色自定义；
    模块模板样式与标题样式在【在线编辑】中可视化选择。
  · 栏目管理：导航显示名与是否显示、地址别名 flag（伪静态开启后栏目
    地址为 /别名/，如 product、news，可填英文或栏目名拼音）、封面图、
    分页条数、SEO 三件套、预览新窗口打开；列表模板（12 套）与
    内容页模板（3 套）在【在线编辑】中按栏目可视化选择；
    单页管理已合并为本页的「单页管理」标签页（形象图片、
    页面模板在【在线编辑】中选择、导航显示控制）；栏目与单页在导航中按排序号统一混排；
    列表中栏目名称、排序可双击直接修改。
  · 文章管理：百度 UEditor 富文本（粘贴外部图片自动转存本站、
    内置图片库）、缩略图留空自动提取正文第一张图、图集、预览；
    内容选项默认勾选「删除内容中的网址」「自动上传内容中的图片」；
    发布时间可修改；列表中标题、浏览量、排序可双击直接修改；
    删除文章会同时删除其引用到 uploads 的图片。
  · 单页管理：形象图片（供首页关于我们模块调用）、单页模板 1-10、
    导航显示控制、UEditor 内容（同样支持两个内容选项）、预览。
  · SEO 管理：全站 SEO 三件套 + 伪静态开关（见第五节）。
  · 访问统计：按 IP 记录前台访问，展示 今天/昨天/本周/上周/本月/上月/
    今年/去年/总访问量 的 IP 数与浏览量，并可查看最近访问明细。
  · 素材管理：图片库（所有上传图片统一查看/复用/删除，
    删除会同时删除 uploads 中的物理文件；图库选择弹窗内也可删除）。
  · 系统工具：账号/改密码/清缓存/数据备份/操作日志/在线升级。
- 顶栏右上角【在线升级】：配置升级服务器地址后可检测文件与数据库
  变动并一键升级（升级前自动备份受影响文件到 data/backup/）。

五、Nginx 伪静态配置
-----------------------------------------------------
宝塔面板 → 网站 → 设置 → 伪静态，将根目录 nginx-rewrite.txt 的
内容粘贴保存即可。Apache 用户无需配置，.htaccess 已内置同样规则。
后台【SEO 管理】开启伪静态开关后，全站链接使用静态化地址：
  栏目  /{栏目别名}/（如 /product/、分页 /product/2/，别名在栏目管理中设置，
        未设置别名的栏目回退 /col-1.html）
  文章  /art-1.html
  单页  /about.html（/{单页标识}.html）
关闭或服务器未配置时使用 ?col=1、?art=1 动态地址，功能不受影响。
开启后若页面 404，说明服务器未粘贴伪静态规则。
默认栏目与别名：新闻中心 news、产品中心 product、客户案例 case；
默认单页标识：关于我们 about、联系我们 contact（均可在后台修改）。

六、模板机制与扩展规则
-----------------------------------------------------
模板目录 template/ 下按类型分文件夹，文件为 .html 后缀（内含 PHP 片段）：
  header/    头部导航     header_1.html ~ header_6.html
  footer/    底部         footer_1.html ~ footer_5.html
  banner/    顶部广告条   banner_1.html ~ banner_8.html
  block/     首页区块     about_1~5.html（关于我们）
                          article_1~5.html（文章模块）
                          product_1~5.html（产品/案例模块）
  article/   文章内容页   art_1.html ~ art_3.html
  float/     客服浮动条   float_1.html ~ float_3.html
  page_tpl/  单页模板     page_1.html ~ page_10.html
  list_tpl/  列表模板     list_1.html ~ list_12.html

- 主题颜色通过 CSS 变量作用于模板：--yk-nav-bg、--yk-nav-color、
  --yk-footer-bg、--yk-footer-color、--yk-side-bg、--yk-side-color，
  模板写法 var(--yk-nav-bg, 默认色)，后台未设置时使用模板默认色。
- 模板在后台按编号选择，文件缺失时自动回退 1 号模板，不会白屏。
- 模板内可用：$site、$nav、e()、site_config()、fdate()、
  block_title_html()、url_col()/url_art()/url_page()/url_home()；
  文章/产品模块另有 $data_list、$show_thumb/$show_desc/$show_time；
  about 模块另有 $about（name/image/intro/url）；
  内容页另有 $art/$col/$prev/$next；客服条另有 $kefu（phone/wechat）。
- 所有模板已内置三档自适应样式（≥1200px / 768-1199px / ≤767px）。

七、安全说明
-----------------------------------------------------
- 全站 PDO 预处理防注入，输出统一 e() 转义，后台表单带 CSRF 令牌。
- 上传仅登录后可用；后缀白名单（默认 jpg,jpeg,png,gif,webp），
  多点文件名（如 shell.php.jpg）与脚本后缀一律拒绝；
  getimagesize 内容校验防"jpg 后缀木马"；保存名强制随机重生成。
- UEditor 远程图片转存带 SSRF 防护（拒绝内网地址），仅允许 image/*。
- 源码、模板、配置位于 public/ 之外，外网无法直接读取；
  data/、cache/、inc/、template/ 另有 deny 规则双重保护。
- 数据库备份文件保存在 data/backup/，请定期下载到本地保存。

=====================================================
炎酷CMS 版权所有，保留所有权利。
