- 使用DedeCMS自带的幻灯片功能:这是最简单、最推荐的方法,适合新手和大多数常规需求。
- 使用第三方幻灯片插件:功能更强大,样式更多样,但需要一定的安装和配置能力。
下面我将详细介绍这两种方法。

(图片来源网络,侵删)
使用DedeCMS自带的幻灯片功能(推荐)
DedeCMS内置了一个非常方便的幻灯片模块,我们只需要进行简单的配置即可使用。
第一步:创建幻灯片栏目
需要放在一个专门的栏目里,这样才能被调用。
- 登录你的DedeCMS后台。
- 在左侧菜单栏中,找到 【栏目】 -> 【添加栏目】。
- 在添加栏目页面,填写以下信息:
- 栏目名称:首页幻灯片”或“焦点图片”,这个名称只是为了方便你管理,不会在前台显示。
- 栏目类型:选择 【外部栏目】,这一点非常重要!选择外部栏目意味着这个栏目下的内容不会生成独立的列表页,只会被调用。
- 栏目目录:可以自定义一个英文名称,如
focus或slide。 - 其他选项:保持默认即可。
- 点击 【确定】 保存。
第二步:在幻灯片栏目中添加内容
我们刚刚创建的“首页幻灯片”栏目是空的,需要向里面添加图片和链接。
- 在后台菜单栏中,找到 【核心】 -> 发布】 -> 【添加文档】。
- 在顶部的“选择栏目”下拉菜单中,选择你刚刚创建的 “首页幻灯片” 栏目。
- 填写文档内容:
- 可以填写图片的描述文字,如“产品展示1”。
- 缩略图:这是最关键的一步!点击 【上传新的图片】 或直接拖拽图片到上传区域,选择你想要作为幻灯片的图片,上传成功后,图片地址会自动填入。
- :可以填写详细描述,也可以留空。
- 自定义属性:如果需要在幻灯片上显示链接,可以在这里设置。
- 点击 【自定义属性】,勾选 【跳转网页】。
- 在后面的输入框中,输入你想要跳转的网址,
https://www.example.com/product1。
- 点击 【保存】 或 【保存发布】。
重复此步骤,添加多张幻灯片图片,再添加“产品展示2”、“产品展示3”等。

