源码系统概览
文章正文
XiunoBBS块列表展示插件源码是一款用于XiunoBBS论坛的扩展插件。
启用后可将指定板块的置顶帖子以卡片块列表形式呈现，自动提取帖子中的第一张图片作为封面，并展示约160字符的内容摘要，让论坛首页更具资讯门户感。
源码简介
该插件包含钩子文件、模板片段、后台设置页与模型函数。
通过 hook/model_inc_end.php 加载模型函数，在 forum_end 钩子处替换默认列表输出。
后台设置支持选择参与块列表展示的板块，并可在选择特定板块时自动调整分页数量，实现12、24、36条等几种常见布局。
插件通过XiunoBBS标准的钩子机制与模型覆盖方式实现功能，无需修改论坛核心代码，安装与卸载都不会影响论坛稳定性。
模板文件单独存放于htm目录，开发者可以参考其中的卡片结构，快速定制符合自身论坛风格的块列表样式。
适用场景
适用场景包括图文类论坛首页美化、资源分享板块展示、校园/兴趣社区门户化改造，以及需要把论坛帖子以瀑布流或卡片形式呈现的内容站点。
功能亮点
插件可自动识别帖子正文中首张图片作为卡片封面，若帖子无图则以文字摘要展示。
后台勾选板块即可生效，无需修改核心代码。
支持按板块设置不同每页显示条数，满足首页高亮区与普通列表区的差异化展示需求。
模板文件独立，便于二次开发自定义卡片样式。
后台设置页支持多选参与块列表展示的板块，并可为不同板块配置每页显示条数，例如图片站适合每页12条，文字资讯站适合每页24条。
插件在提取首图时使用了正则匹配，对常见img标签格式兼容性较好，无图帖子则自动降级为纯文本摘要。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：HTML模板片段 + CSS（由论坛主题决定） 后端：PHP（XiunoBBS插件机制） 数据库：XiunoB |
依具体方案选型，需自行搭建与维护 |
| 部署方式 | 将 list_block 目录上传到 XiunoBBS 的 plugin/ 目录下，在后台插件管理中安装并启用。 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 插件可自动识别帖子正文中首张图片作为卡片封面，若帖子无图则以文字摘要展示。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：HTML模板片段 + CSS（由论坛主题决定）
后端：PHP（XiunoBBS插件机制）
数据库：XiunoBBS原有数据库（MySQL/SQLite）
运行环境：XiunoBBS 4.0.4+，PHP 7.0+
其他依赖：XiunoBBS主程序与对应版本钩子接口
安装与部署提示
将 list_block 目录上传到 XiunoBBS 的 plugin/ 目录下，在后台插件管理中安装并启用。
进入插件设置页，勾选需要以块列表展示的板块并保存。
若首页布局未生效，请检查当前主题是否包含被覆盖的 forum.htm 模板，必要时手动合并模板片段。
截图与演示说明
截图展示了启用块列表插件后的论坛帖子卡片效果，可见置顶帖以图文卡片形式排列，并带有标题与摘要信息。
截图展示了启用插件后的论坛帖子列表：原本的横向标题列表被替换为图文混排的卡片块，每条帖子左侧为自动提取的首图，右侧为标题与160字符摘要，整体布局更接近资讯门户的首页效果，能够显著提升首页内容吸引力。
常见问题
问：该插件是否支持所有XiunoBBS版本？
插件 conf.json 标注兼容 bbs_version 4.0.4，建议在该版本或相近版本中使用。
问：帖子中没有图片会怎么显示？
插件模型函数会提取首图，若无图则只显示标题与160字符摘要。
问：如何修改卡片样式？
编辑 plugin/xiunobbs_cn_list_block/htm/list.htm 与 forum.htm 模板，并覆盖对应CSS即可。
安全风险提示
特别提示：本源码未检测出明显的加密混淆或后门文件。
插件通过正则表达式提取帖子图片与摘要，部署前建议检查提取逻辑，避免对包含大量外部图片的帖子产生性能问题。
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
下载后请优先在本地或测试环境运行，完成安全审计后再上线正式环境。
本资源不含任何破解授权或激活码，所有部署行为需符合相关法律法规。
