# php-emoji - Process Emoji in PHP and display them as HTML

This is a PHP library for dealing with mobile device Emoji.

You can read more about it and see a demo here:<br>
<a href="http://code.iamcal.com/php/emoji/">http://code.iamcal.com/php/emoji/</a>

It is based on a Ruby library here:<br>
<a href="http://www.bitcontrol.org/2009/10/18/emoji-rubygem-for-iphone-softbank-ntt-docomo-kddi/">http://www.bitcontrol.org/2009/10/18/emoji-rubygem-for-iphone-softbank-ntt-docomo-kddi/</a>

And data from Unicode here:<br>
<a href="http://www.unicode.org/~scherer/emoji4unicode/snapshot/full.html">http://www.unicode.org/~scherer/emoji4unicode/snapshot/full.html</a>

**Important note:** As of iOS 6, the iPhone uses unified codepoints. You no longer need to do any conversion at input/output time, unless
you want to convert it to HTML for viewing on PCs, Android phones, older Macs, etc.


## USAGE

    <?php
        include('emoji.php');


        # when you recieve text from a mobile device, convert it
        # to the unified format.

        $data = tt_emoji_docomo_to_unified($data);   # DoCoMo devices
        $data = tt_emoji_kddi_to_unified($data);     # KDDI & Au devices
        $data = tt_emoji_softbank_to_unified($data); # Softbank & pre-iOS6 Apple devices
        $data = tt_emoji_google_to_unified($data);   # Google Android devices


        # when sending data back to mobile devices, you can
        # convert back to their native format.

        $data = emoji_unified_docomo($data);   # DoCoMo devices
        $data = emoji_unified_kddi($data);     # KDDI & Au devices
        $data = emoji_unified_softbank($data); # Softbank & pre-iOS6 Apple devices
        $data = emoji_unified_google($data);   # Google Android devices


        # when displaying data to anyone else, you can use HTML
        # to format the emoji.

        $data = tt_emoji_unified_to_html($data);

        # if you want to use an editor(i.e:wysiwyg) to create the content, 
        # you can use html_to_unified to store the unified value.

        $data = tt_emoji_html_to_unified(tt_emoji_unified_to_html($data));
    ?>

When using the HTML format, you'll also need to include the <code>emoji.css</code> file, which points 
to the <code>emoji.png</code> image. These images come from the <a href="https://github.com/github/gemoji">gemoji</a> 
project and cover all current codepoints, except U+1F320, Shooting Star.

IMPORTANT NOTE: This library currently only deals with UTF-8. If your source data is JIS
or Shift-JIS, you're out of luck for the moment.


## CREDITS

By Cal Henderson <cal@iamcal.com>

Parser rewrite based on a fork by <a href="https://github.com/dulao5">&#26460;&#24535;&#21018;</a>

This work is licensed under the GPL v3

Image copyrights: https://github.com/github/gemoji/blob/master/LICENSE

Version 1 released on 2009-10-20