PHPackages                             shebaoting/flarum-money - 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. [Utility & Helpers](/categories/utility)
4. /
5. shebaoting/flarum-money

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

shebaoting/flarum-money
=======================

Adds a virtual currency system to the Flarum community, allowing users to earn and spend points.

2.0.1(yesterday)101[1 issues](https://github.com/shebaoting/flarum-money/issues)MITPHPPHP ^8.3

Since Sep 1Pushed yesterday1 watchersCompare

[ Source](https://github.com/shebaoting/flarum-money)[ Packagist](https://packagist.org/packages/shebaoting/flarum-money)[ RSS](/packages/shebaoting-flarum-money/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (3)Versions (9)Used By (0)

Money
=====

[](#money)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/ce0ea664ef32602f773a086429427d451a184465fd3f3567a7e818ac5f363e88/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73686562616f74696e672f666c6172756d2d6d6f6e65792e737667)](https://packagist.org/packages/shebaoting/flarum-money) [![Total Downloads](https://camo.githubusercontent.com/4335cb550d8abb7254150e90bdd38eb9e2c06924e90954a3b07a7642bc2caec8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73686562616f74696e672f666c6172756d2d6d6f6e65792e737667)](https://packagist.org/packages/shebaoting/flarum-money)

A [Flarum](https://flarum.org) extension that adds a configurable virtual currency and point ledger to your community.

> Looking for Chinese documentation? Read the [中文介绍](README.zh-Hans.md).

Money lets a community reward, charge, redistribute, and audit points around common forum actions such as posting, replying, liking, registration, and moderator edits. It is designed for communities that want points to represent attention, contribution, participation cost, or other internal value.

This extension is based on [flarum-ext-money by AntoineFr](https://github.com/AntoineFr/flarum-ext-money). Thanks to the original author for the excellent foundation. This fork keeps the original idea and adds more opinionated logging, redistribution, and Flarum 2.x compatibility features.

Compatibility
-------------

[](#compatibility)

- Flarum: `^2.0.0-beta`
- PHP: `^8.3`
- Requires `flarum/likes` `^2.0@beta`
- Current release line: `2.x`
- Flarum 1.x users should stay on the `0.x` release line.

Features
--------

[](#features)

### Virtual Currency

[](#virtual-currency)

- Adds a `money` balance to every Flarum user.
- Displays the balance on user cards.
- Supports a custom display template, such as `[money] points`.
- Can hide zero balances from the forum UI.

### Point Ledger

[](#point-ledger)

- Records every balance change in the `money_logs` table.
- Stores the changed amount, resulting balance, action type, reason, related user, post, discussion, and timestamps.
- Adds a "Point Records" page under the signed-in user's profile.
- Supports paginated log loading.
- Links log reasons back to related discussions and posts when possible.
- Restricts the front-end log page and API listing to the current authenticated user.

### Registration Bonus

[](#registration-bonus)

- Grants new users an initial point balance when they register.
- Records the registration bonus in the ledger.

### Posting And Reply Rules

[](#posting-and-reply-rules)

- Configures a point amount for creating a new discussion post.
- Configures a separate point amount for replies.
- Each action can be either a reward or a deduction.
- Prevents an action when a deduction would make the actor spend more points than they have.
- Supports a minimum post length for reply rewards or deductions.

### Reply Feedback

[](#reply-feedback)

- Replies can optionally give points back to the discussion author.
- Useful for communities where replying costs the replier but rewards the author who created the discussion.
- Self-feedback is ignored so users do not reward themselves through their own content.

### Like Rewards And Costs

[](#like-rewards-and-costs)

- Configures point changes when a user likes a post.
- Like actions can be rewards or deductions.
- Like deductions can optionally be redistributed to the post author.
- Self-likes are ignored.
- Unliking reverses the configured point effect, including author feedback when enabled.

### Extra Character Rules

[](#extra-character-rules)

- Adds an optional rule for longer content.
- After a configurable character threshold, every additional character increment can trigger extra points.
- Extra points follow the configured reward or deduction direction for posts or replies.
- Extra character changes are also written to the point ledger.

### Moderation And Manual Editing

[](#moderation-and-manual-editing)

- Adds an `Edit money` permission.
- Authorized moderators can edit a user's balance from user controls.
- Manual balance changes are logged with the delta and resulting balance.

### Auto Adjustment On Hidden, Restored, Or Deleted Content

[](#auto-adjustment-on-hidden-restored-or-deleted-content)

- Can automatically adjust balances when discussions or posts are hidden/restored.
- Can instead wait until discussions or posts are deleted.
- Can be disabled entirely.
- These automatic changes are recorded with the related post or discussion context.

### Multi-Level Display

[](#multi-level-display)

- Supports comma-separated money level names, such as `Gold,Silver,Bronze`.
- Supports a configurable scale, such as `100`, to split one numeric balance into multiple display units.
- Example: a balance can be shown as several named levels instead of a single raw number.

Admin Settings
--------------

[](#admin-settings)

SettingDescriptionMoney nameDisplay template for balances. Use `[money]` as the numeric placeholder.Initial moneyPoints granted to new users on registration.Level namesOptional comma-separated labels for multi-level display.Money scaleBase used to split balances across level names.New post amountAmount applied when a user creates the first post in a discussion.Reply amountAmount applied when a user replies to a discussion.Like amountAmount applied when a user likes a post.Change typeChoose reward or deduction for post, reply, and like rules.FeedbackChoose whether reply/like deductions reward the original author.Character thresholdMinimum content length before extra character points apply.Character incrementNumber of extra characters per additional point change.Points per incrementPoints applied for each extra character increment.Auto update moneyChoose how hidden/restored/deleted content affects balances.Hide zeroHide zero balances on user cards.Installation
------------

[](#installation)

Install with Composer:

```
composer require shebaoting/flarum-money:"^2.0"
```

Run migrations and clear the Flarum cache:

```
php flarum migrate
php flarum cache:clear
```

Then enable the extension in the Flarum admin panel and configure the permission and point rules.

Updating
--------

[](#updating)

```
composer update shebaoting/flarum-money:"^2.0"
php flarum migrate
php flarum cache:clear
```

If your forum still requires the old package name, switch the Composer requirement first:

```
composer remove shebaoting/money --no-update
composer require shebaoting/flarum-money:"^2.0" -W
```

When upgrading from `0.x` to `2.x`, make sure your forum is already running Flarum 2.x beta and PHP 8.3 or newer.

Development
-----------

[](#development)

Install JavaScript dependencies and build the front-end assets from the `js` directory:

```
cd js
yarn install
yarn build
```

Validate the Composer package from the extension root:

```
composer validate
```

Philosophy
----------

[](#philosophy)

The design philosophy behind this system is a metaphor for time.

Everything you do in a community consumes time. If a contribution receives no meaningful response, it can feel like the time was spent in vain. A point system can make that invisible cost and feedback loop visible: creating, replying, and liking can all represent attention moving between people.

For a similar concept, I recommend watching the movie *In Time*.

Contact
-------

[](#contact)

You can contact me if you wish to fund or discuss Flarum extension development.

Email:

Links
-----

[](#links)

- [My Community](https://wyz.xyz)
- [Packagist](https://packagist.org/packages/shebaoting/flarum-money)
- [GitHub](https://github.com/shebaoting/flarum-money)

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance80

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity60

Established project with proven stability

 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 ~94 days

Recently: every ~158 days

Total

8

Last Release

1d ago

Major Versions

0.8.0 → 2.0.02026-06-26

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/29738814?v=4)[牛铁柱](/maintainers/shebaoting)[@shebaoting](https://github.com/shebaoting)

---

Top Contributors

[![shebaoting](https://avatars.githubusercontent.com/u/29738814?v=4)](https://github.com/shebaoting "shebaoting (5 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/shebaoting-flarum-money/health.svg)

```
[![Health](https://phpackages.com/badges/shebaoting-flarum-money/health.svg)](https://phpackages.com/packages/shebaoting-flarum-money)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

12127.5k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

59112.4k11](/packages/fof-byobu)[fof/gamification

Upvotes and downvotes for your Flarum community

4062.0k7](/packages/fof-gamification)[fof/polls

 A Flarum extension that adds polls to your discussions

25130.2k9](/packages/fof-polls)[fof/user-bio

Add a user bio to user profiles

20102.0k9](/packages/fof-user-bio)[fof/sitemap

Generate a sitemap

1796.4k2](/packages/fof-sitemap)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)