"Dede include" 是指在 DedeCMS 网站中,使用 {dede:include} 这个标签来引入或包含其他文件内容的一种技术。

这就像是在写文章时,把另一篇文章或者一段标准化的文字直接“引用”过来,而不是重复打字。
详细解释
它是什么?
{dede:include} 是 DedeCMS 模板引擎内置的一个功能标签,它的核心作用是:在模板文件的指定位置,插入并执行另一个文件的内容。
这个被包含的文件可以是一个独立的 HTML 片段、一个 PHP 文件,甚至是另一个 DedeCMS 的模板文件。
为什么需要它?(主要用途)
使用 include 的主要目的是为了提高代码的复用性和网站的可维护性,在网站开发中,很多页面的部分内容是重复的,

- 网站头部:通常包含 Logo、主导航菜单、搜索框等。
- 网站底部:通常包含版权信息、备案号、友情链接等。
- 侧边栏:包含热门文章、最新评论、标签云等。
- 通用广告位:一个固定的广告图片或代码。
如果不使用 include,你需要在网站的每一个页面(首页、列表页、内容页等)都把这些重复的代码完整地写一遍,这样做的缺点非常明显:
- 维护困难:如果网站头部的导航需要增加一个新链接,你必须修改网站的每一个页面,工作量巨大且容易遗漏。
- 代码冗余:网站中存在大量重复代码,使得文件变得臃肿,不利于管理和阅读。
而使用 {dede:include},你可以把这些公共部分(如头部、底部)做成独立的文件(如 header.htm, footer.htm),然后在所有需要它们的页面中,用一个简单的标签 {dede:include file='header.htm' /} 来引用。
这样一来,维护工作就变得极其简单: 当你需要修改网站头部时,只需要修改 header.htm 这一个文件,所有引用了它的页面都会自动更新。
如何使用?(语法和示例)
{dede:include} 标签的基本语法如下:

{dede:include file='文件路径' [ismake='是否重新编译'] [virtual='是否虚拟路径'] /}
常用参数说明:
file(必需): 指定要包含的文件路径,这个路径是相对于 DedeCMS 根目录下的templets文件夹的。file='default/header.htm'表示包含templets/default/目录下的header.htm文件。
ismake(可选): 是否重新编译,默认为0,通常情况下不需要修改。virtual(可选): 是否使用虚拟路径,默认为0,通常情况下不需要修改。
实际应用场景举例
假设你的 DedeCMS 网站模板结构如下:
/templets/
/default/
index.htm (首页模板)
article_list.htm (列表页模板)
article_article.htm (内容页模板)
header.htm (网站头部文件)
footer.htm (网站底部文件)
步骤 1:创建公共文件
- 创建
header.htm,里面写好网站头部的 HTML 代码。 - 创建
footer.htm,里面写好网站底部的 HTML 代码。
步骤 2:在模板中引用
在 index.htm (首页模板) 中:
<!DOCTYPE html>
<html>
<head>{dede:global.cfg_webname/}</title>
</head>
<body>
<!-- 使用 include 引入头部文件 -->
{dede:include file='default/header.htm' /}
<div class="main-content">
<!-- 这里是首页的主体内容,比如调用文章列表 {dede:arclist}...{/dede:arclist} -->
<h1>欢迎来到首页</h1>
<!-- ... 更多内容 ... -->
</div>
<!-- 使用 include 引入底部文件 -->
{dede:include file='default/footer.htm' /}
</body>
</html>
在 article_list.htm (列表页模板) 中:
<!DOCTYPE html>
<html>
<head>{dede:field.title/} - {dede:global.cfg_webname/}</title>
</head>
<body>
<!-- 同样引入头部文件 -->
{dede:include file='default/header.htm' /}
<div class="main-content">
<!-- 这里是列表页的主体内容,比如调用栏目文章列表 {dede:list}...{/dede:list} -->
<h1>{dede:field.typename/}</h1>
<!-- ... 更多内容 ... -->
</div>
<!-- 同样引入底部文件 -->
{dede:include file='default/footer.htm' /}
</body>
</html>
通过这种方式,header.htm 和 footer.htm 的内容就被成功地“嵌入”到了首页和列表页中。
与 PHP include 的区别
-
Dede
{dede:include}:- 是 DedeCMS 模板引擎的一部分。
- 在模板文件中使用,语法为
{dede:include file='...' /}。 - 主要作用是引入模板片段(HTML),便于页面布局和模块化。
- 它的执行是在 DedeCMS 解析模板、生成静态页面(或动态页面)时由 DedeCMS 程序完成的。
-
PHP
include/require:- 是 PHP 语言本身的核心语法。
- 在 PHP 代码文件(
.php)中使用,语法为include('file.php');。 - 主要作用是引入并执行 PHP 代码文件,可以包含变量、函数、类等逻辑。
- 它的执行是由 PHP 解释器在服务器端完成的。
你可以将 DedeCMS 模板想象成一个“装修图纸”,{dede:include} 是图纸上用来“粘贴”标准模块(如门窗)的标记,而 PHP include 则是施工队(PHP 代码)在建造房屋时,去调用另一个工段的成品(如预制的楼梯)。
Dede include ({dede:include}) 是 DedeCMS 中一个用于模块化和复用代码的核心标签,它允许开发者将网站中重复出现的部分(如头部、底部、侧边栏)拆分成独立的文件,然后在各个页面模板中通过一个简单的标签来引用,从而极大地提高了网站的开发效率和后期维护的便利性。
