Merge branch 'master' into omnibox

.eslintrc

@@ -93,7 +93,7 @@
                 "Number": "number",
                 "object": "Object",
                 "String": "string",
-                "HTMLElement": "HTMLElement"
+                "HtmlElement": "HTMLElement"
             },
             "requireReturnType": true,
             "matchDescription": ".+",

CONTRIBUTING.md

@@ -4,6 +4,17 @@ As I do not want to duplicate the instructions all over, please **find the commo
 
 Some links and potential special rules for this repo only are listed below.
 
+## Support us!
+
+You like this add-on, but have no idea how to support us?
+
+Here are some easy things you can always do:
+* Spread the word and recommend it to others! 🤗😍
+* Leave a rating [at addons.mozilla.org](https://addons.mozilla.org/firefox/addon/mastodon-simplified-federation/reviews/) if you like it!
+  Also consider writing some text and not only leaving stars there. It's always nice to hear some warm words. ☺️
+* Star this project [on GitHub](https://github.com/rugk/awesome-emoji-picker) by clicking the "star" icon!
+* Leave a [review at alternativeto.net](https://alternativeto.net/software/-awesome-emoji-picker-/reviews/) and click the like button there, if you want. (Also, you can obviously recommend this add-on as an alternative to other emoji pickers.)
+
 ## Translations
 
 * Direct link to online translator: [Web-Ext-Translator for this add-on](https://lusito.github.io/web-ext-translator/?gh=https://github.com/rugk/awesome-emoji-picker).
@@ -13,7 +24,23 @@ Some links and potential special rules for this repo only are listed below.
 * Wiki to translate: [wiki](/wiki)
 * Sidebar file for adding language: [`_Sidebar` file](/wiki/_Sidebar/_edit)
 
-### Coding guidelines
+### Translating emoji terms (categories, skin names etc.)
+
+**Big tip** for translators: If you translate the `emojiMart*` entries, notice that you will likely find correct translations somewhere for these specific emoji terms.
+
+Actually, it's standardized, because emojis are also standardized. It's Unicode, after all!
+
+So the point to look for correct translations is the Unicode [Common Locale Data Repository](http://cldr.unicode.org/) (**CLDR**, see [their Wikipedia entry](https://en.wikipedia.org/wiki/Common_Locale_Data_Repository)). You can download the data there and then try to find the correct term. (I did that, and I know it's hard to find, but yes, it must be somewhere in there!)
+
+You can also try to use [the survey tool](https://st.unicode.org/cldr-apps/v#locales///) and look in the section “Characters”:
+
+![sidebar: after units, there is an entry called characters, with sub-entries like category, smileys and emojis etc.](./assets/l10n-help-cldr-survey-tool-emojis.png)
+
+Related:
+* [discussion at emoji-mart of whether to bundle the translations inside of the library](https://github.com/missive/emoji-mart/issues/303)
+* [same discussion for their upstream project emoji-data](https://github.com/iamcal/emoji-data/issues/148)
+
+## Coding guidelines
 
 * [editorconfig file](.editorconfig)
 

CONTRIBUTORS

@@ -1,5 +1,5 @@
 @mcorwin22
 
 translations:
+French: Nicolas TROUIN (@nicolas-trouin), Prometheos II (@Prometheos2)
 German: @rugk
-Turkish: Ömür Turan (@omurturan)

README.md

@@ -1,36 +1,64 @@
-# Awesome Emoji Picker <img align="right" height="425" width="365" src="assets/screenshots/emoji-picker.png">
+# Awesome Emoji Picker <img align="right" height="425" width="365" src="assets/screenshots/popupSelectFemaleDetective.png">
 
 [![Mozilla Add-on version](https://img.shields.io/amo/v/awesome-emoji-picker.svg)](https://addons.mozilla.org/firefox/addon/awesome-emoji-picker/?src=external-github-shield-downloads)  
 [![Mozilla Add-on downloads](https://img.shields.io/amo/d/awesome-emoji-picker.svg)](https://addons.mozilla.org/firefox/addon/awesome-emoji-picker/?src=external-github-shield-downloads)
 [![Mozilla Add-on users](https://img.shields.io/amo/users/awesome-emoji-picker.svg)](https://addons.mozilla.org/firefox/addon/awesome-emoji-picker/statistics/)
 [![Mozilla Add-on stars](https://img.shields.io/amo/stars/awesome-emoji-picker.svg)](https://addons.mozilla.org/firefox/addon/awesome-emoji-picker/reviews/)
 
-This (Firefox) add-on (WebExtension) gives you a nice emoji picker that you can use to find and select emojis. It will be copied to your clipboard, when you click on it.
+This (Firefox) add-on (WebExtension) gives you a modern emoji picker that you can use to find and select emojis (i.e. the emoticons/smileys you know from messengers such as 😃, 😎 or 🤪). It will be directly copied to your clipboard and/or inserted into the active input on the page, when you choose it.
 
-It uses up-to-date Emojis and let's you access your Emojis in different styles you know from different devices and applications.
+You can then use the emojis on almost any web page, including your favorite messenger (such as WhatsApp, Telegram, Threema, Signal, Wire etc.), social media (Facebook, Instagram, Twitter, Mastodon etc.) and even e-mails.
+
+It will remember your recently used emojis across sites, and may often be faster than the emoji picker on the site itself.
+
+It uses up-to-date Emojis and let's you access your Emojis in different styles you know from different devices and applications. Here is a list of styles, it supports:
+* Apple emojis
+* Google emojis
+* Twitter emojis ([Twemoji](https://twemoji.twitter.com/))
+* EmojiOne emojis (now [JoyPixels](https://www.joypixels.com/))
+* or just what your system/browser offers (e.g. on Windows thus Windows emojis will be used)
 
 It is based on the awesome [emoji-mart](https://missive.github.io/emoji-mart/). You can test many features there already, before installing it.
 
-This extension only works with modern Firefox v63 or higher.
+This extension only works with Firefox v63 or higher.
 
 ## Download
 
 **[![Get it for Firefox!](https://addons.cdn.mozilla.net/static/img/addons-buttons/AMO-button_1.png)](https://addons.mozilla.org/firefox/addon/awesome-emoji-picker/?src=external-github-download)**
 
-<!-- ## In action…
+## How to support us?
+
+You don't need to be able to write code to support this project!
+You can e.g. **review and like the add-on** or this GitHub repo, you can add translations or do documentation tasks.
+
+See the [contributing guidelines](CONTRIBUTING.md) for more information on how you can help and vote for this browser extension.
 
-![what shows this screencast description in alt text](assets/screencasts/someThing.gif) -->
+In any case, spread the word and recommend it to others! 🤗😍
 
-<!-- See:
+## In action…
+
+![Writing toot on Mastodon with text "Let's search for an emoji…", click on smiley icon, emoji picker opens, search for "banan" and a banana 🍌 and monkey 🐒 emoji are shown as results. After clicking on banana emoji it inserts it into the message.](assets/screencasts/searchBanana.gif)
+
+See:
 * [More screencasts](assets/screencasts)
-* [More screenshots](assets/screenshots) -->
+* [More screenshots](assets/screenshots)
 
 ## Features
 * Display the emojis in the design of Apple, Google, Twitter, EmojiOne or just the native style your browser uses.
-* Quickly search for any emoji.
-* Adjust many options of your Emoji picker!
-* Follows [Firefox Photon Design](https://design.firefox.com/photon).
-* Has a simple, but intuitive and usable User Interface.
+* Quickly search for any emoji with many keywords.
+* Copy emoji to your clipboard.
+* …or directly insert it into the page.
+* Remembers frequently used emojis.
+* Emoji skin tone is adjustable and is remembered.
+* You can also insert the emoji's `:colon:` syntax instead of the Unicode emoji that is used by default.
+* Use the hot key (by default <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Period</kbd>) to quickly access the emoji picker.
+* Integrates into Firefox Sync, so you have all your emojis/settings on all devices.
+* Adjust the style and many other options to your liking.
+* The size of the whole emoji picker and the emojis itself is also adjustable.
+* Use a colored toolbar icon or a decent monochrome (black/white) one.
+* Follows the [Firefox Photon Design](https://design.firefox.com/photon).
+* It does not violate your privacy and does send data anywhere.
+* Compatible with Firefox for Android
+* Translated in English and German already. [Contribute your own language!](CONTRIBUTING.md#Translations)
 * Compatible with Firefox for Android
-* […]
-<!-- * Translated in English and German already. [Contribute your own language!](CONTRIBUTING.md#Translations) -->
+* Settings can be managed by your administrator. (see [issue #4](https://github.com/rugk/awesome-emoji-picker/issues/4))