这篇教程将从 “插件是什么” 开始,到 “如何安装、启用、配置、卸载”,并提供一个完整的实例,让你彻底搞懂。

(图片来源网络,侵删)
什么是 DedeCMS 插件?
插件是 DedeCMS 系统的一个功能模块,它允许你在不修改核心程序文件的情况下,为网站增加新的功能,这就像给你的手机安装 App 一样,非常方便和安全。
插件的主要优势:
- 功能扩展:轻松添加留言板、表单、支付、广告等功能。
- 安全便捷:升级 DedeCMS 核心程序时,插件不会被覆盖,无需重新安装。
- 即插即用:安装后启用即可使用,无需复杂的代码操作。
- 管理方便:所有插件都统一在后台的“插件”管理模块中操作。
插件的获取与类型
插件获取:
- 官方市场:DedeCMS 官方网站会提供一些官方认证的插件。
- 第三方平台:许多 DedeCMS 开发者社区和网站会提供各种免费或付费的插件(如织梦吧、DedeCMS 教程网等)。
- 开发者自研:如果你有开发能力,也可以自己开发插件。
插件类型:

(图片来源网络,侵删)
插件通常以一个压缩包的形式提供,常见的格式有 .zip、.rar,解压后,里面通常包含以下文件和文件夹:
install.php:安装脚本,用于将插件文件写入到网站目录,并完成数据库初始化。uninstall.php:卸载脚本,用于删除插件文件和相关数据。plugin.php:插件的主功能文件。config.php:插件配置文件。images/:插件所需的图片文件夹。templets/:插件的前端模板文件夹。
插件使用完整流程(图文详解)
我们以一个典型的插件安装为例,走一遍完整流程。
步骤 1:准备工作(上传插件文件)
- 下载插件:从可靠的来源下载你需要的插件压缩包(一个名为
my_guestbook.zip的留言板插件)。 - 解压插件:将压缩包解压到你的电脑上。
- 上传到网站:
- 通过 FTP 工具(如 FileZilla)登录到你的网站服务器。
- 找到 DedeCMS 的安装目录,通常路径是
/dede/或/include/。 - 将解压后的插件文件夹(
my_guestbook)完整地上传到/dede/目录下。
步骤 2:在后台安装插件
-
登录 DedeCMS 后台:打开你的网站,在后面加上
/dede/进入管理后台(www.yourwebsite.com/dede/),使用管理员账号登录。 -
进入插件管理:在后台左侧菜单中,找到 “系统” -> “插件管理”,并点击进入。
-
执行安装:
- 在插件管理页面,你会看到一个 “上传新插件” 或 “本地安装插件” 的按钮,点击它。
- 在弹出的页面中,你会看到一个文件上传区域,点击 “浏览...” 按钮,选择你刚刚上传到
/dede/目录下的那个插件文件夹(my_guestbook)。 - 选择文件夹后,点击 “确定安装”。
-
等待安装完成:系统会自动运行该文件夹下的
install.php脚本,如果插件与你的 DedeCMS 版本兼容,安装会很快完成,成功后,你会看到“安装成功”的提示。
步骤 3:启用插件
插件安装成功后,默认是未启用状态。
- 回到插件管理列表:在“插件管理”页面,你会看到刚刚安装的插件已经出现在列表中,但“状态”一栏可能显示为“未启用”。
- 点击“启用”:找到你的插件,在操作栏点击 “启用” 按钮。
- 配置插件(可选):启用后,通常会有一个 “参数设置” 或 “配置” 按钮,点击它可以进入插件的配置页面,根据你的需求进行设置(留言板是否需要审核,标题是什么等),设置完成后,点击“保存”即可。
步骤 4:在前台调用插件功能
很多插件需要在网站的某个页面(如首页、文章页)调用才能显示出来,这通常通过 DedeCMS 的 “标签调用” 实现。
- 获取调用标签:查看插件的说明文档,或者进入插件的“参数设置”页面,通常会提供调用标签的代码。
- 在模板中调用:
- 进入后台的 “模板” -> “模板管理”。
- 找到你想要显示插件功能的页面模板(
index.htm是首页模板)。 - 点击模板名称进行编辑。
- 在你希望显示插件内容的位置,粘贴你获取到的调用标签。
- 一个留言板的调用标签可能是
{dede:guestbook/}。 - 保存模板。
- 刷新页面:现在访问你的网站首页,就能看到留言板已经显示出来了。
步骤 5:卸载插件
如果不再需要某个插件,可以将其卸载。
- 进入插件管理:后台 -> 系统 -> 插件管理。
- 找到并卸载:在列表中找到你要卸载的插件,点击其操作栏的 “卸载” 按钮。
- 确认操作:系统会提示你是否确定卸载,确认后,插件的所有文件和相关数据(
uninstall.php脚本编写得当)将被删除。
重要注意事项
- 版本兼容性:这是最重要的一点! 下载插件时,一定要确认它支持你的 DedeCMS 版本(如 DedeCMS 5.7、V5.7、V6.0 等),不兼容的插件可能会导致安装失败,甚至破坏网站系统。
- 来源安全:不要从不明网站下载插件,以免携带病毒或后门,危及网站安全,尽量选择官方或信誉良好的第三方平台。
- 备份!备份!备份!:在安装新插件之前,务必备份你的网站程序和数据库,以防万一插件安装失败或出现问题,可以快速恢复。
- 查看文档:每个插件都有自己的使用说明,安装前花几分钟阅读一下,能帮你少走很多弯路。
- 权限问题:确保你的网站目录(特别是
/dede/和/data/目录)有正确的写入权限,否则安装过程可能会失败。
使用 DedeCMS 插件的流程可以概括为:
下载 -> 解压 -> 上传 -> 后台安装 -> 启用 -> 配置 -> 前台调用
“版本兼容” 和 “数据备份” 这两个黄金法则,你就可以安全、愉快地使用各种插件来丰富你的网站了。
