granam / emojione-micro
Extracted Emoji One CSS and converters in PHP / Python / JS / Meteor / Awesome font.
Requires
- php: >=5.3
Requires (Dev)
- phpunit/phpunit: ~4.6 || ~5.0
This package is auto-updated.
Last update: 2024-11-27 00:11:01 UTC
README
# EmojiOne
bringing you emojione.com & emoji.codes
The web's first and only complete open source emoji set. It is 100% free and super easy to integrate.
Just an extraction
This library provides only CSS to style EmojiOne and tools in few languages to convert HTML-to-image-and-back.
Workflow
- convert an UTF-8 emoji 😎 into its Emoji One image equivalent
by one of conversion methods
- style it with provided CSS
- let download images from public CDN JSDelivr (Emoji One official partner)
- be happy
Installation
Composer
$ composer require granam/emojione-micro
Note about namespace
The original Emojione namespace is used to provide compatibility and made eventual switch to original library easier.
Where is the original?
This library is just an extraction of large official library of version 2.2.7
(original latest version is ).
Whatever you think you need, you will find it there.
PHP Usage Examples
toShort($str) - native unicode -> shortnames
This demo shows you how to take native unicode emoji input, such as that from your mobile device, and translate it to their corresponding shortnames. (we recommend this for database storage)
shortnameToImage($str) - shortname -> images
This demo shows you how to take input containing only shortnames and translate it directly to EmojiOne images. (when displaying the unified input to clients)
unicodeToImage($str) - native unicode -> images
This demo shows you how to take native unicode emoji input, such as that from your mobile device, and translate it directly to EmojiOne images. (would be great for a live editor preview)
toImage($str) - native unicode + shortnames -> images (mixed input)
This demo shows you how to take input containing both native unicode emoji and shortnames, and translate it into EmojiOne images for display.
Licenses
EmojiOne Artwork
- Applies to all PNG and SVG files as well as any adaptations made.
- The following applies to artwork included in EmojiOne GitHub libraries versions < 2.0.0.
- License: Creative Commons Attribution-ShareAlike 4.0 International
- Human Readable License: http://creativecommons.org/licenses/by-sa/4.0/
- Complete Legal Terms: http://creativecommons.org/licenses/by-sa/4.0/legalcode
- The following applies to artwork included in EmojiOne GitHub libraries versions >= 2.0.0.
- License: Creative Commons Attribution 4.0 International
- Human Readable License: http://creativecommons.org/licenses/by/4.0/
- Complete Legal Terms: http://creativecommons.org/licenses/by/4.0/legalcode
EmojiOne Non-Artwork
- Applies to the Javascript, JSON, PHP, CSS, HTML files, and everything else not covered under the artwork license above.
- License: MIT
- Complete Legal Terms: http://opensource.org/licenses/MIT