船说 CMS 长尾词插件如何安装

学完这篇，你能独立在船说 CMS 上把长尾词插件装好、启用并跑通，让栏目页自动聚合出跟主关键词相关的长尾词列表。

第一步：先确认版本和环境是否够用

这一步的目的是避免装到一半报错。先进后台看版本号：浏览器打开你的域名加 /admin.php，登录后点右上角头像，选「关于系统」，页面上会显示类似 船说CMS v3.x 的版本号，把它记下来。

再看服务器环境。同一页面下方或「系统」→「环境检测」里，会列出 PHP 版本、MySQL 版本、上传大小限制。长尾词插件普遍要求：

• PHP 7.2 及以上（PHP 8.0 部分老插件不兼容，不确定就先用 7.4）
• MySQL 5.6 及以上
• upload_max_filesize 不小于 8M

注意：如果你的 PHP 是 5.6 或更低，别硬装，插件大概率在读取词库时直接白屏，先去主机面板把 PHP 切到 7.4。

第二步：拿到插件包并检查内容

这一步是确认你手里的压缩包是完整的、给船说 CMS 用的，而不是通用版或别的 CMS 的包。正规渠道下载到的文件名通常形如 chuanshuo-longtail-v1.2.zip。

解压后目录里应该能看到这几个东西：

• manifest.json 或 info.php（插件信息，里面写着适用版本）
• controller/、model/、view/ 之类的目录
• install.sql（安装时要导入的数据表）
• readme.txt 或 使用说明.md

打开 manifest.json，看 "cms_version" 字段是不是包含你第一步记下的版本号。不在范围内就先别装，联系插件作者要对应版本。

第三步：上传插件文件

这一步是把插件代码放到服务器上，做完之后后台才能识别到它。

船说 CMS 的插件目录一般是网站根目录下的 /addons/（老版本可能是 /application/addons/）。具体以你第二步 readme 里写的路径为准。

两种上传方式，选一种：

1. 后台传：后台 →「应用」→「插件管理」→「上传插件」，选择 zip 包直接传。这种方式最省事，但受上传大小限制。
2. FTP 传：用 FileZilla 连上服务器，把解压出来的整个插件文件夹（不是 zip 包本身）拖进 /addons/ 目录。传完确认文件夹里的文件都在，别只传了外层空壳。

注意：上传后把插件文件夹权限设成 755，文件夹内文件设成 644。权限给到 777 有些主机会直接报 500 错误。

第四步：后台安装并启用

这一步让系统建表、注册插件，做完后后台会多出长尾词菜单。

回到后台，进入「应用」→「插件管理」。列表里应该出现你刚传的插件名称，状态是「未安装」。点它右边的「安装」按钮，弹出确认框后点「确定」。

安装过程会自动执行 install.sql，几秒钟后页面提示「安装成功」。接着在列表里把该插件的状态开关从「关闭」拨到「开启」。

装完后刷新一下左侧菜单，通常会在「内容」或「SEO」下面看到「长尾词管理」入口。看不到就清一次后台缓存：「系统」→「清除缓存」→ 勾选「模板缓存」和「数据缓存」→ 点「提交」。

第五步：配置长尾词并验证

这一步让插件真正按你的需求生成词。

点进「长尾词管理」→「添加规则」，填三样：

• 主关键词：比如「船说CMS教程」
• 词库来源：选「自动拓展」或上传你自己的 txt 词库（一行一个词）
• 生成数量：建议先填 20 条试水

保存后点「生成」，等进度条走完。

验证方法：打开网站前台任意一个栏目页，看页面底部或侧边有没有出现长尾词链接；再随便点一个，能正常打开文章列表页就说明生效了。

注意：如果前台不显示，多半是模板里没挂调用标签。插件 readme 里都会给一段类似 {volist name="longtail"}...{/volist} 的代码，把它贴到模板文件（一般在 /template/你的模板名/ 下）对应位置。

小结

• 装之前先查版本号和环境，PHP 低于 7.2 先升级
• 插件包要核对 manifest.json 里的适用版本，再解压上传
• 上传目录通常是 /addons/，权限 755／644，别给 777
• 后台「插件管理」里先安装、再开启，菜单不出现就清缓存
• 配置完必须到前台实际点一次链接，模板没挂标签是不会显示的