- 在后台管理界面中调用:这是最常见的方式,插件通过提供管理界面,让你在后台进行配置、生成内容或执行操作。
- 在前台模板文件中调用:用于在前台页面动态显示插件生成的数据,例如产品列表、新闻分类、会员信息等。
- 通过PHP代码直接调用:适用于高级开发者,在自定义的PHP文件中直接调用插件的功能。
下面我们针对这几种情况,结合实例进行详细说明。

在后台管理界面中调用(最常用)
绝大多数插件都是为了扩展后台功能而开发的,这种“调用”其实更准确的说法是“使用”或“配置”。
操作步骤:
-
安装插件:
- 登录 DedeCMS 后台。
- 进入“系统” -> “插件管理” -> “插件安装”。
- 上传插件包,然后按照提示完成安装。
-
找到并启用插件:
(图片来源网络,侵删)- 安装成功后,插件会出现在“系统” -> “插件管理”的列表中。
- 找到你刚安装的插件,点击“启用”或“管理”按钮。
-
使用插件功能:
- 大部分插件会在后台的菜单栏中增加自己的菜单项,一个“产品发布”插件可能会在“核心”菜单下增加一个“产品管理”的链接。
- 点击这个链接,你就可以进入该插件提供的后台管理界面,进行内容发布、分类管理、参数配置等操作。
示例:安装一个“自定义表单”插件
- 安装并启用“自定义表单”插件。
- 在后台菜单栏中会出现一个“自定义表单”的菜单。
- 点击进入,你可以在这里创建新的表单(如“在线报名”、“留言反馈”),然后在前台通过特定标签调用这个表单,让用户填写提交。
对于后台功能插件,你不需要在模板里写任何代码,它的“调用”行为是通过你在后台的操作完成的,操作的结果(如生成的表单、发布的产品)会体现在前台页面上。
在前台模板文件中调用
当插件需要在前台页面展示数据时(例如产品列表、友情链接、会员动态等),就需要在模板文件中使用 DedeCMS 的标签来调用。

核心思路:插件在安装时,通常会向数据库中添加新的数据表,并且可能注册新的自定义标签(或修改/扩展现有标签),我们只需要在模板文件中像使用 {dede:arclist}、{dede:channel} 等原生标签一样,使用插件提供的标签即可。
操作步骤:
- 安装并启用插件:同情况一,确保插件已经正确安装并启用。
- 查阅插件文档:这是最关键的一步!一个好的插件会提供详细的文档,说明它提供了哪些自定义标签,以及这些标签的参数是什么,插件可能会告诉你使用
{dede:myplugin}来调用数据。 - 在模板文件中插入标签:
- 打开你需要显示数据的前台模板文件(通常是
.htm文件),位于/templets/目录下。 - 在你需要的位置,像写普通 HTML 一样,插入插件提供的标签。
- 打开你需要显示数据的前台模板文件(通常是
示例1:调用一个“产品展示”插件
假设你安装了一个产品展示插件,它的文档告诉你,使用 {dede:productlist} 标签来调用产品列表。
-
在你的首页模板文件
index.htm中,你想在某个位置显示产品。 -
找到对应的位置,插入以下代码:
<h2>我们的产品</h2> <ul> {dede:productlist row='8' titlelen='30'} <li> <a href="[field:arcurl/]">[field:title/]</a> <p>[field:shortdesc/]</p> <span>价格:¥[field:price/]</span> </li> {/dede:productlist} </ul> -
标签参数说明:
row='8':表示调用 8 条产品数据。titlelen='30'最多显示 30 个字符。[field:arcurl/]、[field:title/]等是字段名,用于获取产品的 URL、标题、描述、价格等信息,这些字段名也需要查阅插件文档。
示例2:调用一个“友情链接”插件
DedeCMS 自带友情链接功能,很多第三方友情链接插件也是通过自定义标签来实现的,假设一个插件提供了 {dede:flink} 的增强版。
<h2>合作伙伴</h2>
<div class="links">
{dede:myflink type='text' row='20' titlelen='12'}
[field:link/]
{/dede:myflink}
</div>
前台调用的关键在于 找到并使用插件提供的自定义标签,如果插件没有提供标签,或者你不知道标签怎么用,一定要去查看插件的 README.txt 或其他说明文档。
通过PHP代码直接调用(高级)
这种方法不常用,主要适用于在插件开发或二次开发中,你需要在一个自定义的 PHP 文件里,获取插件处理后的数据,或者执行插件的某个特定功能。
核心思路:DedeCMS 的插件系统是基于“钩子”(Hook)机制的,插件在安装时会注册一些钩子点,系统在执行到某个特定环节时,会自动去检查并执行已注册的插件,我们也可以手动去触发这些钩子。
操作步骤:
- 了解插件结构:一个插件会有一个
index.php文件,这是插件的核心逻辑文件。 - 手动触发钩子:在需要调用插件功能的 PHP 文件中,使用 DedeCMS 提供的全局函数
RunPHPTag($envs)来手动执行插件。
示例:
假设你有一个名为 MyTestPlugin 的插件,你希望在自定义的 my_page.php 文件中执行它的逻辑。
-
在
my_page.php中引入 DedeCMS 的核心文件:// 引入 DedeCMS 的核心入口文件 // 注意:路径需要根据你的文件位置进行调整 require_once(dirname(__FILE__) . '/include/common.inc.php'); // 你的其他PHP代码...
-
手动调用插件:
// 假设你的插件注册的钩子名叫 'my_custom_hook' // 并且你想要传递一些参数给插件 $plugin_params = array( 'param1' => 'value1', 'param2' => 'value2' ); // 调用所有注册了 'my_custom_hook' 钩子的插件 $result = RunPHPTag('my_custom_hook', $plugin_params); // $result 会返回一个插件执行结果的数组 // 你可以在这里处理 $result if (is_array($result)) { foreach ($result as $res) { // $res 是每个插件执行后的返回结果 // ... } }
重要提示:
- 这种方法要求你对 DedeCMS 的插件系统有深入的了解。
- 直接操作数据库或核心文件有风险,请务必在开发环境或对代码有充分把握的情况下进行。
- 对于绝大多数用户和开发者来说,情况一和情况二已经足够满足需求。
常见问题与排查
如果调用不成功,可以从以下几个方面排查:
- 插件是否安装并启用?:检查后台“插件管理”列表。
- 标签名称和参数是否正确?:这是最常见的问题,仔细核对插件文档,确保标签名、属性名(如
row)、字段名(如[field:title/]])完全正确,注意大小写。 - 模板是否已更新?:修改模板后,需要在后台“生成” -> “更新HTML” -> “更新主页”或“更新指定页面”,才能看到效果。
- 缓存问题:有时候浏览器缓存会导致看不到更新,尝试
Ctrl + F5强制刷新页面,或者清理一下浏览器缓存。 - 插件与系统版本是否兼容?:你安装的插件可能是为旧版本的 DedeCMS 开发的,与新版本不兼容,尝试寻找对应版本的插件,或联系插件作者。
希望这份详细的指南能帮助你顺利地调用 DedeCMS 插件!
