LiveHelperChat（LHC）完整中文设置教程

LHC 简体中文代码：zh_CN，站点标识 zh，分后台客服面板中文、访客聊天窗口中文、Docker 部署中文、缺失中文包修复四部分。

一、后台客服面板切换中文（操作员界面）

方式 1：个人账号语言（仅当前账号生效）

1. 登录后台 site_admin
2. 顶部菜单：System configuration → Languages configuration
3. 切换到 Your language 标签
4. Language 下拉选择 zh_CN，点击 Save 保存
5. 刷新页面，后台立即变为中文

方式 2：全局默认后台语言（所有管理员默认中文）

1. System configuration → Languages configuration → General language settings
2. Site access 选择 site_admin
3. Language 下拉选 zh_CN，保存
4. 左侧菜单 System configuration → Clear cache 清空缓存

二、访客聊天窗口中文（前端对话弹窗）

1. 嵌入代码指定中文（推荐，单页面独立语言）

1. System configuration → Embed code
2. Choose preferred help mode 下方 Choose a language 选择 zh
3. 复制生成的 JS 代码嵌入网站，访客聊天框默认中文
4. 勾选 Try to detect language automatically 可根据浏览器自动切换中英文

2. 全站默认访客中文（无需修改嵌入代码）

1. 编辑配置文件 settings/settings.ini.php

// 修改默认站点语言
'default_site_access' => 'zh',
// 可用语言列表添加zh
'available_site_access' => array('eng','zh'),

2. 后台清除缓存 Clear cache
3. 直接访问 /zh/chat/start 就是纯中文聊天页

三、Docker 部署 LHC 中文兼容（解决乱码 / 无中文选项）

1. Compose 环境变量添加中文编码

environment:
  LANG: zh_CN.UTF-8
  LANGUAGE: zh_CN:zh
  LC_ALL: zh_CN.UTF-8

2. 容器内安装中文语言包（镜像缺少中文时）

# 进入容器
docker exec -it lhc-web bash
# Debian/Ubuntu
apt update && apt install locales -y
echo "zh_CN.UTF-8 UTF-8" >> /etc/locale.gen
locale-gen
update-locale LANG=zh_CN.UTF-8
# 重启容器生效

四、后台找不到 zh_CN 中文选项（缺失语言包修复）

方案 1：完整源码覆盖（推荐）

1. 前往 LHC GitHub 下载完整源码：https://github.com/LiveHelperChat/livehelperchat
2. 解压 lhc_web/locale/ 文件夹，上传覆盖服务器对应目录
3. 目录结构：lhc_web/locale/zh_CN/（内含翻译文件）
4. 后台清除缓存，刷新语言配置页即可出现 zh_CN

方案 2：手动添加站点访问标识

1. 打开 settings/settings.ini.php

'available_site_access' => array(
    0 => 'eng',
    1 => 'zh', // 新增中文站点标识
),

2. 清空缓存，重启 PHP 服务

五、常见问题

1. 切换后部分文字还是英文
   • 清除系统缓存；部分自定义按钮 / 自动回复需手动在「Canned messages」添加中文版本
2. Docker 中文乱码方块
   • 容器缺少 UTF-8 中文 locale，执行上面「容器内安装中文语言包」命令
3. 嵌入代码无法自动识别浏览器中文
   • Embed code 页面勾选 Try to detect language automatically
4. 新操作员登录还是英文
   • 需要设置全局默认后台语言（方式 2），或让操作员自己在个人语言页切换

六、多语言快捷访问链接

• 英文访客页：域名/lhc_web/eng/chat/start
• 中文访客页：域名/lhc_web/zh/chat/start
• 中文后台：域名/lhc_web/index.php/site_admin/zh