(图片来源网络,侵删)
第三步:在首页模板中调用幻灯片
已经准备好了,现在需要在前台首页模板文件中,通过代码将它们调用出来。
- 找到你的首页模板文件,通常位于
templets/目录下,文件名可能是index.htm。 - 使用记事本或其他代码编辑器打开
index.htm文件。 - 在你希望幻灯片出现的位置(通常是页面顶部最显眼的地方),插入以下调用代码:
<!-- 调用ID为1的幻灯片,图片宽度为770,高度为300,显示标题和文字说明 -->
{dede:arclist typeid='1' row='5' titlelen='30'}
<li><a href="[field:link/]" target="_blank"><img src="[field:litpic/]" alt="[field:title/]" width="770" height="300"/></a></li>
{/dede:arclist}
代码解释:
{dede:arclist ...}:这是DedeCMS调用文档列表的标签。typeid='1':这是最重要的参数!'1'是你第一步创建的“首页幻灯片”栏目的 ID,你可以在后台【栏目管理】中,将鼠标悬停在该栏目上,浏览器左下角状态栏会显示...&cid=1,这个1就是它的ID。请务必修改成你自己的栏目ID!row='5':表示调用5条内容,也就是5张幻灯片,你可以根据需要修改,len='30'`:标题长度限制。[field:link/]:调用文章设置的跳转链接(如果设置了的话)。[field:litpic/]:调用文章的缩略图,也就是我们上传的幻灯片图片。width="770" height="300":设置图片的显示宽度和高度。请根据你的网站布局修改成合适的尺寸,否则图片可能会被拉伸或压缩。
第四步:添加必要的CSS和JavaScript
仅仅有HTML是不够的,还需要CSS来美化样式,以及JavaScript来实现自动轮播效果。
- CSS样式:在你的首页模板文件
<head>标签内,或者引入一个外部CSS文件的地方,添加以下样式代码(你可以根据自己网站的样式进行调整):
/* 幻灯片容器样式 */
.slide-box {
width: 770px; /* 与图片宽度一致 */
height: 300px; /* 与图片高度一致 */
margin: 0 auto;
position: relative;
overflow: hidden;
}
.slide-box ul {
list-style: none;
padding: 0;
margin: 0;
}
.slide-box ul li {
display: none; /* 默认隐藏所有图片 */
}
.slide-box ul li.active {
display: block; /* 显示当前活动的图片 */
}
/* 可以添加切换按钮、指示器等样式 */
- JavaScript脚本:在页面底部
</body>标签之前,添加以下JavaScript代码来实现轮播效果,这里提供一个简单的自动轮播示例:
<script>
document.addEventListener('DOMContentLoaded', function() {
var slides = document.querySelectorAll('.slide-box ul li');
var currentIndex = 0;
function showSlide(index) {
// 隐藏所有图片
slides.forEach(function(slide) {
slide.classList.remove('active');
});
// 显示当前图片
if (slides[index]) {
slides[index].classList.add('active');
}
}
function nextSlide() {
currentIndex++;
if (currentIndex >= slides.length) {
currentIndex = 0;
}
showSlide(currentIndex);
}
// 显示第一张图片
showSlide(currentIndex);
// 设置定时器,每隔3秒切换一次
setInterval(nextSlide, 3000);
});
</script>
最终模板结构示例:

(图片来源网络,侵删)
<head>
...其他head内容...
<style>
/* 这里粘贴上面的CSS代码 */
</style>
</head>
<body>
...网站其他内容...
<!-- 幻灯片HTML部分 -->
<div class="slide-box">
<ul>
{dede:arclist typeid='1' row='5'}
<li><a href="[field:link/]" target="_blank"><img src="[field:litpic/]" alt="[field:title/]" width="770" height="300"/></a></li>
{/dede:arclist}
</ul>
</div>
...网站其他内容...
<script>
// 这里粘贴上面的JavaScript代码
</script>
</body>
</html>
完成以上步骤后,保存模板文件,然后到后台 【生成】 -> 【一键更新网站】 -> 【更新首页】,刷新你的网站首页,幻灯片就应该可以正常工作了。
使用第三方幻灯片插件
如果你觉得自带的幻灯片功能样式单一,或者需要更复杂的效果(如带缩略图导航、多种切换动画等),可以使用第三方插件。
基本流程:
- 寻找插件:去DedeCMS的官方论坛、插件市场或一些知名的DedeCMS资源网站搜索“幻灯片插件”或“焦点图插件”。
dedecms幻灯片插件、dedecms banner插件等。 - 下载插件:下载插件包,通常是一个
.zip文件。 - 上传安装:
- 解压插件包。
- 将解压后的文件夹通过FTP上传到你的DedeCMS网站根目录下的
/include/或/dede/目录中(具体看插件说明)。 - 登录DedeCMS后台,找到 【模块】 -> 【模块管理】 或 【系统】 -> 【插件管理】,点击 【上传新模块】 或 【安装模块】,上传插件包中的
install.php文件,根据向导完成安装。
- 配置插件:安装成功后,插件通常会在后台生成一个配置菜单,进入菜单,按照说明进行配置,比如选择调用栏目、设置图片尺寸、调整样式等。
- 调用代码:插件官方会提供调用代码,通常是
{dede:plugin ...}这样的标签,你只需要将这段代码复制到你的首页模板index.htm的相应位置即可。
优点:
- 功能强大,样式丰富。
- 通常有详细的使用文档。
缺点:
- 需要额外寻找和安装插件,有一定门槛。
- 插件可能与你的DedeCMS版本不兼容,或与其他插件产生冲突。
- 对于初学者和快速搭建,强烈推荐 方法一,DedeCMS自带的功能已经足够满足大部分需求,且稳定可靠。
- 对于追求丰富效果和个性化,可以考虑 方法二,但需要花时间研究和测试。
希望这个详细的教程能帮助你成功在DedeCMS中添加幻灯片!
