前言

在使用 Dedecms 进行内容管理时文章内容过长往往需要分页显示以提升阅读体验。Dedecms 默认的分页标签是 {dede:pagebreak/}它可以自动将文章分割成多个页面。不过 当文章页数较多时默认分页显示所有页码，导致页面底部分页条过长，不仅影响美观，也不利于用户快速定位所需页面。

本文将结合最新版本的 Dedecms， 从源码层面讲解如何通过钩子方法控制文章分页显示的页码数量，实现“只显示当前页附近一定范围内的页码”，并提供完整代码示例及操作步骤，帮助大家轻松实现更美观实用的分页效果。

一、Dedecms文章分页基础知识

1.1 什么是{dede:pagebreak/}？

{dede:pagebreak/} 是 Dedecms 用于标识文章中分页位置的标签。在后台编辑器插入该标签后系统会自动将文章拆分成多页，并生成对应静态HTML或动态访问URL。

1.2 分页实现机制简述

Dedecms 解析包含 {dede:pagebreak/} 的字段后将文章拆分为多个独立页面。负责生成分页导航的是 include/arc.archives.class.php 文件中的 GetPagebreak 方法。默认情况下该方法会循环输出所有页码链接，无论总页数多少。

二、为什么需要控制分页显示的页数？

问题场景：

• 长篇大文： 一篇文章可能被拆分成10+甚至20+个页面；
• 默认全部展示： 页面底部显示所有数字链接导致布局拥挤、不美观；
• 用户体验差： 用户难以快速定位当前所在页面和周边有效区域。

解决思路：

- 限制每次只显示固定数量的页码， 中间尽量保持当前页居中； - 页码区间根据当前选中页； - 保持首页、尾页和上一页、下一页按钮完整可用； - 确保改动兼容动态和静态生成两种模式。

三、 修改核心源码实现限制显示指定数量的分页数字

3.1 找到核心函数GetPagebreak

- 路径：/include/arc.archives.class.php - 打开文件，在其中查找函数GetPagebreak

function GetPagebreak {
    // 省略部分代码
    for  {
        // 输出每个页码链接
    }
    // 省略部分代码
}

关键点：

• $totalPage：总共多少个分页页面;
• $nowPage：当前所在第几页;
• $aid：文章ID，用于生成URL等信息。

3.2 修改for循环逻辑， 实现“只显示7个左右”的限制方案示例

// 设置最大展示数字按钮数量，推荐奇数方便居中
$total_list = 7;
if  {
    // 总数小于等于最大展示数，全都显示
    $start = 1;
    $end = $totalPage;
} else {
    // 当前面临多于最大展示数字时根据当前页面区间
    $offset = intval / 2);
    if  {
        // 靠近首页时从头开始连续展示
        $start = 1;
        $end = $total_list;
    } elseif  {
        // 靠近末尾时从后面开始连续展示
        $start = $totalPage - $total_list + 1;
        $end = $totalPage;
    } else {
        // 正常情况，保证当前页面居中
        $start = $nowPage - $offset;
        $end = $nowPage + $offset;
    }
}
// 替换原来的for循环为如下：
for  {
   if  {
       echo "$i";
   } else {
       echo "";
   }
}

*说明*

• $start 和 $end 决定了这次要渲染哪些具体数字;
• $offset 是左右两侧保留多少个数字，使当前数字尽量居中;
• ${GetUrlForAidAndPg} 函数需替换成真实生成带有参数$page链接的方法，这里仅做演示。

3.3 完整替换实例 — 如何写入源码？

public static function GetPagebreak
{
    global $_sys_globals,$_cfg_basehost;
    //...其他代码...
    // 最大数字按钮数量
    $total_list=7;
    if{
        $start=1;$end=$totalPage;
    }else{
        $offset=intval/2);
        if{
            $start=1;
            $end=$total_list;
        }elseif{
            $start=$totalPage-$total_list+1;
            $end=$totalPage;
        }else{
            $start=$now_page-$offset;
            $end=$now_page+$offset;
        }
    }
    for{
        if{
            echo "$i";
        }else{
            echo "";
        }
        // 此处可添加上下翻及首页尾处理逻辑...
      }
      //...其余逻辑...
}

四、静态与动态分页均适用——务必修改两处位置！

注意：

• DedeCMS 有静态HTML模式和动态访问模式， 这两个模式下调用的函数不同，但源码文件一致，都使用同一个核心类解析，所以我们要确保修改的位置覆盖所有情况。
• Main point:   确认在/include/arc.archives.class.php 文件里 两处出现类似名称并涉及循环遍历总分类或者总分面次数的地方都进行相同处理，否则某些情况下依旧会出现全量渲染所有序号的问题。
•     - 动态解析通常在GetChannelPages或类似方法调用     - 静态生成调用就是本教程提到的GetPager或者GetPagerList等相关方法
• - 建议先备份源文件， 再逐步替换调试验证效果，避免误伤造成网站异常。
• - 修改完成后清理缓存，重新发布对应栏目或单篇测试效果。
• - 推荐在本地环境充分测试后再部署生产环境。
• - 一边根据模板中的样式需求调整CSS样式，使新生成数字高亮及跳转按钮视觉清晰。

五、 自定义CSS样式让分页更美观

   5  . *以上样式可应用至article_article.htm模板对应位置*.

* 示例 CSS，可放置至网站主样式表 style.css 中，一边模板中的 pagination 部分调用这个class即可生效 *

六、与注意事项提示

• 切记备份原始源码！修改前务必做好备份工作，以便回滚恢复；否则更新升级可能覆盖自定义改动！                      　　— Dedecms官方团队提醒 —   　　如果以后升级可将此优化方案封装为插件或模块，提高维护性。 .
• - 测试完成后再部署上线， 提高稳定性；查看浏览器Console是否报错或网络请求异常
• - 根据实际项目需求灵活调整$total_list,推荐奇数保持视觉平衡，比如7、9等值。
• - 针对不同模板结构， 有必要同步调整模板文件,保证交互一致，如.
• - 如果使用第三方SEO优化插件， 请确认其不会重写此功能，否则需协同排查冲突问题。
• - 本文示例基于Dedecms最新稳定版PHP环境调试，如版本差异较大请结合实际代码结构适当微调变量名及调用方式。
• - 针对移动端访问，可以进一步结合响应式设计，让你的阅读体验更加友好流畅！　😊😊😊                        ․․․․․․․․․․․․․․․․․․․․․․․ .

  ---

  图X：修改后的源码片段截图示意 *请根据实际路径自行定位编辑*

  图Y：前端实际呈现限制7个数字左右的美观导航条效果演示 

  ---

  本文由资深 Dedecms 技术专家原创整理发布 | 欢迎关注更多实用教程 | QQ技术交流群1547479934 | 感谢阅读！ 更新时间：2024年06月