DCTC客服程序 - 使用说明
======================

版本：1.4.8
授权：GNU GPL v2 或更高版本（见 license.txt）

一、这个插件做什么
----------------
给 WordPress 站点提供自己的客服入口，不依赖第三方「多合一客服」。

电脑端默认是滑出侧栏：平时收起，只露出「在线客服」竖条；鼠标移上去从屏幕边缘滑出联系方式，同时收起竖条。可在后台选择左右、以及宽度和高度。
手机端默认是右下角浮标，点开后列出全部联系方式。

自 1.4.0 起：电脑/手机布局按浏览器视口 CSS 切换，不再用 User-Agent 在服务端写死 HTML。
这样开启 WP-Optimize 等页面缓存时，匿名访客也不会再吃到「被手机先缓存」的错误样式。

二、安装
--------
1. 把整个插件目录放到 wp-content/plugins/ 下。
2. 启用「DCTC客服程序」。
3. 第一次启用会：
   - 若站点里还有多合一客服的配置，自动导入 QQ / 微信 / 电话 / 邮箱；
   - 停用「多合一在线客服插件」，避免两套入口叠在一起。
4. 打开后台左侧「DCTC客服」检查或改联系方式。

三、设置项
----------
启用前台入口    关掉后前台不显示组件
电脑端样式      侧栏（默认，可左右滑出）/ 图标条 / 浮标
手机端样式      浮标 / 图标条
侧栏左右        左侧（默认）或右侧
侧栏宽度 / 高度  宽度默认 176px；高度留空则按内容自动、不出现滚动条
弹出让位        默认关闭。勾选后弹出时正文会跟着挪开，一般不必开
图标条位置      右下、右中、右上、左下、左中、左上（仅图标条 / 浮标）
主题色、圆角、浮标文字、客服名称、欢迎语、侧栏 Logo
路径含 /en/ 或站点语言为英文时显示英文  默认开启。地址里单独一段是 /en/，或站点语言是英文（如 en_US 的 hqbsh.net）时，把界面上的中文换成英文；号码、邮箱和链接不变。中文页仍显示填写的中文
隐藏其他工具条  CSS 选择器，逗号分隔

联系通道：
  序号        越小越靠上
  图标        点「修改」，在小窗口里选。每一条可以单独换，留「跟随」则用通道的图标
  显示名称    图标上的名称，如「QQ客服」
  显示内容    前台展示的文字或号码
  点击后      无操作（只显示文字） / 打开超链接 / 复制号码 / 悬停显示图片
  复制提示文字  仅「复制号码」时填写；留空默认「信息已复制」
  文字下方显示图片  勾选后在文字下面展示二维码等图片（可与点击行为并用）
  超链接      「打开超链接」时填写地址，如 https://wa.me/8613800138000、tel:、mailto:
  图片地址    「悬停显示」或「文字下方显示」时填写

四、给别的站点用
--------------
把本目录打成 zip，在对方 WordPress 后台「插件 → 安装插件 → 上传插件」。
联系方式不会跟着 zip 走，启用后按对方号码重新填。

五、发新版本
----------
改完程序后只在 mkcmd.com 发布，已安装且带本更新接口的站会自己升级：

1. 把 dctc-kefu.php 里的版本号加大。
2. 打好安装包 dctc-kefu.zip（压缩包里要有 dctc-kefu 这一层目录）。
3. 放到 mkcmd.com 的 /download/dctc-kefu.zip，并改 /download/dctc-kefu.json 里的 version。
4. 下载目录 readme.md 里的「版本」改成同一个号。介绍页不写版本号。

各站 WordPress 会向 https://www.mkcmd.com/download/dctc-kefu.json 要版本。json 里的版本更高时，自动下载 zip 并升级。后台「插件」页也能看到更新。

六、文件
--------
dctc-kefu.php           插件入口
includes/channels.php   通道类型（后续扩展主要改这里）
includes/settings.php   默认设置与数据升级
includes/admin.php      后台设置页
includes/frontend.php   前台输出
includes/update.php     向 mkcmd.com 检查新版本
assets/                 样式和脚本
license.txt             GNU GPL v2
使用说明.txt            本文件
