django-emoticons 0.1.1

Install

Install the package in your PYTHON_PATH by getting the sources and run setup.py or use pip:

$ pip install -e git://github.com/Fantomas42/django-emoticons.git#egg=django-emoticons

Then register the emoticons app in your INSTALLED_APPS project’s section.

Examples

Coding is fun and sexy :D

{% load emoticon_tags %}

{{ object.content|emoticons }}

{% load emoticon_tags %}
{% emoticons %}
Documenting is boring but usefull :p
{% endemoticons %}

Settings

You can use differents settings for customizing the application:

• EMOTICONS_URL

  The url where the emoticons files are located, use this as default.:

  os.path.join(settings.MEDIA_URL, 'emoticons/'))

• EMOTICONS_CLASS

  The class wo will be applied to the img markup of the emoticons.

• EMOTICONS_LIST

  The list of the emoticons who will be converted. It’s something like that:

  ((':)', 'smile.gif'),
   (':D', 'mrgreen.gif'),
   (':(', 'sad.gif'),
   (':|', 'neutral.gif'),
   (';)', 'wink.gif'),
   (':p', 'razz.gif'),
   (':P', 'razz.gif'),
   (':o', 'surprised.gif'),
   (':O', 'surprised.gif'),
   (':s', 'confused.gif'),
   (':S', 'confused.gif'),
   (':$', 'confused.gif'),
   ('o_O', 'eek.gif'),
   )

Of course the package does not provide the images, is your job to find and set them in your project.