萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

DEDECMS 首页/列表页/内容页调用图片集多张图片:自定义函数 Getimg() 完整实现

核心思路

DEDECMS 图片集模型将多张图片存储在 dede_addonimages 表的 imgurls 字段中,格式为序列化字符串。通过自定义函数 Getimg() 解析该字段,提取图片 URL 并生成 HTML 结构。

第一步:注册自定义函数

文件:include/common.inc.php (或 include/extend.func.php 推荐)

<?php
/**
 * 调用图片集多张图片
 * @param int $aid 文档 ID
 * @param int $imgwidth 图片宽度
 * @param int $imgheight 图片高度
 * @param int $limit 限制张数,0 为全部
 * @return string HTML 片段
 */
function Getimg($aid, $imgwidth = 110, $imgheight = 110, $limit = 0) {
    global $dsql;

    // 1. 查询 imgurls 字段
    $row = $dsql->GetOne("SELECT imgurls FROM `#@__addonimages` WHERE aid = '$aid'");
    if (!$row || empty($row['imgurls'])) return '';

    $imgurls = $row['imgurls'];

    // 2. 正则提取图片 URL (兼容多种格式)
    // 典型格式: {dede:img ddimg='xxx.jpg' text=''}xxx.jpg{/dede:img}
    preg_match_all("/\{dede:img[^}]*ddimg=['\"]([^'\"]+)['\"][^}]*\}([^\{]+)\{\/dede:img\}/is", $imgurls, $matches);
    // $matches[1] 为图片 URL, $matches[2] 为 alt 文本

    if (empty($matches[1])) return '';

    $urls = $matches[1];
    $alts = $matches[2] ?? [];

    // 3. 限制张数
    if ($limit > 0 && count($urls) > $limit) {
        $urls = array_slice($urls, 0, $limit);
        $alts = array_slice($alts, 0, $limit);
    }

    // 4. 生成 HTML:大图 + 缩略图列表 (兼容常见相册 JS 插件)
    $html = '<dl class="img-gallery">';
    $html .= '<dt><img id="imgInit" src="' . $urls[0] . '" width="' . $imgwidth . '" height="' . $imgheight . '" alt="' . ($alts[0] ?? '') . '"></dt>';
    $html .= '<dd><ul>';
    foreach ($urls as $i => $url) {
        $alt = $alts[$i] ?? '';
        $html .= '<li><img src="' . $url . '" width="' . $imgwidth . '" height="' . $imgheight . '" alt="' . $alt . '" data-big="' . $url . '"></li>';
    }
    $html .= '</ul></dd></dl>';

    return $html;
}

第二步:模板标签调用

1. 首页/列表页 (arclist/list 标签)

{dede:arclist row='10' typeid='5'}
    [field:title /]
    [field:id function="Getimg(@me, 200, 150, 5)" /]
{/dede:arclist}

{dede:list pagesize='10'}
    [field:title /]
    [field:id function="Getimg(@me, 200, 150, 5)" /]
{/dede:list}

2. 内容页 (field 标签)

{dede:field.id function="Getimg(@me, 400, 300, 0)" /}

参数说明

  • @me 代表当前字段值 (即文档 ID)
  • 200, 150:缩略图宽高
  • 5:最多显示 5 张,0 显示全部

进阶:支持多图片集栏目

若同一栏目下有多个图片集模型,需在 SQL 中加 typeid 过滤:

function Getimg($aid, $imgwidth = 110, $imgheight = 110, $limit = 0, $typeid = 0) {
    global $dsql;
    $sql = "SELECT imgurls FROM `#@__addonimages` WHERE aid = '$aid'";
    if ($typeid) $sql .= " AND typeid = '$typeid'";
    // ... 后续相同
}

调用:[field:id function="Getimg(@me, 200, 150, 5, 8)" /] (8 为图片集栏目 typeid)

常见问题排查

Q: 输出为空?
1. 确认文档模型为“图片集”
2. 检查 dede_addonimages 表是否有对应 aid 记录
3. 打印 $imgurls 确认格式,正则可能需调整
Q: 图片路径不显示?
检查 ddimg 值是相对路径还是绝对 URL,必要时拼接 $GLOBALS['cfg_basehost']
Q: 缩略图变形?
去掉宽高属性,用 CSS object-fit: cover 控制
Q: 编辑器上传图片后格式变了?
DEDE 版本不同 imgurls 格式可能差异,需实测调整正则

现代化改造建议

  • 改用 json_decode 解析 (新版 DEDE 已改用 JSON 存储)
  • 前端引入 Lightbox / Swiper 等成熟相册库
  • 后端输出纯 JSON 数据,前端渲染,分离关注点

将 Getimg() 放入 include/extend.func.php,即可在全站任意模板中灵活调用图片集多图展示。

copyright © 萬盛學電腦網 all rights reserved