dede系统参数如何添加配置？-DEDE建站-盈思创科技

教程：如何在DedeCMS系统参数中添加配置项

这个过程主要分为三步：

（图片来源网络，侵删）

添加配置项：在后台界面添加新的参数。
调用配置项：在前台模板或PHP文件中获取并使用这个值。
（可选）代码方式添加：如果需要批量添加或通过代码管理，可以修改PHP文件。

第一步：在后台添加配置项

登录后台：使用管理员账号登录你的 DedeCMS 后台。
进入系统设置：在左侧菜单栏中，找到并点击 【系统】 -> 【系统基本参数】。
切换到“核心设置”选项卡：在打开的页面顶部，你会看到多个选项卡，如“基本参数”、“核心设置”、“会员设置”等，点击 【核心设置】。
添加新的配置项：在“核心设置”页面，你会看到一个包含“变量名”、“变量类型”、“参数说明”和“变量值”的列表，我们需要在列表的底部添加新的行。
（图片来源网络，侵删）
- 变量名：
  - 格式：必须以 cfg_ 开头，后面跟一个有意义的英文或拼音名称，通常使用下划线 _ 分隔单词。
  - 示例：cfg_weixin_qrcode (微信二维码)、cfg_site_beian (网站备案号)。
  - 注意：变量名在整个系统中必须是唯一的。
- 变量类型：
  - 文本：用于输入单行文本，如网址、关键词等。
  - 文本域：用于输入多行文本，如一段描述、一段代码等。
  - 布尔：用于是/否、开/关的选择，会生成一个复选框。
  - 数字：用于输入纯数字。
  - 下拉菜单：提供一个下拉列表供选择。
  - 上传：提供一个文件上传按钮，常用于上传图片或文件。
- 参数说明：
  
  对这个配置项的简短描述,这个描述会显示在配置项的后面，方便管理。
- 变量值：
  
  这个配置项的默认值或初始值。
保存设置：在页面底部找到 【保存】 或 【提交】 按钮，点击它，如果添加成功，系统会提示“成功保存系统基本参数！”。

第二步：如何调用配置项

添加成功后,你可以在网站的任何地方调用这个配置值，调用方式分为两种：在模板文件中调用和在PHP文件中调用。

在模板文件中调用 (推荐)

在 DedeCMS 的模板文件（.htm 文件）中，使用 {dede:global} 标签来调用。

语法：

{dede:global name='变量名'/}

示例：假设我们添加了一个变量名为 cfg_site_beian 的备案号，在模板文件 footer.htm (底部模板) 中这样使用：

<footer>
    <p>版权所有 &copy; 2025 我的公司</p>
    <p>备案号：<a href="http://www.beian.gov.cn" target="_blank">{dede:global name='cfg_site_beian'/}</a></p>
</footer>

在PHP文件中调用

在 PHP 文件中，你需要通过 global $dsql; 声明数据库连接对象，然后查询 dede_sysconfig 表来获取配置值。

语法：

<?php
// 引入数据库连接（在DedeCMS的PHP文件中通常已经存在）
global $dsql;
// 查询配置项
$row = $dsql->GetOne("SELECT * FROM `#@__sysconfig` WHERE varname = '你的变量名'");
// 获取变量值
$变量值 = $row['value'];
// 使用变量值
echo $变量值;
?>

更简洁的封装方法： DedeCMS 提供了一个更方便的函数 GetCp()，可以直接获取配置值，无需手动查询数据库。

语法：

<?php
// 引入全局函数库（如果未引入）
// require_once(DEDEINC.'/inc/inc_fun_funAdmin.php');
// 直接获取配置值
$变量值 = $GLOBALS['cfg_你的变量名'];
// 或者使用函数（推荐）
$变量值 = GetCp('你的变量名');
// 使用变量值
echo $变量值;
?>

示例：假设在 index.php 文件中需要调用我们添加的 cfg_weixin_qrcode：

<?php
require_once(dirname(__FILE__)."/include/common.inc.php");
// 使用 GetCp 函数获取微信二维码图片地址
$weixin_qrcode = GetCp('weixin_qrcode');
// 在PHP逻辑中使用
if(!empty($weixin_qrcode)){
    // 将图片地址传递给模板
    $smarty->assign('weixin_qrcode', $weixin_qrcode);
}
// ... 其他代码
?>

第三步：代码方式批量添加 (进阶)

如果你有很多配置项需要一次性添加,或者不希望每次都去后台操作，可以直接修改数据库。

登录你的数据库管理工具（如 phpMyAdmin）。
选择你的 DedeCMS 数据库。
找到 dede_sysconfig 表。
点击“插入”，添加新的记录。
- varname：填写你的变量名（如 cfg_new_feature）。
- info：填写参数说明（如“新功能开关”）。
- type：填写变量类型（如 bool）。
- value：填写默认值（如 Y）。
- groupid：填写所属分组ID，可以在后台看其他项的ID，通常核心设置为 1。
- att：附加属性，下拉菜单类型会用到，可以留空。

添加完成后,刷新后台的“系统基本参数”页面，你就会看到新添加的配置项了。

完整实例：添加并显示一个“客服QQ”号

目标：在网站底部添加一个客服QQ号，并通过后台系统参数来管理。

步骤 1：添加配置

进入后台 【系统】 -> 【系统基本参数】 -> 【核心设置】。
在列表底部添加一行：
- 变量名：cfg_kf_qq
- 变量类型：文本
- 参数说明：客服QQ号码
- 变量值：123456789
点击 【保存】。

步骤 2：在模板中调用

打开你的网站底部模板文件,通常是 /templets/default/foot.htm。
在合适的位置（例如版权信息旁边）添加以下代码：
```
<p>客服QQ：<a target="_blank" href="http://wpa.qq.com/msgrd?v=3&uin={dede:global name='cfg_kf_qq'/}&site=qq&menu=yes">{dede:global name='cfg_kf_qq'}</a></p>
```
- 这里的 http://wpa.qq.com/... 是QQ官方提供的在线交谈链接，点击后会弹出QQ聊天窗口。
保存 foot.htm 文件，并刷新网站前台。

步骤 3：验证

你可以去后台修改 【系统基本参数】 中 【客服QQ号码】 的值，比如改成 987654321，然后保存，刷新网站前台，你会发现底部的QQ号已经自动更新了，无需修改任何代码。

注意事项

变量名唯一性：确保你添加的变量名没有和系统已有的冲突。
变量名规范：始终以 cfg_ 开头，养成良好的命名习惯。
缓存问题：有时修改系统参数后，前台页面可能没有立即生效，可以尝试清除浏览器缓存，或者在后台的 【系统】 -> 【一键更新缓存】** 中更新一下系统缓存。
谨慎操作：修改数据库有风险，操作前请务必备份数据库。

通过以上方法,你就可以灵活地为你的 DedeCMS 网站添加各种自定义配置了。

dede系统参数如何添加配置？