Projects

A flexible user projects extension for Flarum 2 — a showcase page for creator communities. Members publish "projects" (books, games, apps, art, mods, anything) as cards on a dedicated page, with rich, admin-configurable metadata.

Inspired by this community request. Free and MIT-licensed.

Features

• Project cards with an optional cover image, author, categories, key parameters, a short description and link buttons — on a dedicated /projects page.

• Search & filters — full-text search, category filter and sort (recent / most-liked / A–Z), plus an Add project button.

• Admin-defined categories with an icon and accent colour. A project's main category becomes a badge shown next to the author's name across the forum.

• Custom parameters — define your own typed fields (text, paragraph, number, date, URL, select, yes/no) such as Genre, Age rating or Release date. Choose which show on the card.

• Flexible link/button system — define button slots, optionally restricted to specific domains (e.g. only YouTube links), with default or custom labels. Example for a book: Read Excerpt, Buy, Discuss on Forum.

• Optional moderation — projects can publish instantly or wait for approval, controlled per-group by the Publish without moderation permission.

• Detail page with forum-formatted content, all parameters and link buttons; link a forum discussion for comments.

• Built-in likes on every project.

• Profile integration — a Projects tab on each member's profile, plus a featured-project badge (their main category's icon, with the project name on hover) next to their username everywhere.

• FoF Badges integration (optional) — award a badge when a member's project is first published.

Screenshots

| Browse page | Project detail |

| --- | --- |

| | |

| Submission form | Admin configuration |

| --- | --- |

| | |

Permissions

| Permission | Default |

| --- | --- |

| Create projects | Members |

| Publish without moderation | — (admins/mods always can) |

| Moderate projects | Moderators |

Installation

php flarum migrate
php flarum cache:clear```

Then open **Admin → Projects** to add categories, custom parameters and button slots.

## License

[MIT](https://github.com/ernestdefoe/projects/blob/main/LICENSE)

projects v1.3.1

Follow-up to SergeyTS's v1.3.0 feedback.

Fixed

• Badge awards now notify the recipient. The award goes through fof/badges' BadgeAwarder (which sends the "you earned a badge" notification, runs the badge's actions, and fires BadgeAwarded) instead of a raw pivot attach. Falls back to the direct attach on older fof/badges so the award still lands either way.
• The "award on publish" badge is now a real picker — a dropdown of badge names (loaded from the config endpoint), matching the per-category badge picker. No more raw numeric IDs; choose "None" to disable.

Included (already in the 1.3.0 source, ensured here for installs that pre-dated it)

• Parameter (custom field) descriptions — add them in the field editor; they render under the parameter's name in the submission form.
• Per-category badge picker + tag descriptions on hover.

Update: composer update ernestdefoe/projects then php flarum cache:clear.

View release on GitHub

projects v1.4.0

Full 15-item feedback batch from SergeyTS, plus a rich Details editor.

Forum

• Co-authored projects now show on the co-author's profile
• Details field uses Flarum's composer editor (formatting toolbar) instead of a plain textarea
• Oversize cover-image uploads show feedback again; size hint added
• "Feature on profile" is now instant (optimistic)
• Author separator (·), required-asterisk visibility (+ on Title), link-button wrapping, param name/value spacing, Links-section styling
• Scroll position restored when returning from a project
• Core Flarum Select dropdowns
• Linked discussion accepts a pasted URL or a bare ID

Admin

• Reorder tags / parameters / buttons (drives display on form, cards and pages)
• Publish-badge picker rebuilt so its options actually populate

View release on GitHub

projects v1.4.1

Follow-up UI polish from SergeyTS's feedback on v1.4.0:

• Details editor — inner padding (text no longer against the edges), taller box, and a wrapping toolbar so the formatting tools fit on narrow screens.
• Links section — more spacing between link rows.
• Author separator — the middot now aligns with the author names (baseline alignment; avatars stay centred).
• Dropdowns — now a Flarum-styled dropdown menu (built from Flarum's own Dropdown), instead of a native <select> whose popup used the browser's chrome.

View release on GitHub

projects v1.4.2

The Details editor now spans the full width of the form (it was shrinking to fit the placeholder), lining up with the other fields.

View release on GitHub

projects v1.4.3

The Details editor toolbar now spreads its buttons evenly across the full width, with no icons overflowing the editor.

View release on GitHub

projects v1.4.4

What's Changed

• SergeyTS follow-up: editor toolbar/resize, byline, links box, filter dropdowns

Full Changelog: https://github.com/ernestdefoe/projects/compare/v1.4.3...v1.4.4

View release on GitHub

projects v1.4.5

What's Changed

• fix(filters): keep filter dropdown label + chevron on one line

Full Changelog: https://github.com/ernestdefoe/projects/compare/v1.4.4...v1.4.5

View release on GitHub

projects v1.5.0

Added

• "Made with AI" declaration — an optional toggle on the project form. When enabled, a disclaimer chip appears on the project card and a fuller notice on the detail page, so viewers know the work was AI-assisted. Fully translatable.

Fixed

• Featured-project badge clash (reported by SergeyTS) — the featured badge next to the username reused fof/badges' .PrimaryBadge class, causing the two badges' styles to conflict. It now uses its own standalone .ProjectFeaturedBadge class with self-contained styles, so the two render independently.

View release on GitHub

projects v1.5.1

Fixed

• Featured-project badge icon colour (reported by SergeyTS) — the badge icon inherited the theme's link colour at rest (correct only on hover) because a theme .PostUser a rule outranked the badge's own colour. The icon now uses an explicit colour that holds in every state.

View release on GitHub