PHPackages                             newism/craft3-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. newism/craft3-money

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

newism/craft3-money
===================

Money Fieldtype for CraftCMS v3

1.0.2(5y ago)101[2 issues](https://github.com/newism/craft3-money/issues)MITPHPCI failing

Since Nov 30Pushed 5y ago1 watchersCompare

[ Source](https://github.com/newism/craft3-money)[ Packagist](https://packagist.org/packages/newism/craft3-money)[ RSS](/packages/newism-craft3-money/feed)WikiDiscussions master Synced yesterday

READMEChangelog (3)Dependencies (5)Versions (2)Used By (0)

Money plugin for Craft CMS 3.x
==============================

[](#money-plugin-for-craft-cms-3x)

[![in action](resources/img/in-action.gif)](resources/img/in-action.gif)

[![site settings](resources/img/site-settings.png)](resources/img/site-settings.png)

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 3.5.0 or later.

Installation
------------

[](#installation)

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

```
$ cd /path/to/project
```

2. Then tell Composer to load the plugin:

```
$ composer require newism/craft3-money
```

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Money or run

```
$ ./craft plugin/install money
```

Money Overview
--------------

[](#money-overview)

Money is a custom field type and formatter that uses the [moneyphp/money](https://github.com/moneyphp/money) library. Values are stored as json in the database and normalized as a [Money](https://github.com/moneyphp/money/blob/master/src/Money.php) Value Object.

Currencies are loaded from the [moneyphp/money](https://github.com/moneyphp/money) library. A full list can be found here:

This plugin also loads in `symfony/intl` for currency names.

Configuring Money
-----------------

[](#configuring-money)

Money has two levels of configuration:

- Site settings using a config file or plugin settings
- Field settings

*Note: Field settings are appended to Site settings.*

The two settings are:

- Preferred currencies: These currencies are displayed first in the currency drop down.
- Excluded currencies: These currencies are excluded from the currency drop down.

Both settings accept a comma delimited list of alphabetical currency codes.

It's recommended that you exclude the following currencies: `XBA, XBB, XBC, XBD, XTS, XXX, XAU, XPD, XPT, XAG`

To use a config file see [./src/config.php](./src/config.php).

Using Money
-----------

[](#using-money)

This plugin includes a service for rendering the field value.

Note: In the three methods below `value` must be an instance of `Money`. The examples use the ['Elvis Operator'](https://twig.symfony.com/doc/3.x/templates.html#other-operators).

### International formatter

[](#international-formatter)

```
{{ value ? craft.money.intlFormatter.format(value) }}

# or explicitly define the locale
{{ value ? craft.money.getIntlFormatter(locale).format(value) }}

```

The `intlFormatter` returns a `[IntlMoneyFormatter](http://moneyphp.org/en/stable/features/formatting.html#intl-money-formatter)` object. This formatter requires the intl extension.

Calling `.format()` will return a string with the currency symbol in a format that matches `locale`. Separators will also match the locale.

`locale` is an optional parameter and falls back to the locale defined by Craft: `\Craft::$app->locale->id`

See:

### International Decimal Formatter

[](#international-decimal-formatter)

```
{{ value ? craft.money.intlDecimalFormatter.format(value) }}

# or explicitly define the locale
{{ value ? craft.money.getIntlDecimalFormatter(locale).format(value) }}

```

Outputs the same as above without the currency symbol.

See:

### Decimal Formatter

[](#decimal-formatter)

```
{{ value ? craft.money.decimalFormatter.format(value) }}

```

This formatter outputs a simple decimal string which is always in a consistent format independent of locale.

Money Roadmap
-------------

[](#money-roadmap)

Some things to do, and ideas for potential features:

- Test multiple versions of PHP
- Review the usage of `symfony/intl` for currency names
- Write tests
- Check GraphQL output
- Add localised strings for plugin ui
- Release it

Credits
-------

[](#credits)

Brought to you by [Newism](http://newism.com.au)

[![](./resources/img/icon.svg)](http://newism.com.au/)

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

1989d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/54c91398084bc17848b56c2dc015c3c257fb5871f246f7296a99f1ceba072e4f?d=identicon)[leevigraham](/maintainers/leevigraham)

---

Top Contributors

[![leevigraham](https://avatars.githubusercontent.com/u/25124?v=4)](https://github.com/leevigraham "leevigraham (11 commits)")

---

Tags

craft-fieldcraft-plugincraft3craftcmoneymoneycmsCraftcraftcmscraft-plugin

###  Code Quality

TestsCodeception

### Embed Badge

![Health badge](/badges/newism-craft3-money/health.svg)

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

###  Alternatives

[verbb/formie

The most user-friendly forms plugin for Craft.

101372.9k40](/packages/verbb-formie)[verbb/navigation

Create navigation menus for your site.

90683.7k17](/packages/verbb-navigation)[verbb/comments

Add comments to your site.

13753.1k](/packages/verbb-comments)[verbb/tablemaker

Create customizable and user-defined table fields.

40168.8k1](/packages/verbb-tablemaker)[supercool/tablemaker

Create customizable and user-defined table fields.

40141.7k](/packages/supercool-tablemaker)[pennebaker/craft-architect

CraftCMS plugin to generate content models from JSON/YAML data.

72148.5k5](/packages/pennebaker-craft-architect)

PHPackages © 2026

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