Dependency Collector
Dependency Collector is a Flarum extension for building a curated, community-powered directory of products, libraries, tools, links, projects, or any other resources your forum wants to collect.
It was originally designed for collecting technical dependencies, but the extension is intentionally generic: users submit entries, moderators review them, categories keep the organized, and the forum frontend presents approved entries in a searchable card grid.
Demo: https://wyz.xyz/dependencies
Requirements
- Flarum 2.x
- PHP 8.3 or higher
- Composer
Features
- Community submissions: Signed-in users with permission can submit new directory items from the forum frontend.
- Moderation workflow: Submitted items can be reviewed, edited, approved, rejected, or deleted by users with moderation permission.
- Custom categories: The extension includes its own category system, separate from Flarum Tags. Each category can have a name, slug, description, color, and Font Awesome icon.
- Category management UI: Administrators can create and edit categories in the extension settings page. Icon codes can be typed manually or selected from the built-in icon picker.
- Search: The directory can be searched by title and description, with results updating directly in the frontend list.
- Filtering: Users can filter approved items by category.
- Favorites: Logged-in users can favorite and unfavorite items, and quickly switch to their saved list.
- Responsive card layout: Approved items are shown as cards with title, description, categories, author, and compact action buttons.
- Bilingual language files: English and Simplified Chinese translations are included.
- Flarum 2 API resources: The extension uses Flarum 2 resource-based API integration instead of the older Flarum 1 serializer/controller pattern.
- Permission controls: Admins can configure who may submit, moderate, delete, and manage categories.
Common Use Cases
- A community product directory
- A library, package, or dependency collection
- A curated resource list
- A showcase of member projects
- A reading list or tool list
- A recommendation board that requires approval before publication
Installation
Run this command in your Flarum root directory:
composer require shebaoting/flarum-dependency-collector:"*"
php flarum migrate
php flarum cache:clear
Then enable the extension in the Flarum admin dashboard.
Updating
composer update shebaoting/flarum-dependency-collector:"*"
php flarum migrate
php flarum cache:clear
If your forum still requires the old package name, switch the Composer requirement first:
composer remove shebaoting/dependency-collector --no-update
composer require shebaoting/flarum-dependency-collector:"*" -W
If you are upgrading from the Flarum 1.x version, keep your existing database data in place. The Flarum 2.x version is designed to continue using the extension's existing tables while updating the API and frontend integration.
Usage
The extension registers this forum route:
/dependencies
Users with permission can submit items. Moderators can approve, edit, reject, or delete entries. Approved items can be browsed, filtered by category, searched, and favorited from the frontend directory.
Links
