owl/money

This package is abandoned and no longer maintained. No replacement package was suggested.

Tag form widget for OctoberCMS.

Maintainers

Details

github.com/october-widgets/money

Homepage

Source

Issues

Installs: 448

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 1

Open Issues: 0

Language:JavaScript

dev-master / 1.0.x-dev 2015-02-27 18:26 UTC

Requires

  • php: >=5.4.0

MIT e88a41551b61e29a00577352190a85d036ea5c34

  • Scott Bedard <scottbedard90.woop@gmail.com>

moneyowloctoberoctober cms

This package is auto-updated.

Last update: 2021-09-27 12:08:57 UTC

README

Money form widget for OctoberCMS.

Packagist

Installation

To install the Money widget with your plugin, add the following to your plugin's composer.json file.

"require": {
    "owl/money": "~1.0@dev"
}

Next, register the widget in your plugin's Plugin.php file.

public function registerFormWidgets()
{
    return [
        'Owl\FormWidgets\Money\Widget' => [
            'label' => 'Money',
            'code' => 'owl-money'
        ],
    ];
}

Usage

To use the Money widget, simply declare a field type as owl-money

price:
    label: Price
    type: owl-money

There are several parameters that can be used to customize the money widget. Defining a thousands or decimal will change the thousands and decimal characters. Defining a prefix or suffix string will allow you to add currency symbols before or after the input. Lastly, setting allowNegative to true will allow negative values to be submitted.

The below example will accept negative inputs with a USD prefix ($ -1,234.56)

price:
    label: Price
    type: owl-money
    prefix: "$ "
    allowNegative: true

You may need to define the widget configuration dynamically. For example, your plugin might have a variable currency symbol. This can be achieved like so...

Config::set('owl.formwidgets::money', [
    'prefix'        => '$ ',
    'placeholder'   => '$ 0.00',
]);