emoji-catalog/README.md

98 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

2022-02-08 23:06:21 +01:00
# Emoji catalog 📔
2019-08-30 21:22:51 +02:00
2024-09-20 09:31:51 +02:00
Get access to +3700 emojis as class constants.
2019-08-30 21:22:51 +02:00
Features:
- 🍰 Dead easy to use
2019-08-31 20:39:34 +02:00
- 🤩 A lot of emojis
- 🔓 Zero dependencies
2019-08-30 21:22:51 +02:00
2020-02-20 21:08:28 +01:00
You can see the [full emoji list].
2019-10-01 23:08:31 +02:00
2019-08-30 21:22:51 +02:00
[![Latest Stable Version](https://poser.pugx.org/jawira/emoji-catalog/v/stable)](https://packagist.org/packages/jawira/emoji-catalog)
[![License](https://poser.pugx.org/jawira/emoji-catalog/license)](https://packagist.org/packages/jawira/emoji-catalog)
2022-02-08 23:06:21 +01:00
## Usage
2019-08-30 21:22:51 +02:00
You have access to emojis as `\Jawira\EmojiCatalog\Emoji` constants:
```php
<?php
use Jawira\EmojiCatalog\Emoji;
echo Emoji::GRINNING_FACE; // 😀
echo Emoji::SOCCER_BALL; // ⚽
echo Emoji::HOURGLASS_DONE; // ⌛
echo Emoji::EJECT_BUTTON; // ⏏
```
2022-02-08 23:06:21 +01:00
Your favorite IDE should give you autocomplete since you are simply calling
2019-08-31 20:39:34 +02:00
class constants:
2019-08-30 21:22:51 +02:00
![Autocomplete](docs/images/autocomplete.png)
2022-02-08 23:06:21 +01:00
## How to install
2019-08-30 21:22:51 +02:00
2024-09-20 09:31:51 +02:00
```console
composer require jawira/emoji-catalog
2019-08-30 21:22:51 +02:00
```
2022-02-08 23:06:21 +01:00
## Emoji sequences
2020-09-18 12:46:44 +02:00
2022-02-08 23:06:21 +01:00
An _emoji sequence_ is an emoji composed of other emojis. For example the
character "👨‍👩‍👧" is composed of five characters: _U+1F468 U+200D U+1F469
U+200D U+1F467_.
2020-09-18 12:46:44 +02:00
2022-02-08 23:06:21 +01:00
You don't need to compose your emojis, _jawira/emoji-catalog_ comes with all
2020-09-18 12:46:44 +02:00
possible sequences as class constants:
```php
echo Emoji::FAMILY_MAN_WOMAN_GIRL; // 👨‍👩‍👧
```
2022-02-08 23:06:21 +01:00
## Contributing
2019-08-30 21:22:51 +02:00
2022-02-08 23:06:21 +01:00
- If you liked this project, ⭐ star it on [GitHub]
. [![GitHub Repo stars](https://img.shields.io/github/stars/jawira/emoji-catalog?style=social)][GitHub]
- Or follow me on
Twitter. [![Twitter Follow](https://img.shields.io/twitter/follow/jawira?style=social)](https://twitter.com/jawira)
2019-08-30 21:22:51 +02:00
2022-02-08 23:06:21 +01:00
## License
2019-08-30 21:22:51 +02:00
This library is licensed under the [MIT license](LICENSE.md).
[GitHub]: https://github.com/jawira/emoji-catalog
2022-02-08 23:06:21 +01:00
2020-02-20 21:08:28 +01:00
[full emoji list]: https://github.com/jawira/emoji-catalog/blob/master/docs/catalog.md
2019-08-30 21:22:51 +02:00
***
2022-02-08 23:06:21 +01:00
## Packages from jawira
2019-08-30 21:22:51 +02:00
<dl>
2020-09-21 09:07:01 +02:00
<dt>
<a href="https://packagist.org/packages/jawira/plantuml">jawira/plantuml
<img alt="GitHub stars" src="https://badgen.net/github/stars/jawira/plantuml?icon=github"/></a>
</dt>
<dd>Provides PlantUML executable and plantuml.jar</dd>
<dt>
<a href="https://packagist.org/packages/jawira/plantuml-encoding"> jawira/plantuml-encoding
<img alt="GitHub stars" src="https://badgen.net/github/stars/jawira/plantuml-encoding?icon=github"/></a>
</dt>
<dd>PlantUML encoding functions.</dd>
<dt>
<a href="https://packagist.org/packages/jawira/case-converter">jawira/case-converter
<img alt="GitHub stars" src="https://badgen.net/github/stars/jawira/case-converter?icon=github"/></a>
</dt>
<dd>Convert strings between 13 naming conventions: Snake case, Camel case,
Pascal case, Kebab case, Ada case, Train case, Cobol case, Macro case,
Upper case, Lower case, Sentence case, Title case and Dot notation.
</dd>
<dt><a href="https://packagist.org/packages/jawira/">More...</a></dt>
2019-08-30 21:22:51 +02:00
</dl>