Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 1.81 KB

INSTALLATION.md

File metadata and controls

37 lines (25 loc) · 1.81 KB

Installation

We've teamed up with JSDelivr 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/npm/[email protected]/lib/js/joypixels.min.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/extras/css/joypixels.min.css"/>

Quick installs can also be done using NPM and Bower (for the Javascript toolkit) or Composer (for the PHP toolkit). If you wish to serve image assets locally you'll need to install emoji-assets and include the pngs and/or sprites into your project. Many of our demos use assets locally simply by pointing the imagePathPNG variable to your local asset location.

NPM

> npm install emoji-toolkit

Composer

$ composer require joypixels/emoji-toolkit

Meteor

meteor add joypixels:emoji-toolkit

Version 2 Installation

JoyPixels version 2 is no longer supported or distributed.

Character Encoding — UTF-8

If you're getting serious about implementing emoji into your website, you will want to consider your web stack's character encoding. You should make sure that all connection points are using the same encoding. There are a lot of options and configuration possibilities here, so you'll have to figure what works best for your own situation.

A quick Google search will bring up a lot of information on how to get your entire web stack to use UTF-8, which is needed to properly handle Unicode emoji.

To get you started, here's a nice guide: UTF-8: The Secret of Character Encoding.