dede global标签如何使用及参数配置？

这是一个非常重要且常用的全局标签,主要用于获取和显示网站的全局配置信息，这些信息通常存储在数据库的 dede_sysconfig 表中。

{dede:global} 标签是什么？

{dede:global} 标签是一个全局变量调用标签，它的作用是从 DedeCMS 的系统配置中读取预先设定好的值，并将其显示在模板页面上。

核心特点：

• 作用域： 全局，可以在网站的任何模板文件（包括首页、列表页、内容页等）中使用。
• 数据来源： 数据库 #@__sysconfig 表。
• 功能： 用于调用网站的基本信息、路径、开关等配置，避免在多个模板中重复硬编码信息，方便统一管理和修改。

基本语法

{dede:global} 标签有两种常见的使用形式：

简单形式：调用单行配置

{dede:global.name/}

• name：这是你要调用的配置项的名称，这个名称必须与数据库 #@__sysconfig 表中 varname 字段的值完全一致。

循环形式：调用多行配置（主要用于获取所有配置项）

{dede:global name='list' item='field'}
    {field.varname} => {field.value}
{/dede:global}

• name='list'：固定写法，表示获取所有系统配置项。
• item='field'：定义一个循环变量，用于在每次循环中代表一个配置项。
• {field.varname}：代表当前配置项的名称。
• {field.value}：代表当前配置项的值。

这种形式在开发中较少直接使用,但有助于理解数据结构。

常用内置全局变量（name值）

DedeCMS 在安装时会自动创建很多常用的全局配置，以下是一些最常用、最核心的 name 值及其说明：

实际应用示例

假设你的 DedeCMS 后台设置了以下信息：

• 网站名称：我的个人博客
• 网站网址：https://www.myblog.com
• 版权信息：Copyright © 2025 我的个人博客 All Rights Reserved.
• 备案号：京ICP备12345678号

示例 1：在网站页眉显示网站名称和Logo

在 head 区域或页面顶部，使用 cfg_webname 和 cfg_weburl 来构建Logo链接。

<!-- 在 header.htm 或类似文件中 -->
<a href="{dede:global.cfg_indexurl/}" title="{dede:global.cfg_webname/}">
    <img src="{dede:global.cfg_templeturl/}/images/logo.png" alt="{dede:global.cfg_webname/}" />
</a>

示例 2：在网站页脚显示版权和备案信息

这是最常见的用法,通常在 footer.htm 文件中。

<!-- 在 footer.htm 或类似文件中 -->
<div class="footer">
    <p>{dede:global.cfg_powerby/}</p>
    <p><a href="http://beian.miit.gov.cn/" target="_blank">{dede:global.cfg_beian/}</a></p>
</div>

示例 3：在页面中调用CSS和JS文件（推荐做法）

为了确保路径正确,强烈建议使用 cfg_templeturl 来调用模板内的资源。

<!-- 在 head.htm 中调用模板目录下的 style.css -->
<link rel="stylesheet" href="{dede:global.cfg_templeturl/}/css/style.css" />
<!-- 在 body 底部调用模板目录下的 main.js -->
<script src="{dede:global.cfg_templeturl/}/js/main.js"></script>

示例 4：在内容页面包屑导航中使用首页链接

页,面包屑导航通常需要“首页 > 栏目 > 文章标题”的结构。

<!-- 在 article_article.htm 中 -->
<div class="breadcrumb">
    <a href="{dede:global.cfg_indexurl/}">首页</a> &gt;
    <a href="{dede:type typeid='0'/}">{dede:field.typename/}</a> &gt;
    <span>{dede:field.title/}</span>
</div>

如何自定义和使用新的全局变量？

DedeCMS 自带的变量不够用，你可能需要添加自己的全局配置。

步骤 1：进入后台设置

1. 登录 DedeCMS 后台。
2. 在左侧菜单栏找到 【系统】 -> 【系统基本参数】 -> 【核心设置】。

步骤 2：添加新变量

1. 在“核心设置”页面，你会看到一个参数列表。
2. 滚动到页面底部,找到 【添加新变量】 的表单。
3. 填写表单：
   • 变量名称： 填入一个英文的、唯一的名称，cfg_my_custom_text。
   • 变量类型： 根据需要选择，如“文本”、“文本域”、“数字”等。
   • 所属组： 选择“核心设置”或其他你自定义的组。
   • 变量值： 填入你想要设置的默认值，欢迎访问我的网站！”。
   • 备注说明： 填入对该变量的描述，首页欢迎语”。
4. 点击 【保存】 按钮。

步骤 3：在模板中调用

你就可以像使用内置变量一样,在你的模板文件中调用这个新变量了。

<!-- 在首页 index.htm 中 -->
<div class="welcome-banner">
    <h1>{dede:global.cfg_my_custom_text/}</h1>
</div>

注意事项

1. 名称区分大小写： {dede:global.cfg_webname/} 和 {dede:global.cfg_Webname/} 是不同的，务必使用数据库中 varname 字段的确切值。
2. 缓存问题： 修改系统基本参数后，DedeCMS 会生成缓存，如果前台页面没有立即更新，可以尝试清除缓存（后台有清除缓存按钮）或刷新页面。
3. 安全性： 不要在全局变量中存储敏感信息（如数据库密码、API密钥等）。
4. 与 {dede:global name='cfg_XXX'/} 的区别：在某些旧版或特定文档中，你可能看到 {dede:global name='cfg_webname'/} 这种写法。这和 {dede:global.cfg_webname/} 是完全等价的，只是写法不同，前者更明确地指明了 name 属性，后者是一种简写，两者都可以使用。

{dede:global} 标签是 DedeCMS 模板开发的基石，熟练掌握它，意味着你可以轻松地管理网站的全局信息，如名称、URL、版权等，并确保网站在不同环境（如本地、测试服务器、生产服务器）下都能通过修改后台配置来正常工作，而无需改动模板代码。