craft-plugins/nice

A nice plugin with nice functions for nice data representation in Craft CMS

1.1.0 2022-12-15 08:31 UTC

Requires

• craftcms/cms: ^4.3.3

Requires (Dev)

• ext-iconv: *
• pestphp/pest: ^1.22
• phpstan/phpstan: ^1.8.0

MIT

• Sergey Romanenko

• twig
• Craft
• craftcms
• craft-plugin

README

A nice plugin with nice functions for nice data representation in Craft CMS.

Requirements

• Craft CMS: ^4.0
• PHP: ^8.0

Installation

To install the plugin, follow these instructions.

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

   cd /path/to/project
   

2. In your terminal run composer require awilum/craft-nice.

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

Usage

Display nice file size in the twig tempalates:

//=> 1 MB
{{ niceFileSize(1000000) }}

//=> 976.56 KiB
{{ niceFileSize(1000000, false) }}

//=> 1 MB
{{ 1000000 | niceFileSize }}

//=> 976.56 KiB
{{ 1000000 | niceFileSize(false) }}

Display nice number in the twig tempalates:

//=> 10,050,050
{{ niceNumber(10050050) }}

//=> 10,050,050.00
{{ niceNumber(10050050, 2) }}

//=> 10,050,050/00
{{ niceNumber(10050050, 2, '/') }}

//=> 10:050:050/00
{{ niceNumber(10050050, 2, '/', ':') }}

//=> 10,050,050
{{ 10050050 | niceNumber() }}

//=> 10,050,050.00
{{ 10050050 | niceNumber(2) }}

//=> 10,050,050/00
{{ 10050050 | niceNumber(2, '/') }}

//=> 10:050:050/00
{{ 10050050 | niceNumber(2, '/', ':') }}

Display nice date time in the twig tempalates:

//=> November 23, 2022, 4:24 am
{{ niceDateTime(1669177469) }}

//=> November 23, 2022, 4:24 am
{{ 1669177469 | niceDateTime }}

Display nice file name in the twig tempalates:

//=> foo-bar
{{ niceFileName('foo bar') }}

//=> foo-bar
{{ 'foo bar' | niceFileName }}

Use Nice niceDateTime function in the PHP:

use function Awilum\CraftNice\niceDateTime;

echo niceDateTime(1669177469);

LICENSE

The MIT License (MIT) Copyright (c) Sergey Romanenko