使用织梦自带功能(最简单,推荐新手)
织梦DedeCMS在V5.7版本之后,后台就有了“首页二维码”的功能,这是最简单、最官方的方法。

操作步骤:
-
登录织梦后台:使用你的管理员账号登录
您的域名/dede/。 -
进入基本参数设置:在左侧菜单栏中找到 “系统” -> “系统基本参数”。
-
找到首页二维码设置:
(图片来源网络,侵删)- 在“系统基本参数”页面,点击顶部的 “核心设置” 选项卡。
- 在设置列表中,找到 “首页二维码” 这一项。
- 点击 “文件式” 后面的 “修改” 按钮。
-
上传二维码图片:
- 在弹出的窗口中,点击 “浏览” 按钮,选择你提前准备好的二维码图片(通常是正方形的PNG或JPG格式)。
- 选择图片后,点击 “上传” 和 “确定”。
-
更新首页:
- 设置完成后,返回后台首页。
- 点击 “生成” -> “更新主页HTML”,确保首页被重新生成。
如何在前端显示?
完成上述步骤后,织梦系统会在你的模板目录下生成一个二维码文件,但默认情况下,它不会自动显示在首页,你需要在首页模板文件中手动调用它。

-
找到首页模板文件:登录你的FTP或主机文件管理器,进入
/templets/default/目录(如果你使用的是默认模板),找到index.htm文件,如果你修改过模板,请找到你正在使用的模板目录下的首页文件。 -
添加调用代码:在你想要显示二维码的位置(页脚
footer区域),插入以下代码:<a href="{dede:global.cfg_basehost/}" title="欢迎访问{dede:global.cfg_webname/}"> <img src="{dede:global.cfg_cmsurl/}/images/qrcode.png" alt="首页二维码" /> </a>- 代码解释:
{dede:global.cfg_cmsurl/}:这是织梦的全局变量,代表你的网站根目录,通常是http://你的域名。/images/qrcode.png:这是上传的二维码图片存放的默认路径。如果你的图片没有出现在这个位置,请检查你在“核心设置”里上传后,系统实际把图片放到了哪里,并相应地修改路径。alt="首页二维码":这是图片的替代文本,对SEO和用户体验友好。
- 代码解释:
手动上传并调用(灵活度高)
如果你不想使用后台功能,或者后台功能不满足你的需求(比如想显示不同位置的二维码),可以采用手动方式。
操作步骤:
-
准备二维码图片:用任何二维码生成工具(在线搜索“二维码生成器”即可)生成你的网站首页二维码图片。
-
上传图片到服务器:
- 通过FTP或主机文件管理器,登录你的网站。
- 进入网站的
images目录(或你自定义的存放图片的目录,如/templets/你的模板/images/)。 - 将准备好的二维码图片上传到此目录,并命名为有意义的名字,
home_qrcode.png。
-
在首页模板中插入代码:
- 打开你的首页模板文件(如
/templets/default/index.htm)。 - 在合适的位置(页脚、侧边栏)插入以下HTML代码:
<!-- 方式一:直接显示图片 --> <img src="/images/home_qrcode.png" alt="扫码访问{dede:global.cfg_webname/}" /> <!-- 方式二:用链接包裹图片,点击可跳转到首页 --> <a href="{dede:global.cfg_basehost/}"> <img src="/images/home_qrcode.png" alt="扫码访问{dede:global.cfg_webname/}" /> </a> - 打开你的首页模板文件(如
-
更新首页:回到织梦后台,点击 “生成” -> “更新主页HTML”,让修改生效。
动态生成二维码(无需上传图片,最专业)
这种方法非常灵活,二维码内容可以动态变化(比如加上推广渠道参数),且无需手动上传图片,这需要用到PHP库,这里我们推荐使用 Endroid/QrCode,这是一个非常流行的PHP二维码生成库。
操作步骤:
-
安装二维码库:
- 通过SSH连接你的服务器(或使用宝塔面板的“文件管理器”中的“终端”),进入你的网站根目录。
- 执行以下命令来安装这个库(需要你的服务器已安装Composer):
composer require endroid/qr-code
- 如果你的服务器没有安装Composer,可以手动下载库文件并放到合适位置,但使用Composer是最简单的方式。
-
创建一个生成二维码的PHP文件:
- 在网站根目录下新建一个文件,命名为
qrcode.php。 - 将以下代码复制到
qrcode.php文件中:
<?php // 引入织梦的公共文件,以使用织梦的全局变量和函数 define('DEDEADMIN', ereg_replace("[/\\]{1,}", '/', dirname(__FILE__) ) ); require_once(DEDEADMIN.'/../include/common.inc.php'); // 引入刚安装的QRCode库的自动加载文件 // 根据你的Composer安装路径,这个文件可能在 vendor/autoload.php require_once __DIR__ . '/vendor/autoload.php'; use Endroid\QrCode\Builder\Builder; use Endroid\QrCode\Encoding\Encoding; use Endroid\QrCode\ErrorCorrectionLevel\ErrorCorrectionLevelHigh; use Endroid\QrCode\RoundBlockSizeMode\RoundBlockSizeModeMargin; use Endroid\QrCode\Writer\PngWriter; // 定义要生成的二维码内容 // 这里以首页链接为例,你也可以加上参数,如 ?source=footer $qrContent = $cfg_basehost; // 生成二维码 $result = Builder::create() ->writer(new PngWriter()) ->writerOptions([]) ->data($qrContent) ->encoding(new Encoding('UTF-8')) ->errorCorrectionLevel(new ErrorCorrectionLevelHigh()) ->size(150) // 设置二维码大小 ->margin(10) // 设置外边距 ->roundBlockSizeMode(new RoundBlockSizeModeMargin()) ->build(); // 设置HTTP头,告诉浏览器这是一个PNG图片 header('Content-Type: '.$result->getMimeType()); // 直接输出图片内容 echo $result->getString(); - 在网站根目录下新建一个文件,命名为
-
在首页模板中调用这个PHP文件:
- 打开你的首页模板文件(如
/templets/default/index.htm)。 - 在需要显示二维码的地方,直接使用
<img>标签的src属性指向这个PHP文件:
<!-- 直接显示动态生成的二维码 --> <img src="/qrcode.php" alt="动态首页二维码" /> <!-- 或者用链接包裹 --> <a href="{dede:global.cfg_basehost/}"> <img src="/qrcode.php" alt="动态首页二维码" /> </a> - 打开你的首页模板文件(如
-
更新首页:回到织梦后台,点击 “生成” -> “更新主页HTML”。
优点:
- 内容可变:你可以轻松修改
$qrContent的值来生成不同内容的二维码,比如活动页、带推广码的链接等。 - 无需维护图片:代码即内容,不需要手动上传和管理图片文件。
- 样式可控:可以轻松调整二维码的大小、颜色、容错级别等。
总结与建议
| 方法 | 优点 | 缺点 | 适用人群 |
|---|---|---|---|
| 后台自带 | 操作最简单,官方支持,无需代码。 | 路径固定,灵活性差,需要手动修改模板才能显示。 | 新手用户,追求快速上手。 |
| 手动上传 | 简单直观,灵活性高,不依赖后台功能。 | 需要手动管理图片,每次更换二维码都要上传新文件。 | 大多数用户,特别是对二维码样式有特定要求的。 |
| 动态生成 | 最灵活可动态变化,无需维护图片,专业。 | 需要服务器支持Composer,操作稍复杂,涉及PHP代码。 | 开发者,有技术能力,需要实现复杂功能(如带参数的推广码)。 |
对于绝大多数站长来说,方法二(手动上传并调用) 是性价比和易用性最高的选择,如果你是纯新手,可以从方法一开始尝试,如果发现不满足需求,再切换到方法二。
