updated libs, removal of premium assets, addition of examples docs

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-##How to contribute to the Emoji One library
+##How to contribute to the EmojiOne library
 ---
 ###code format
 * Try to maintain the general code convention currently found in the library.
@@ -9,8 +9,8 @@
 * Include a brief description of the issue and how your patch will solve it.
 * If there are tests available in the library run your patch through them before submitting your pull request. If no tests are available in the library test the patch as thoroughly as possible before submitting.
 
-###emoji art (PNG & SVG)
-* We unfortunately cannot accept submissions for emoji art revisions. Due to the copyright of the art and the potential for it's licensing in different situations this isn't possible.  
+###emoji art
+* We unfortunately cannot accept submissions for emoji art revisions. Due to the copyright of the art and the potential for its licensing in different situations this isn't possible.  
 * Design suggestions are welcome. They will be considered by the designers. There's no guarantee they will be adopted. 
 * Notes on visual errors are also accepted.
 * Both can be submitted through the contact form at http://emojione.com/contact/  
@@ -19,4 +19,4 @@
 Thank you for your interest in contributing to this library.
 
 Regards,  
-Emoji One Team
+EmojiOne Team

INSTALLATION.md

@@ -0,0 +1,33 @@
+### Installation
+
+We've teamed up with [JSDelivr](http://www.jsdelivr.com/#!emojione) to provide a simple way to install these emoji on any javascript-enabled website. Add the following script and stylesheet links to the head of your webpage:
+
+```
+<script src="https://cdn.jsdelivr.net/emojione/3.0/lib/js/emojione.min.js"></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/emojione/3.0/assets/css/emojione.min.css"/>
+```
+
+Alternatively, CDNjs is also available as a [CDN Host for EmojiOne](https://cdnjs.com/libraries/emojione).
+
+Quick installs can also be done using NPM and Bower (for the Javascript toolkit) or Composer (for the PHP toolkit).
+
+#### NPM
+```
+> npm install emojione
+```
+
+#### Bower
+```
+> bower install emojione
+```
+
+
+#### Composer
+```
+$ composer require emojione/emojione
+```
+
+#### Meteor
+```
+meteor add emojione:emojione
+```

LICENSE.md

@@ -1,6 +1,6 @@
 #### EmojiOne Artwork
 
-*  Applies to all PNG and SVG files as well as any adaptations made.
+*  Applies to all PNG files found in emojione repo as well as any adaptations made.
 *  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

README.md

@@ -15,166 +15,7 @@ When storing user inputted text in your database, say from a guestbook or throug
 #### _What are Shortnames?_
 
  Shortnames are semi-standardized human-readable identifiers for each emoji icon. Many online web applications will accept these shortnames as alternatives for the actual unicode character. We've compiled the full list over at [emoji.codes](http://emoji.codes/) with quick copy & search functions.
-
-
-
-
-## Installation
-
-We've teamed up with [JSDelivr](http://www.jsdelivr.com/#!emojione) to provide a simple way to install these emoji on any javascript-enabled website. Add the following script and stylesheet links to the head of your webpage:
-
-```
-<script src="https://cdn.jsdelivr.net/emojione/2.2.7/lib/js/emojione.min.js"></script>
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/emojione/2.2.7/assets/css/emojione.min.css"/>
-```
-
-Alternatively, CDNjs is also available as a [CDN Host for EmojiOne](https://cdnjs.com/libraries/emojione).
-
-Quick installs can also be done using NPM and Bower (for the Javascript toolkit) or Composer (for the PHP toolkit).
-
-#### NPM
-```
-> npm install emojione
-```
-
-#### Bower
-```
-> bower install emojione
-```
-
-
-#### Composer
-```
-$ composer require emojione/emojione
-```
-
-#### Meteor
-```
-meteor add emojione:emojione
-```
-
-
-## Usage Examples
-
-Below there are some examples of how you will actually use the libraries to convert Unicode emoji characters to :shortnames: and :shortnames: to emoji images.
-
-
-### Javascript Conversion
-
-
-**[.toShort\(str\)](http://git.emojione.com/demos/latest/jstoshort.html)** - _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\)](http://git.emojione.com/demos/latest/jsshortnametoimage.html)** - _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\)](http://git.emojione.com/demos/latest/jsunicodetoimage.html)** - _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\)](http://git.emojione.com/demos/latest/jstoimage.html)** - _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.
-
-
-### PHP Conversion
-
-##### As of version 1.4.1 this library syntax has changed.
-
-**[toShort\($str\)](http://git.emojione.com/demos/latest/phptoshort.php)** - _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\)](http://git.emojione.com/demos/latest/phpshortnametoimage.php)** - _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\)](http://git.emojione.com/demos/latest/phpunicodetoimage.php)** - _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\)](http://git.emojione.com/demos/latest/phptoimage.php)** - _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.
-
-
-##### Note: As of version 1.4.1 the following implementation has been deprecated. It's included in the library for backwards compatibility but will be removed at a later date.
-
-**[::toShort\($str\)](http://git.emojione.com/demos/1.4.0/phptoshort.php)** - _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\)](http://git.emojione.com/demos/1.4.0/phpshortnametoimage.php)** - _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\)](http://git.emojione.com/demos/1.4.0/phpunicodetoimage.php)** - _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\)](http://git.emojione.com/demos/1.4.0/phptoimage.php)** - _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.
-
-### Meteor Conversion
-
-#### Template helpers
-
-```handlebars
-My emoji {{> emojione ':beers:'}} text.
-```
-
-Or
-
-```handlebars
-{{#emojione}}My emoji :beers: text.{{/emojione}}
-```
-
-### Swift Conversion
-
-```swift
-Emojione.transform(string: "Rocket.Chat: :rocket:")
-```
-
-### Extras
-
-**[shortnameToUnicode(str)](http://git.emojione.com/demos/latest/shortnametounicode.html)**
-
-Change from shortnames to native unicode emoji.
-
-**[Shortname Autocomplete](http://git.emojione.com/demos/latest/autocomplete.html)**
-
-Easily add shortname autocomplete functionality to any text input on your page.
-
-**[ASCII Smiley Conversion](http://git.emojione.com/demos/latest/ascii-smileys.html)**
-
-With one quick step you can start converting common ASCII smileys to their corresponding images.
-
-**[Alternate Alt Tags](http://git.emojione.com/demos/latest/alternate-alt-tags.html)**
-
-Change from the native unicode emoji in the resulting alt tags to their shortnames instead.
-
-**[Live Preview Box](http://git.emojione.com/demos/latest/live-preview.html)**
-
-Display converted Emoji in a preview box as the user is typing.
-
-**[Conversion HTML Class](http://git.emojione.com/demos/latest/class-convert.html)**
-
-Stick a class of .emojione-convert on any HTML element and automatically convert native unicode emoji and/or shortnames to images after page load.
-
-**[Convert on Form Submission](http://git.emojione.com/demos/latest/convert-on-submit.html)**
-
-Converts unicode input to shortnames once the user submits the form.
-
-**[Sprites (PNG)](http://git.emojione.com/demos/latest/sprites-png.html)**
-
-With an additional CSS file you can use EmojiOne as resizable PNG sprites (up to 64x64).
-
-**[Sprites (SVG)](http://git.emojione.com/demos/latest/sprites-svg.html)**
-
-This sprite method requires no extra CSS, and is infinitely resizable.
+
 
 
 ## Other Considerations
@@ -215,25 +56,4 @@ We sincerely hope that you choose to use EmojiOne and support our project, but i
 * https://github.com/steveklabnik/emoji
 * https://github.com/rockerhieu/emojicon
 * https://github.com/HenrikJoreteg/emoji-images
-* https://github.com/frissdiegurke/emoji-parser
-
-## 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: 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
+* https://github.com/frissdiegurke/emoji-parser

UPGRADE.md

@@ -0,0 +1,4 @@
+#### Upgrading from emojione v2 to emojione v3
+
+*  emojione v3 brings about several breaking changes and new considerations
+*  please review EmojiOne Licensing for more information on using SVG or PNG (larger than 128px) assets

USAGE.md

@@ -0,0 +1,121 @@
+## Usage Examples
+
+Below there are some examples of how you will actually use the libraries to convert Unicode emoji characters to :shortnames: and :shortnames: to emoji images.
+
+
+### Javascript Conversion
+
+
+**[.toShort\(str\)](https://demos.emojione.com/latest/jstoshort.html)** - _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\)](https://demos.emojione.com/latest/jsshortnametoimage.html)** - _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\)](https://demos.emojione.com/latest/jsunicodetoimage.html)** - _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\)](https://demos.emojione.com/latest/jstoimage.html)** - _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.
+
+
+### PHP Conversion
+
+##### As of version 1.4.1 this library syntax has changed.
+
+**[toShort\($str\)](https://demos.emojione.com/latest/phptoshort.php)** - _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\)](https://demos.emojione.com/latest/phpshortnametoimage.php)** - _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\)](https://demos.emojione.com/latest/phpunicodetoimage.php)** - _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\)](https://demos.emojione.com/latest/phptoimage.php)** - _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.
+
+
+##### Note: As of version 1.4.1 the following implementation has been deprecated. It's included in the library for backwards compatibility but will be removed at a later date.
+
+**[::toShort\($str\)](https://demos.emojione.com/1.4.0/phptoshort.php)** - _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\)](https://demos.emojione.com/1.4.0/phpshortnametoimage.php)** - _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\)](https://demos.emojione.com/1.4.0/phpunicodetoimage.php)** - _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\)](https://demos.emojione.com/1.4.0/phptoimage.php)** - _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.
+
+### Meteor Conversion
+
+#### Template helpers
+
+```handlebars
+My emoji {{> emojione ':beers:'}} text.
+```
+
+Or
+
+```handlebars
+{{#emojione}}My emoji :beers: text.{{/emojione}}
+```
+
+### Swift Conversion
+
+```swift
+Emojione.transform(string: "Rocket.Chat: :rocket:")
+```
+
+### Extras
+
+**[shortnameToUnicode(str)](https://demos.emojione.com/latest/shortnametounicode.html)**
+
+Change from shortnames to native unicode emoji.
+
+**[Shortname Autocomplete](https://demos.emojione.com/latest/autocomplete.html)**
+
+Easily add shortname autocomplete functionality to any text input on your page.
+
+**[ASCII Smiley Conversion](https://demos.emojione.com/latest/ascii-smileys.html)**
+
+With one quick step you can start converting common ASCII smileys to their corresponding images.
+
+**[Alternate Alt Tags](https://demos.emojione.com/latest/alternate-alt-tags.html)**
+
+Change from the native unicode emoji in the resulting alt tags to their shortnames instead.
+
+**[Live Preview Box](https://demos.emojione.com/latest/live-preview.html)**
+
+Display converted Emoji in a preview box as the user is typing.
+
+**[Conversion HTML Class](https://demos.emojione.com/latest/class-convert.html)**
+
+Stick a class of .emojione-convert on any HTML element and automatically convert native unicode emoji and/or shortnames to images after page load.
+
+**[Convert on Form Submission](https://demos.emojione.com/latest/convert-on-submit.html)**
+
+Converts unicode input to shortnames once the user submits the form.
+
+**[Sprites (PNG)](https://demos.emojione.com/latest/sprites-png.html)**
+
+With an additional CSS file you can use EmojiOne as resizable PNG sprites (up to 64x64).
+
+**[Sprites (SVG)](https://demos.emojione.com/latest/sprites-svg.html)**
+
+This sprite method requires no extra CSS, and is infinitely resizable.