Module monnaie / monnaie

Module monnaie / monnaie

skeeks/cms-module-money

Installer Démo

Module pour travailler avec de l'argent et de la monnaie.

Un exemple typique que nous résolvons de manière transparente dans cette bibliothèque. ($ 10 + 154 $ + 12 $) = ruzaltat doit être indiqué en GBP pour les paramètres régionaux de_DE.

Heure de publication: mardi 23 juin 2015 (il y a 4 ans)

Créé par: Семенов Александр Сергеевич

Catégorie: Pour le magasin

Version actuelle: 3.1.1
19 nov. 2017 18:18:44 (il y a un an)

Packagist: skeeks/cms-module-money

: https://github.com/skeeks-cms/cms-module-money

: 1674 (Par mois: 11)

Type: Компонент


Module pour travailler avec de l'argent et de la monnaie. La base de ce module était la bibliothèque https://github.com/sebastianbergmann/money , mais elle devait être assez finie. Par conséquent, dans sa forme pure, il n'était pas connecté.

Le travail principal consistait à créer un travail transparent avec de l'argent. Un exemple typique que nous résolvons de manière transparente dans cette bibliothèque. ($ 10 + 154 $ + 12 $) = ruzaltat doit être indiqué en GBP pour les paramètres régionaux de_DE.

Module for working with money and currency

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist skeeks/cms-module-money "*"

or add

"skeeks/cms-module-money": "*"

Configuration app


'components' => [ 'money' => [ 'class' => 'skeeks\modules\cms\money\components\money\Money', ], 'i18n' => [ 'translations' => [ 'skeeks/money' => [ 'class' => 'yii\i18n\PhpMessageSource', 'basePath' => '@skeeks/modules/cms/money/messages', 'fileMap' => [ 'skeeks/money' => 'main.php', ], ] ] ], ], 'modules' => [ 'money' => [ 'class' => 'skeeks\modules\cms\money\Module', ] ]

Links

Игформация о модуле

Модуль для работы с деньгами и валютой. За основу данного модуля, была взята библиотека https://github.com/sebastianbergmann/money, но ее пришлось изрядно допилить. Поэтому в чистом виде она не была подключена.

Основная работа была в том, чтобы появилась некоторая прозрачная работа с деньгами. Типичны пример, который мы прозрачно решаем в этой библиотеке. (10$ + 154руб + 12$) = рузальтат нужно показать в GBP, для de_DE локали

Сразу пример:

use \skeeks\modules\cms\money\Money;
use \skeeks\modules\cms\money\IntlFormatter;

$money  = Money::fromString('10', "USD");
$money2 = Money::fromString('154', "EUR");
$money3 = Money::fromString('12', "EUR");

$money = $money->add($money2);
$money = $money->add($money3);

$money = $money->convertToCurrency('GBP');

$formatter = new IntlFormatter('de_DE');
$formatter->format($money); //результат 132,25 £

Установка

1) Стандартная установка через composer

php composer.phar require --prefer-dist skeeks/cms-module-money "*"

or add

"skeeks/cms-module-money": "*"

to the require section of your composer.json file.

2) Установка миграций

 php yii migrate --migrationPath=vendor/skeeks/cms-module-money/migrations

Примеры и использование

Оригинальные примеры

Creating a Money object and accessing its monetary value

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;

// Create Money object that represents 1 EUR
$m = new Money(100, new Currency('EUR'));

// Access the Money object's monetary value
print $m->getAmount();

The code above produces the output shown below:

100

Creating a Money object from a string value

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;

// Create Money object that represents 12.34 EUR
$m = Money::fromString('12.34', new Currency('EUR'))

// Access the Money object's monetary value
print $m->getAmount();

The code above produces the output shown below:

1234

Using a Currency-specific subclass of Money

use skeeks\cms\modules\money\EUR;

// Create Money object that represents 1 EUR
$m = new EUR(100);

// Access the Money object's monetary value
print $m->getAmount();

The code above produces the output shown below:

100

Please note that there is no subclass of Money that is specific to Turkish Lira as TRY is not a valid class name in PHP.

Formatting a Money object using PHP’s built-in NumberFormatter

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;
use skeeks\cms\modules\money\IntlFormatter;

// Create Money object that represents 1 EUR
$m = new Money(100, new Currency('EUR'));

// Format a Money object using PHP's built-in NumberFormatter (German locale)
$f = new IntlFormatter('de_DE');

print $f->format($m);

The code above produces the output shown below:

1,00 €

Basic arithmetic using Money objects

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;

// Create two Money objects that represent 1 EUR and 2 EUR, respectively
$a = new Money(100, new Currency('EUR'));
$b = new Money(200, new Currency('EUR'));

// Negate a Money object
$c = $a->negate();
print $c->getAmount();

