README

¡¡ Notice !!

After an extented period of life getting in the way I'm back to Yii2 development. I'll be rebasing every project as I resume work on it. Projects that use Bootstrap will resume as version 5.0.0 for Bootstrap 5.x.

A collection of resources as Assets, Helpers, & Widgets for Yii2.

Version 5 is so numbered because I've migrated P2Y2Things to using Bootstrap v5.

Highlights

P2Y2 Assets

A kitchen-sink full of CSS & JS resources wrapped as Yii2 AssetBundles. These are just convenient ways to load a bunch of CSS & JS goodies. There's also an option for getting assets from official CDNs.

Bootstrap Social Asset Bundle & Helpers

The Bootstrap Social asset from P2Y2 Assets, with helpers inspired by @rmrevin's yii2-fontawesome.

Credit to @lipis for Bootstrap Social.

FlagIconCss Asset Bundle & Helpers

The flag-icon-css asset from P2Y2 Assets, with helpers inspired by @rmrevin's yii2-fontawesome.

Credit to @lipis for Bootstrap Social.

IsGd Helper

A simple wrapper of is.gd as a helper for Yii 2 Framework.

Uuid Helpers

A simple wrapper of ramsey/uuid as helpers for Yii 2 Framework.

Credit to @ramsey for ramsey/uuid, which provides all the UUID magic here.

Installation

The preferred way to install P2Y2Things is through composer. Depending on your composer installation, run one of the following commands:

	composer require p2made/yii2-p2y2-things "dev-master"

or

	php composer.phar require p2made/yii2-p2y2-things "dev-5.0.0-dev"

Alternatively add:

	"p2made/yii2-p2y2-things": "dev-5.0.0-dev"

to the requires section of your composer.json file & P2Y2Things will be installed next time you run composer update.

And then...

If you're using P2Y2Things you'll want to nullify some of the Yii 2 assets, to avoid conflicts through double loading. Modify common/config/main.php with...

	'components' => [
		...
		'assetManager' => [
			'bundles' => [
				'yii\web\JqueryAsset' => [
					'sourcePath' => null, 'js' => [],
				],
				'yii\bootstrap\BootstrapAsset' => [
					'sourcePath' => null, 'css' => [],
				],
				'yii\bootstrap\BootstrapPluginAsset' => [
					'sourcePath' => null, 'js' => [],
				],
				'yii\jui\JuiAsset' => [
					'sourcePath' => null, 'css' => [], 'js' => [],
				],
				'\rmrevin\yii\fontawesome\AssetBundle' => [
					'sourcePath' => null, 'css' => [],
				],
			],
		],
		...
	],

P2Y2Things gives you the option of loading assets from the official CDNs. Just put this into common/config/params.php...

	'p2m' => [
		'assets' => [
			'useStatic' => true, // false or not set to use published assets
		],
	],

When things are set up to your liking, register the P2CoreAsset with...

	p2m\assets\P2CoreAsset::register($this);

...& you get

• Jquery (as p2m\assets\JqueryAsset),
• yii\web\YiiAsset (as p2m\assets\P2YiiAsset),
• Bootstrap (as p2m\assets\BootstrapAsset), &
• Font Awesome (as p2m\assets\FontAwesomeAsset)

nicely loaded in one line.