[MMO] Core Library v2.2.3

A library that contains helper functions for our add-ons.

1. Introduction

During use, Add the requires section to addon.json to document the dependancy:
JSON:
{
"require": {
"MMO/CoreLib": [
2020270,
"[MMO] Core Library v2.2.2+"
]
}
}

2. Template additions

We are adding various functions for templates that will make it easier for you to work with them, as well as add several useful functions.

Template Function: mcl_diff_for_human
Get the difference time in a human readable format in the current locale

---

Template Function: mcl_phrase_plural
After defining a translation phrase that has pluralization options, you may use the mcl_phrase_plural function to retrieve the phrase for a given "count".

3. Options

MMO\CoreLib\Option\UserGroup - Displays a list of user groups with the ability to select a checkbox type.
MMO\CoreLib\Option\UserUpgrade - Displays a list of promotions of user groups with the ability to select the type of checkbox
MMO\CoreLib\Option\CustomFields\Contact - Displays additional user fields of type contacts
MMO\CoreLib\Option\CustomFields\Personal - Displays additional user fields of type personals
MMO\CoreLib\Option\CustomFields\Prefefernces - Displays additional user fields of type preferences

4. Traits. New in 2.2.3

Macroable - A trait to dynamically add methods to a class.
PHP:
$macroableClass = new class() {
use Illuminate\Support\Traits\Macroable;
};

$macroableClass::macro('concatenate', function(... $strings) {
return implode('-', $strings);
};

$macroableClass->concatenate('one', 'two', 'three'); // returns 'one-two-three'
Callables passed to the macro function will be bound to the class
PHP:
$macroableClass = new class() {

protected $name = 'myName';

use Illuminate\Support\Traits\Macroable;
};

$macroableClass::macro('getName', function() {
return $this->name;
};

$macroableClass->getName(); // returns 'myName'

5. Collections. New in 2.2.3

The MMO\CoreLib\Util\Collection class provides a fluent, convenient wrapper for working with arrays of data. The collect helper returns a new MMO\CoreLib\Util\Collection instance for the given array. So, creating a collection is as simple as:
PHP:
$collection = collect([1, 2, 3]);
Collections are "macroable", which allows you to add additional methods to the Collection class at run time. The MMO\CoreLib\Util\Collection class' macro method accepts a closure that will be executed when your macro is called. The macro closure may access the collection's other methods via $this, just as if it were a real method of the collection class.

6. Conclusion

At this point I should acknowledge the work of Taylor Otwell and other contributors to the Laravel PHP Framework - the [MMO] Core Lib was heavily inspired by the framework developed for Laravel and some of the reflection classes are taken directly from the Illuminate\Support component. The library also uses some separate libraries from the framework. And it is worth praising for the tighten collections outside of laravel