DedeCMS 作为国内曾经非常流行的内容管理系统,其 WAP(手机网站)功能是其一个重要的组成部分,下面我将从 工作原理、模板制作、移动端适配、常见问题 等几个方面为您进行全面讲解。

(图片来源网络,侵删)
DedeCMS WAP 模板的工作原理
DedeCMS 的 WAP 功能核心在于 “自动适配” 和 “模板分离”。
-
自动适配机制:
- 当一个用户访问您的网站时,DedeCMS 的
index.php入口文件会首先检测用户的浏览器 User-Agent 字符串。 - User-Agent 是浏览器发送给服务器的信息,包含了操作系统、浏览器类型、设备型号等,iPhone、Android、Mobile 等关键词都表明是移动设备。
- 如果系统检测到是移动设备,它会自动加载
/m/目录下的模板文件,而不是默认的 PC 端模板。 - 这个过程对用户是透明的,用户访问的是同一个域名(如
www.yourdomain.com),但看到的是不同的界面。
- 当一个用户访问您的网站时,DedeCMS 的
-
模板文件结构:
- PC 端模板:存放在
/templets/default/目录下。 - WAP 端模板:存放在
/templets/目录下的一个子目录,通常是/templets/wap/或/templets/mobile/,目录名可以自定义,但需要在后台配置。 - 核心文件:
/include/目录下的dedemobile.class.php文件是处理移动端适配的核心类。
- PC 端模板:存放在
如何制作或修改 DedeCMS WAP 模板
制作 DedeCMS WAP 模板与制作 PC 模板类似,都遵循 DedeCMS 的模板标签规范,但需要遵循移动端的设计原则。

(图片来源网络,侵删)
准备工作
- 创建模板目录:在
/templets/目录下新建一个文件夹,例如命名为mobile。 - 启用 WAP 功能:
- 登录 DedeCMS 后台。
- 进入【系统】->【系统基本参数】->【核心设置】。
- 找到 “是否开启 WAP 浏览” 选项,选择 “是”。
- 找到 “WAP 模板目录” 选项,填写您刚才创建的目录名,
mobile。 - 保存设置。
模板文件列表
一个典型的 WAP 模板文件夹 (/templets/mobile/) 应该包含以下文件:
index.html:WAP 首页模板。list_article.html:文章列表页模板。article_article.html页模板。index_default.htm:有些老版本 DedeCMS 使用这个作为首页,但index.html更通用。head.htm:页面头部公共部分(如 logo、导航)。footer.htm:页面底部公共部分(如版权、友情链接)。style.css:WAP 端的样式表文件。
模板制作要点与常用标签
核心原则:简洁、快速、易读
- HTML 结构:使用 HTML5 语义化标签(如
<header>,<nav>,<article>,<footer>),代码尽量简洁。 - CSS 样式:
- 响应式设计(推荐):使用
viewport标签和相对单位(,rem,vw/vh)来适配不同屏幕尺寸。 - 固定宽度:简单粗暴地设置一个固定宽度(如 320px, 375px),确保在所有手机上都能完整显示,但体验稍差。
- 避免复杂布局:尽量使用单列布局,避免复杂的浮动和定位。
- 响应式设计(推荐):使用
常用 DedeCMS 标签(与 PC 端基本一致)
| 功能 | 标签代码 | 说明 |
|---|---|---|
| 网站名称 | {dede:global.cfg_webname/} |
显示后台设置的网站名称 |
| 网站Logo | <img src="{dede:global.cfg_cmsurl/}/templets/mobile/images/logo.png" /> |
建议使用绝对路径 |
| 栏目导航 | {dede:channel type='top' row='10'}<a href='[field:typelink/]'>[field:typename/]</a>{/dede:channel} |
调用顶级栏目 |
| 文章列表 | {dede:list pagesize='10'}<a href='[field:arcurl/]'>[field:title/]</a><br/>{/dede:list} |
调用指定数量的文章列表 |
| 文章分页 | {dede:pagelist listsize='4' listitem='info,index,end,pre,next,pageno'} |
文章列表页的分页条 |
{dede:field.title/}{dede:field.body/} |
页调用文章标题和正文 | |
| 文章页分页 | {dede:pagebreak/} |
在长文章内容中显示分页符 |
示例:简单的 WAP 首页 (index.html) 代码

