Botble Martfury主题缺失LanguageAdvanced插件集成方案咨询

适用环境 #

• 程序基础：基于Laravel框架开发的Botble Martfury主题
• CMS版本：5.20
• Laravel框架版本：8.55.0
• 已知情况：官方演示环境默认内置Language、LanguageAdvanced插件，单独购买的主题安装包不携带这两个插件
• 实现目标：后台商品创建/编辑页面支持多语言切换，可查看、录入不同语言版本的商品名称

具体集成步骤 #

注意：必须使用适配CMS 5.20版本的插件安装包，适配Botble CMS 6.x及以上版本的插件依赖Laravel 9+新特性，强行安装会直接触发依赖报错；不要使用来路不明的破解插件，大概率存在后门、功能缺失问题。

1. 插件部署与激活 #

• 将Language基础插件解压到项目/platform/plugins目录，确保目录归属web运行用户、具备读写权限
• 进入项目根目录，执行以下命令激活基础语言插件：

php artisan plugin:activate language

• 执行第一轮缓存清理：

php artisan cache:clear
php artisan config:clear

• 用同样的方式将LanguageAdvanced插件解压到/platform/plugins目录，执行激活命令：

php artisan plugin:activate language-advanced

• 执行全量缓存清理，避免旧缓存导致功能不生效：

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

• 登录后台进入插件管理列表，确认两个插件状态均显示为「已启用」

2. 多语言规则配置 #

• 进入后台语言设置页面，添加业务需要的所有目标语言，设置站点默认展示语言
• 进入LanguageAdvanced插件配置页，开启「模型多语言关联」功能，在可绑定模型列表中勾选Product（商品模型）
• 在商品模型的可翻译字段配置项中，勾选name（商品名称）为可翻译字段，可根据实际业务需求，额外勾选商品描述、短标题、SEO字段等其他需要做多语言适配的内容项
• 保存配置后，执行数据库迁移命令，确保插件所需的多语言关联表创建完成：

php artisan migrate

3. 功能验证 #

• 进入后台商品新建/编辑页面，编辑区上方会展示已配置的所有语言的切换选项卡
• 切换到指定语言标签页，即可单独录入该语言版本的商品名称及其他已配置的可翻译字段
• 保存商品后，切换前台站点语言即可看到对应语言的商品内容正常展示

常见异常排查 #

• 商品编辑页不显示语言切换栏：重新核对两个插件的启用状态，重新执行视图、路由缓存清理命令后，强制刷新浏览器页面重试
• 多语言内容保存后不生效：检查商品模型的多语言绑定配置是否正确，确认插件相关多语言数据表已成功创建，可重新执行迁移命令补全缺失的数据表
• 激活插件时抛出语法错误/依赖错误：直接更换插件版本，当前环境只能使用适配Botble CMS 5.20的插件包，高版本插件无法兼容

内容的提问来源于stack exchange，提问作者Manish Kumar Dholpuriya