php-extended/php-emoji-cheat-sheet

A wrapper around the WebpageFX/emoji-cheat-sheet.com emoji repository

Maintainers

Details

gitlab.com/php-extended/php-emoji-cheat-sheet

Homepage

Source

Issues

Installs: 3 839

Dependents: 5

Suggesters: 0

Security: 0

3.1.26 2022-05-14 12:02 UTC

Requires

Requires (Dev)

MIT 9118c6fc4693347616be88c71f339f54120ff3ac

phpwrapperemojisheetcheatWebpageFX

This package is auto-updated.

Last update: 2022-05-14 10:04:03 UTC

README

A wrapper around the WebpageFX/emoji-cheat-sheet.com emoji repository

coverage build status

Installation

The installation of this library is made via composer. Download composer.phar from their website. Then add to your composer.json :

	"require": {
		...
		"php-extended/php-emoji-cheat-sheet": "^3",
		...
	}

Then run php composer.phar update to install this library. The autoloading of all classes of this library is made through composer's autoloader.

Basic Usage

This library gives only one class and the following API:


	use PhpExtended\EmojiCheatSheet\Emoji;

	// method that returns the path on the disk where all the
	// emoji images are located.
	Emoji::getImagesDirectoryPath():string;
	
	// method that returns an array with all the standard
	// emoji (like ":-)") which are to be interpreted as-is
	Emoji::getSupportedStandardEmoji():string[];
	
	// method that returns an array with all the extended
	// emoji (like "happy") which are to be interpreted in
	// a customized wrapper (recommanded : use ":happy:"
	// with a ":<name>:" wrapper
	Emoji::getSupportedExtendedEmoji():string[];
	
	// method that returns the standardized name of the emoji
	// for which we are sure that a file exists
	// returns null if there is no known file for given $emoji
	Emoji::getImageName(string $emoji):string;

This library may be used the following way:


	use PhpExtended\EmojiCheatSheet\Emoji;
	
	$text = '<put the user text with emoji here :happy:>';
	$text = htmlentities($text);
	
	foreach(Emoji::getSupportedExtendedEmoji() as $emoji)
	{
		$replace = '<img src="/path/to/filedir/'.Emoji::getImageName($emoji).'.png" alt="'.$emoji.'">';
		$text = str_replace(':'.$emoji.':', $replace, $text);
	}
	
	echo $text;

License

MIT (See license file).

TODO