(图片来源网络,侵删)
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">{dede:global.cfg_webname/}</title>
<!-- 这行是移动端适配的关键! -->
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
<link rel="stylesheet" type="text/css" href="{dede:global.cfg_cmsurl/}/templets/mobile/style.css">
</head>
<body>
<header>
<a href="{dede:global.cfg_cmsurl/}/"><img src="{dede:global.cfg_cmsurl/}/templets/mobile/images/logo.png" alt="Logo"></a>
</header>
<nav>
{dede:channel type='top' row='8'}
<a href="[field:typelink/]">[field:typename/]</a>
{/dede:channel}
</nav>
<main>
<h2>最新文章</h2>
{dede:list pagesize='10'}
<div class="list-item">
<a href="[field:arcurl/]">[field:title/]</a>
<span class="date">[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
</div>
{/dede:list}
<div class="pagination">
{dede:pagelist listsize='4' listitem='info,index,end,pre,next,pageno'}
{/dede:pagelist}
</div>
</main>
<footer>
<p>Copyright © {dede:global.cfg_webname/} All Rights Reserved.</p>
</footer>
</body>
</html>
现代移动端适配方案(推荐)
虽然 DedeCMS 自带的 WAP 功能可以工作,但它通常被视为一种 “移动适配” 而非 “移动优先” 的方案,在现代 Web 开发中,更推荐使用 响应式设计。
PC 端模板响应式化(最推荐)
这是目前最主流、最灵活的方案,你只需要维护一套模板,通过 CSS 让它同时适配 PC 和手机。
-
修改 PC 端模板:
- 在
<head>部分添加viewport- 重写 CSS,使用媒体查询 (
@media) 为不同屏幕尺寸定义样式。 - 重写 CSS,使用媒体查询 (
- 在
-
示例 CSS (
style.css)
/* 默认样式(针对手机) */
body { font-size: 16px; }
.header { width: 100%; }
.nav a { display: block; width: 25%; text-align: center; }
.list-item { padding: 10px; border-bottom: 1px solid #eee; }
/* 当屏幕宽度大于 768px 时(平板/PC) */
@media (min-width: 768px) {
body { font-size: 18px; }
.nav a { display: inline-block; width: auto; margin: 0 15px; }
.list-item { display: flex; justify-content: space-between; }
.date { margin-left: auto; }
}
优点:
- 一套代码,多端适配,维护成本低。
- 用户体验更好,URL 不变,利于 SEO。
- 符合现代 Web 开发趋势。
缺点:
- 对 CSS 技术要求稍高。
- 首次加载时可能加载了 PC 端不需要的样式和图片(可通过响应式图片优化)。
使用独立的移动域名(如 m.yourdomain.com)
这是 DedeCMS WAP 模板的经典用法。
- 设置 WAP 模板目录:如前所述,在后台设置 WAP 模板目录为
mobile。 - 配置服务器:确保服务器能正确解析
/m/路径,DedeCMS 的index.php已经处理好了,无需额外配置。 - 制作独立的 WAP 模板:完全独立于 PC 端,制作一套适合手机浏览的模板。
优点:
- 可以针对手机做极致优化,代码和资源更轻量。
- 可以针对移动端做特殊的 SEO 配置(如不同的标题、描述)。
缺点:
- 需要维护两套模板,增加了开发成本,需要同步更新(DedeCMS 默认会同步,但模板是独立的)。
- 不利于 SEO,搜索引擎需要处理两个版本的内容。
常见问题与解决方案
-
问题:手机访问网站还是 PC 版页面。
- 原因:WAP 功能未开启,或模板目录路径错误。
- 解决:检查后台【系统基本参数】中的 “是否开启 WAP 浏览” 和 “WAP 模板目录” 设置是否正确,确保
/templets/下存在你设置的目录。
-
问题:WAP 模板样式错乱,图片过大。
- 原因:缺少
viewport标签,或者 CSS 没有做移动端适配。 - 解决:
- 在 WAP 模板的
<head>中加入<meta name="viewport" content="width=device-width, initial-scale=1.0">。 - 在 CSS 中为图片设置
max-width: 100%; height: auto;,防止图片撑破容器。
- 在 WAP 模板的
- 原因:缺少
-
问题:WAP 站点无法登录后台。
- 原因:DedeCMS 后台默认可能没有针对移动端做优化。
- 解决:
- 方案 A(推荐):使用响应式方案,让 PC 端后台也能在手机上正常使用。
- 方案 B:在 WAP 模板目录下也复制一份登录模板
login.htm,并对其进行移动端优化。
-
问题:DedeCMS WAP 功能是否还值得使用?
- 对于新项目,不推荐直接使用 DedeCMS 原生的 WAP 功能,更推荐采用 “响应式设计” 方案(方案一)。
- 理由:技术趋势已经从“移动适配”转向“响应式”和“移动优先”,响应式方案更灵活、更易于维护,是更现代的选择。
资源与下载
如果您不想自己从头制作,可以在网上找到很多 DedeCMS 的 WAP 模板资源。
- 资源网站:
- 织梦官方论坛:http://bbs.dedecms.com/ (可以找到一些用户分享的模板)
- 模板下载站:如“织梦模板吧”、“站长素材”等网站搜索“DedeCMS WAP模板”或“织梦手机模板”。
- 注意事项:
- 下载的模板可能存在安全漏洞或代码冗余,使用前最好进行安全检查和代码优化。
- 注意模板的版本兼容性,确保与你安装的 DedeCMS 版本匹配。
| 特性 | DedeCMS 原生 WAP 模板 | 响应式模板 (推荐) |
|---|---|---|
| 实现方式 | 检测 UA,加载独立 /m/ 目录模板 |
一套模板,通过 CSS 媒体查询适配 |
| 维护成本 | 高(需维护两套模板) | 低(只需维护一套模板) |
| 用户体验 | 一般,URL 可能会变 | 优秀,URL 统一,体验流畅 |
| SEO | 较复杂,需处理双版本 | 更友好,URL 权重集中 |
| 技术趋势 | 已经过时 | 主流、现代、推荐 |
希望这份详细的指南能帮助您更好地理解和使用 DedeCMS 的 WAP 模板功能!
