PHPackages wszdb/flarum-postalbums - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. wszdb/flarum-postalbums ActiveFlarum-extension wszdb/flarum-postalbums ======================= A Flarum extension for users to create post albums and collections v1.2(6mo ago)0158↑130.8%MITJavaScript Since Nov 2Pushed 6mo agoCompare [ Source](https://github.com/wszdb/flarum-postalbums)[ Packagist](https://packagist.org/packages/wszdb/flarum-postalbums)[ RSS](/packages/wszdb-flarum-postalbums/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (1)Versions (4)Used By (0) Flarum 帖子专辑插件 (PostAlbums) ========================== [](#flarum-帖子专辑插件-postalbums) 一个功能强大的 Flarum 扩展，类似Discuz!的淘专辑，允许用户创建专辑来收藏和组织论坛中的帖子。 ✨ 主要功能 ------ [](#-主要功能) ### 📚 专辑管理 [](#-专辑管理) - **创建专辑**：用户可以创建自己的专辑，设置标题和简介 - **收藏帖子**：将喜欢的帖子添加到专辑中 - **专辑关注**：关注其他用户的专辑 - **专辑广场**：浏览所有公开的专辑 ### 🎯 推荐专辑 (新功能) [](#-推荐专辑-新功能) - **智能推荐**：在帖子页面自动推荐相关专辑 - **三种位置**：可选择在第一个帖子后、最后一个帖子后或回复框位置显示 - **随机展示**：从有收藏内容的专辑中随机选择展示 - **引导创建**：当推荐数量不足时，引导用户创建新专辑 - **美观卡片**：采用现代化卡片设计，响应式布局 ### 📢 公告功能 (新功能) [](#-公告功能-新功能) - **自定义公告**：在专辑列表页显示管理员设置的公告或帮助信息 - **支持超链接**：可以添加教程、规则等链接 - **支持换行**：多段落内容展示 - **安全过滤**：自动过滤不安全的 HTML 内容 ### ⚙️ 灵活配置 [](#️-灵活配置) - **自定义按钮文字**：可自定义"加入专辑"按钮的显示文字 - **访问控制**：可设置是否允许游客访问 - **数量限制**：可限制每个用户的专辑数量和每个专辑的收藏数 - **排序方式**：支持多种排序方式（最新创建、最多关注、随机） 📸 功能截图 ------ [](#-功能截图) ### 推荐专辑展示 [](#推荐专辑展示) ``` ┌─────────────────────────────────────────────────────────────┐ │ 推荐专辑 进入广场 → │ ├─────────────────────────────────────────────────────────────┤ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │专辑标题 │ │专辑标题 │ │+ 创建 │ │ │ │专辑简介 │ │专辑简介 │ │ 专辑 │ │ │ │👤 作者 │ │👤 作者 │ │ │ │ │ │📖 5 ❤️ 3│ │📖 3 ❤️ 2│ │创建你的 │ │ │ └──────────┘ └──────────┘ │社区专辑 │ │ │ └──────────┘ │ └─────────────────────────────────────────────────────────────┘ ``` ### 专辑列表页公告 [](#专辑列表页公告) ``` ┌─────────────────────────────────────────────────────────────┐ │ 帖子专辑 [创建专辑] │ ├─────────────────────────────────────────────────────────────┤ │ 📢 欢迎使用帖子专辑功能！ │ │ │ │ 使用帮助：查看详细教程 │ ├─────────────────────────────────────────────────────────────┤ │ [专辑广场] [我的专辑] [我的关注] │ │ ... │ └─────────────────────────────────────────────────────────────┘ ``` 🚀 安装 ---- [](#-安装) ### 使用 Composer 安装 [](#使用-composer-安装) ``` composer require wszdb/flarum-postalbums ``` ### 手动安装 [](#手动安装) 1. 下载插件文件 2. 解压到 `packages/flarum-postalbums` 目录 3. 运行以下命令： ``` cd packages/flarum-postalbums composer install npm install npm run build ``` 4. 在 Flarum 后台启用插件 ⚙️ 配置说明 ------- [](#️-配置说明) 进入 Flarum 后台 → 扩展 → PostAlbums，可以配置以下选项： ### 基础设置 [](#基础设置) 设置项说明默认值前台显示名称专辑功能在前台的显示名称帖子专辑加入专辑按钮文字帖子下方按钮的文字+专辑允许游客访问是否允许未登录用户查看专辑否### 推荐专辑设置 [](#推荐专辑设置) 设置项说明默认值显示推荐专辑是否在帖子页面显示推荐专辑否推荐专辑显示位置选择推荐专辑的显示位置最后一个帖子后推荐专辑数量显示的推荐专辑数量（1-10）2**显示位置选项：** - **第一个帖子后**：适合活跃社区，提高曝光 - **最后一个帖子后**：适合阅读为主，不打扰（推荐） - **回复框位置**：适合互动导向，引导参与 ### 公告设置 [](#公告设置) 设置项说明限制专辑列表页公告显示在专辑列表页标题下方的公告最多200字**支持的格式：** - ✅ 超链接：`文字` - ✅ 换行：直接按回车或使用 `\n` - ❌ 其他 HTML 标签会被自动过滤 **公告示例：** ``` 欢迎使用帖子专辑功能！ 使用帮助：查看详细教程 问题反馈：点击这里 ``` ### 限制设置 [](#限制设置) 设置项说明默认值创建专辑所需主题数用户需要发布多少个主题才能创建专辑0（无限制）专辑标题最大长度专辑标题的最大字符数100专辑简介最大长度专辑简介的最大字符数500每个用户最多创建专辑数限制单个用户可创建的专辑数量10每个专辑最多收藏数限制单个专辑可包含的帖子数量1000### 显示设置 [](#显示设置) 设置项说明默认值专辑列表每页显示数专辑广场每页显示的专辑数量20专辑详情每页显示数专辑详情页每页显示的帖子数量10专辑默认排序方式专辑广场的默认排序方式最新创建**排序方式选项：** - **最新创建**：按创建时间倒序 - **最多关注**：按关注人数倒序 - **随机排序**：有收藏的专辑在前且随机，无收藏的在后且随机 💡 使用场景 ------ [](#-使用场景) ### 1. 知识整理 [](#1-知识整理) 用户可以创建"前端开发教程"、"后端技巧"等专辑，收藏相关的优质帖子。 ### 2. 资源收集 [](#2-资源收集) 创建"实用工具推荐"、"优秀插件"等专辑，整理有用的资源。 ### 3. 话题追踪 [](#3-话题追踪) 创建"项目讨论"、"问题汇总"等专辑，跟踪特定话题的讨论。 ### 4. 个人收藏 [](#4-个人收藏) 创建"我的收藏"专辑，保存自己感兴趣的内容。 ### 5. 社区推荐 [](#5-社区推荐) 通过推荐专辑功能，让用户发现更多优质内容和专辑。 🎨 样式定制 ------ [](#-样式定制) 插件提供了完整的 LESS 样式文件，可以通过自定义 CSS 来调整外观： ``` // 推荐专辑样式 .RecommendedAlbums { margin: 30px 0; padding: 20px; background: #f8f9fa; border-radius: 8px; } // 公告样式 .AlbumsPage-notice { background: #e3f2fd; border-left: 4px solid #2196f3; padding: 15px 20px; } ``` 🔧 开发 ---- [](#-开发) ### 编译前端资源 [](#编译前端资源) ``` npm install npm run build ``` ### 开发模式 [](#开发模式) ``` npm run dev ``` 📝 更新日志 ------ [](#-更新日志) ### Version 1.2.0 (2025-11-08) [](#version-120-2025-11-08) #### 新增功能 [](#新增功能) - ✨ **推荐专辑功能** - 在帖子页面智能推荐相关专辑 - 支持三种显示位置选择 - 自定义推荐数量（1-10个） - 响应式卡片布局 - 引导用户创建专辑 - 📢 **公告功能** - 专辑列表页显示管理员公告 - 支持超链接和换行 - 最多200字限制 - 自动安全过滤 - ⚙️ **自定义按钮文字** - 可自定义"加入专辑"按钮文字 - 后台设置，实时生效 #### 优化改进 [](#优化改进) - 🎨 移除"加入专辑"按钮的图标 - 🎨 优化推荐专辑卡片样式 - 🎨 简介超过25字自动截断 - 🐛 修复 Mithril 框架下的 HTML 渲染问题 ### Version 1.0.0 (2025-01-01) [](#version-100-2025-01-01) - 🎉 初始版本发布 - ✨ 基础专辑管理功能 - ✨ 专辑关注功能 - ✨ 专辑广场 - ✨ 搜索和排序 🤝 贡献 ---- [](#-贡献) 欢迎提交 Issue 和 Pull Request！ 📄 许可证 ----- [](#-许可证) MIT License 👨‍💻 作者 ------ [](#‍-作者) wszdb 🔗 相关链接 ------ [](#-相关链接) - [Flarum 官网](https://flarum.org/) - [Flarum 中文社区](https://discuss.flarum.org.cn/) 💬 支持 ---- [](#-支持) 如果您在使用过程中遇到问题，可以： 1. 查看 [文档](./FINAL_DEPLOYMENT_GUIDE.md) 2. 提交 [Issue](https://github.com/wszdb/flarum-postalbums/issues) 3. 加入讨论组 4. 本插件使用 [AiPy](https://www.aipyaipy.com/) 全自动开发完成，邀请码：XOFS\*\* ⭐ Star History -------------- [](#-star-history) 如果这个扩展对您有帮助，欢迎 ⭐ Star 支持！ ### Health Score 33 — LowBetter than 75% of packages Maintenance68 Regular maintenance activity Popularity13 Limited adoption so far Community6 Small or concentrated contributor base Maturity37 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 3 Last Release 185d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/206fdad6f04e67cdf50359bafd70941f93ddf0488ae4c35513f08bdbf361a66c?d=identicon)[wszdb](/maintainers/wszdb) --- Top Contributors [![wszdb](https://avatars.githubusercontent.com/u/202256400?v=4)](https://github.com/wszdb "wszdb (1 commits)") --- Tags collectionsextensionbookmarksflarumalbums ### Embed Badge ![Health badge](/badges/wszdb-flarum-postalbums/health.svg) ``` [![Health](https://phpackages.com/badges/wszdb-flarum-postalbums/health.svg)](https://phpackages.com/packages/wszdb-flarum-postalbums) ``` ### Alternatives [flarum-lang/russian Russian language pack for Flarum. 13126.1k](/packages/flarum-lang-russian)[flarum-lang/french French language pack to localize the Flarum forum software plus its official and third-party extensions. 2033.8k](/packages/flarum-lang-french)[flarum/gdpr Features for GDPR, PII management 1425.2k15](/packages/flarum-gdpr)[fof/subscribed Additional user subscriptions for your forum 1327.5k2](/packages/fof-subscribed) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)