Coder Social home page Coder Social logo

mrparabol / django-emoji Goto Github PK

View Code? Open in Web Editor NEW

This project forked from gaqzi/django-emoji

0.0 1.0 0.0 4.02 MB

A simple django app to use emojis on your website

Home Page: https://pypi.python.org/pypi/django-emoji

License: MIT License

Makefile 2.07% Python 84.74% JavaScript 12.10% HTML 1.10%

django-emoji's Introduction

django-emoji

https://travis-ci.org/gaqzi/django-emoji.png?branch=master https://coveralls.io/repos/gaqzi/django-emoji/badge.png Latest Version Downloads Python versions Package status

Emoji is a port of the GitHub gem gemoji to Django.

This app got two main use cases:

  1. It'll try to replace items between :: with emojis, for instance : dog : (without the spaces) will become an emoji of a dog (๐Ÿถ).
  2. It'll try to replace unicode characters with emojis, for instance 'โœŒ๏ธ' with a victory symbol (โœŒ๏ธ).

Version 2 release

Thanks to Tim Schilling we now have autoescaping enabled with the same logic as core Django. Because this might be a breaking change for users of this app the major version has been bumped. Apart from the filters adds the standard XSS protection of Django there are no other changes.

To get the old behavior of the app wrap the filter like this:

{% autoescape off %}
{{ emoji|emoji_replace }}
{% endautoescape %}

Quick start

  1. Install django-emoji <https://pypi.python.org/pypi/django-emoji> from PyPi:

    pip install django-emoji
    
  2. Add "emoji" to your INSTALLED_APPS setting like this:

    INSTALLED_APPS = (
        ...
        'emoji',
    )
    
  3. Include the emoji URLconf in your project urls.py like this if you want to be able to get a JSON list of emojis:

    url(r'^emoji/', include('emoji.urls')),
    
  4. Visit http://127.0.0.1:8000/emoji/all.json to get a json object with all emojis avilable

Python versions

Support for Django 1.5, 1.6, 1.7, 1.8 and 1.9 with their respective versions of Python 2/3 support.

Settings

These are settings that can be configured in your settings.py:

Settings name Description
EMOJI_IMG_TAG The template string that is used for creating the <img> tag when converting an emoji to an image. Default: <img src="{0}" alt="{1}" title="{2}" class="emoji">
EMOJI_ALT_AS_UNICODE Whether to put the unicode character that corresponds to an emoji as the alt text in replace_unicode. Default: True
EMOJI_REPLACE_HTML_ENTITIES Whether to automatically convert HTML encoded unicode characters into emojis. Default: True

Usage

API

Python

The Python class Emoji is a singleton and will return the same instance between instantiations. On load Emoji will load the name of all the emojis and their unicode equivalents into memory.

Call Description
Emoji.names() A list of all known emojis
Emoji.replace(replacement_string) Replaces all emojis between ::
Emoji.name_for(character) The name for a given unicode character
Emoji.replace_unicode(replacement_string) Replaces all known unicode emojis
Emoji.replace_html_entities(replacement_string) Replaces all HTML encoded unicode characters

Javascript

The browser version caches all the emojis in localStorage so there won't be that many roundtrips to the server just to get a list of the emojis.

NOTE: Depends on jQuery or some other library that exports $.get.

Call Description
Emoji.setDataUrl(url) Where to fetch the list of all available emojis
Emoji.load() Load all emojis from the server
Emoji.get(/*emoji*/) Get the URL to an emoji of a name or return the names of all known emojis
Emoji.replace(replacementString) Replace all :: style emojis with images
Emoji.clear() Empty the browser cache

Examples

Replace an emoji using Python templates by loading the tags in your template:

{% load emoji_tags %}
{{ blog_post.body|emoji_replace }}
{{ blog_post.body|emoji_replace_unicode }}
{{ blog_post.body|emoji_replace_html_entities }}

Replace emojis using Javascript (to for instance show a preview before the user saves what it is they are writing):

{% load emoji_tags %}

<script src="{% static 'emoji/js/emoji.js' %}"></script>
{% emoji_load %}

Emoji.get('dog') // => url stub to dog emoji or falsy
Emoji.get() // => all emojis available

Emoji.replace("It's raining :cats: and :dogs:.") // => It's raining <img src="..." alt="cats" class="emoji"> and <img src="..." alt="dogs" class="emoji">

What emoji_load does is that it sets the endpoint to retrieve the listing of all the available emojis and thus only works if the emoji urls has been included.

It is the equivalent of doing:

Emoji.setDataUrl('{% url 'emoji:list.json' %}').load();

Which is also available as template stub:

{% include 'emoji/script.html' %}

Usage from inside Python where the Emoji class mimics some of the behavior of a dict:

from emoji import Emoji
Emoji['dog'] # => url stub to dog emoji or None
'dog' in Emoji # => True
Emoji.keys() # => a list of all emojis by name
Emoji.replace("It's raining :cats: and :dogs:") # => It's raining <img src="..." alt="cats" class="emoji"> and <img src="..." alt="dogs" class="emoji">

Replacing unicode Emojis

Emoji has the ability to give you the name of an emoji from a unicode character. It can also replace every instance of emoji characters in a string with their image replacements.

Usage:

>>> from emoji import Emoji
>>> Emoji.name_for(u'\U000148b')
kiss
>>> Emoji.replace_unicode(u'I send a \U0001f48b!')
I send a <img src="/static/emoji/img/kiss.png" alt="kiss" class="emoji">

Note:

For best use of the unicode replacements use a build of Python that was built with wide unicode character support. From version 1.2 there is code added for dealing with unicode surrogate pairs and it should work well on narrow builds. But this has not been production tested so try it out properly. Please report any bugs found.

To test whether you got a narrow or wide build of Python run the following, if you get an exception it means you're running a narrow build.:

>>> print(unichr(0x0001f48b))
ValueError: unichr() arg not in range(0x10000) (narrow Python build)

django-emoji's People

Contributors

gaqzi avatar jrabbit avatar kitsunde avatar nikolas avatar tim-schilling avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.