// Calculate the sum of two Money objects
$c = $a->add($b);
print $c->getAmount();

// Calculate the difference of two Money objects
$c = $b->subtract($a);
print $c->getAmount();

// Multiply a Money object with a factor
$c = $a->multiply(2);
print $c->getAmount();

The code above produces the output shown below:

-100
300
100
200

Comparing Money objects

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;

// Create two Money objects that represent 1 EUR and 2 EUR, respectively
$a = new Money(100, new Currency('EUR'));
$b = new Money(200, new Currency('EUR'));

var_dump($a->lessThan($b));
var_dump($a->greaterThan($b));

var_dump($b->lessThan($a));
var_dump($b->greaterThan($a));

var_dump($a->compareTo($b));
var_dump($a->compareTo($a));
var_dump($b->compareTo($a));

The code above produces the output shown below:

bool(true)
bool(false)
bool(false)
bool(true)
int(-1)
int(0)
int(1)

The compareTo() method returns an integer less than, equal to, or greater than zero if the value of one Money object is considered to be respectively less than, equal to, or greater than that of another Money object.

You can use the compareTo() method to sort an array of Money objects using PHP’s built-in sorting functions:

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;

$m = array(
    new Money(300, new Currency('EUR')),
    new Money(100, new Currency('EUR')),
    new Money(200, new Currency('EUR'))
);

usort(
    $m,
    function ($a, $b) { return $a->compareTo($b); }
);

foreach ($m as $_m) {
    print $_m->getAmount() . "\n";
}

The code above produces the output shown below:

100
200
300

Allocate the monetary value represented by a Money object among N targets

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;

// Create a Money object that represents 0,99 EUR
$a = new Money(99, new Currency('EUR'));

foreach ($a->allocateToTargets(10) as $t) {
    print $t->getAmount() . "\n";
}

The code above produces the output shown below:

10
10
10
10
10
10
10
10
10
9

Allocate the monetary value represented by a Money object using a list of ratios

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;

// Create a Money object that represents 0,05 EUR
$a = new Money(5, new Currency('EUR'));

foreach ($a->allocateByRatios(array(3, 7)) as $t) {
    print $t->getAmount() . "\n";
}

The code above produces the output shown below:

2
3

Extract a percentage (and a subtotal) from the monetary value represented by a Money object

use skeeks\cms\modules\money\Currency;
use skeeks\cms\modules\money\Money;

// Create a Money object that represents 100,00 EUR
$original = new Money(10000, new Currency('EUR'));

// Extract 21% (and the corresponding subtotal)
$extract = $original->extractPercentage(21);

printf(
    "%d = %d + %d\n",
    $original->getAmount(),
    $extract['subtotal']->getAmount(),
    $extract['percentage']->getAmount()
);

The code above produces the output shown below:

10000 = 8265 + 1735

Please note that this extracts the percentage out of a monetary value where the percentage is already included. If you want to get the percentage of the monetary value you should use multiplication (multiply(0.21), for instance, to calculate 21% of a monetary value represented by a Money object) instead.

Страница на SkeekS CMS Marketplace

skeeks!
SkeekS CMS (Yii2) — быстро, просто, эффективно!
skeeks.com | cms.skeeks.com | marketplace.cms.skeeks.com

Процесс разработки модуля.

3.1.1

  • Pgsql support

3.1.0

  • Pgsql support

3.0.3

  • Fixed assets

3.0.2

  • Code style
  • Change source dir to src
  • Agents config update

3.0.1

  • Using composer-config-plugin

3.0.0

  • Update SkeekS CMS

2.5.0

  • New menu item
  • Add filters to admin table

2.4.2

  • Money implements JsonSerializable

2.4.1

  • Added internationalization

2.3.0

  • \yii\base\Module
  • Removed Cms::TRIGGER_AFTER_UPDATE

2.2.2

  • Adding internationalization
  • Обновлены агенты

2.2.1

  • Больше не используется skeeks\cms\base\db\ActiveRecord

2.2.0

  • Адаптация под SkeekS CMS 2.5

2.1.0

  • Добавлена возможность указания наценки
  • Добавлен агент для автоматического обновления данных

2.0.14

  • Исправление зависимостей в composer.json

2.0.13

  • Переезд на github

2.0.12

  • Новый метод для получения значения ->getValue();

2.0.11

  • Новый метод для конвертации денежного объекта в текущиую валюту для текущей локали ->convertAndFormat();

2.0.10

  • Изменения в объекте Money

2.0.9

  • Изменен тип поля для хранения курса валют

2.0.8

  • Доработка админки

2.0.7

  • Доработка админки

2.0.6

  • Доработка таблицы в админке

2.0.5

  • Обновлена зависимость от CMS

2.0.4

  • Обновлена зависимость от CMS

2.0.3

  • Обновление версионирования

2.0.2

  • Обновлен Grid админ панели

2.0.1

  • Исправлены мелкие баги

2.0.0

  • Добавлено поле active
  • Удален status
  • Модицирован для работы с SkeekS CMS >=2.*

1.0.9

  • Убраны php-extensions из composer.json, и добавлен check PhpModulesCheck

1.0.8

  • \Yii::$app->money - развитие компонента, появилась текущая валюта. И несколько полезных методов

1.0.7

  • Указание валюты по умолчанию
  • Управляемый и настраиваемый компонент
  • Появился приоритет изменился статус

Комментарий:
Решает все возможные задачи, связанные с преобразованием и отображением валют, денег. Их сложение и конвертация.


Affichage de 1-1 sur 1 élément.

Tous les commentaires (0)
Sans commentaires

dev-master — 21 mai 2018 02:08:14 (il y a un an)

dev-shop-update — 14 oct. 2016 14:29:11 (il y a 2 ans)

dev-release — 1 juil. 2015 11:53:50 (il y a 4 ans)

dev-v1-stable — 28 avr. 2015 02:59:45 (il y a 4 ans)

3.1.1 — 19 nov. 2017 18:18:44 (il y a un an)

3.1.0 — 19 nov. 2017 17:54:20 (il y a un an)

3.0.3 — 15 nov. 2017 22:29:25 (il y a un an)

3.0.2 — 15 nov. 2017 22:15:13 (il y a un an)

3.0.1 — 7 nov. 2017 12:41:35 (il y a un an)

3.0.0 — 18 juin 2017 18:20:00 (il y a 2 ans)

3.0.0-alpha — 18 juin 2017 18:20:00 (il y a 2 ans)

2.5.0 — 16 oct. 2016 12:23:15 (il y a 2 ans)

2.4.2 — 28 juil. 2016 10:42:08 (il y a 3 ans)

2.4.1 — 5 mai 2016 12:06:09 (il y a 3 ans)

2.4.0 — 21 avr. 2016 11:30:15 (il y a 3 ans)

2.3.0 — 20 avr. 2016 16:36:01 (il y a 3 ans)

2.2.2 — 16 avr. 2016 22:59:16 (il y a 3 ans)

2.2.1 — 5 mars 2016 22:59:57 (il y a 3 ans)

2.2.0 — 5 mars 2016 15:23:47 (il y a 3 ans)

2.1.0 — 4 mars 2016 13:21:06 (il y a 3 ans)

2.0.14 — 17 févr. 2016 22:55:04 (il y a 3 ans)

2.0.13 — 31 oct. 2015 22:21:45 (il y a 3 ans)

2.0.12 — 9 oct. 2015 21:12:46 (il y a 3 ans)

2.0.11 — 2 oct. 2015 18:11:50 (il y a 3 ans)

2.0.10 — 16 sept. 2015 00:59:27 (il y a 3 ans)

2.0.9 — 2 sept. 2015 12:34:04 (il y a 3 ans)

2.0.8 — 1 sept. 2015 13:49:05 (il y a 3 ans)

2.0.7 — 26 août 2015 12:14:34 (il y a 3 ans)

2.0.6 — 26 juil. 2015 19:12:57 (il y a 4 ans)

2.0.5 — 1 juil. 2015 11:53:50 (il y a 4 ans)

2.0.4 — 1 juil. 2015 11:48:37 (il y a 4 ans)

2.0.3 — 18 juin 2015 13:46:42 (il y a 4 ans)

2.0.2 — 2 juin 2015 15:31:42 (il y a 4 ans)

2.0.1 — 1 juin 2015 19:44:27 (il y a 4 ans)

2.0.0 — 1 juin 2015 19:26:45 (il y a 4 ans)

1.0.9 — 28 avr. 2015 02:59:45 (il y a 4 ans)

1.0.8 — 3 avr. 2015 20:56:39 (il y a 4 ans)

1.0.7 — 3 avr. 2015 19:40:45 (il y a 4 ans)

1.0.6 — 31 mars 2015 21:26:01 (il y a 4 ans)

1.0.5 — 25 mars 2015 00:05:29 (il y a 4 ans)

1.0.4 — 18 mars 2015 02:38:26 (il y a 4 ans)

1.0.3 — 23 févr. 2015 14:09:09 (il y a 4 ans)

1.0.2 — 19 févr. 2015 01:39:58 (il y a 4 ans)

1.0.1 — 3 févr. 2015 12:50:33 (il y a 4 ans)

1.0.0 — 30 janv. 2015 19:21:10 (il y a 4 ans)

Стандартная установка:

Добавьте composer.json файл вашего проекта:

"skeeks/cms-module-money": "*"

Запустите обновление зависимостей


Читать про обнолвение SkeekS CMS