{"id":19300662,"url":"https://github.com/fantomas42/django-emoticons","last_synced_at":"2025-04-22T10:31:54.753Z","repository":{"id":612183,"uuid":"250076","full_name":"Fantomas42/django-emoticons","owner":"Fantomas42","description":"A usefull and incredible Django application that allow you to use emoticons in your templates :)","archived":false,"fork":false,"pushed_at":"2020-05-01T17:39:19.000Z","size":206,"stargazers_count":27,"open_issues_count":4,"forks_count":7,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2024-08-11T08:09:27.823Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Fantomas42.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2009-07-13T15:30:35.000Z","updated_at":"2022-01-23T06:41:32.000Z","dependencies_parsed_at":"2022-08-06T09:16:09.054Z","dependency_job_id":null,"html_url":"https://github.com/Fantomas42/django-emoticons","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fantomas42%2Fdjango-emoticons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fantomas42%2Fdjango-emoticons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fantomas42%2Fdjango-emoticons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fantomas42%2Fdjango-emoticons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Fantomas42","download_url":"https://codeload.github.com/Fantomas42/django-emoticons/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223892994,"owners_count":17220834,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T23:15:27.333Z","updated_at":"2024-11-09T23:15:28.001Z","avatar_url":"https://github.com/Fantomas42.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"==========================\ndjango-emoticons |mrgreen|\n==========================\n\n|travis-develop| |coverage-develop|\n\nDjango-emoticons is a django application providing utilities to add\n*emoticons* in your templates. Pretty incredible no?\n\n.. contents::\n\nInstall\n=======\n\nOnce you have installed the package in your *PYTHON_PATH*, register the\n**emoticons** and **django.contrib.staticfiles** apps in your\n*INSTALLED_APPS* project's section. ::\n\n  INSTALLED_APPS = (\n    ...\n    'django.contrib.staticfiles',\n    'emoticons',\n    ...\n  )\n\nUsage\n=====\n\nFilter Usage\n------------\n\nFor our example we will make a template who display the field *content* of\na model, this field has this value: ::\n\n  Coding is fun and sexy :D\n\nSo in our templates we will load the **emoticons_tags** library and use the\n**emoticons** filter: ::\n\n  {% load emoticons_tags %}\n\n  {{ object.content|emoticons }}\n\nWhich will render:\n\n  Coding is fun and sexy |smile|\n\nTag Usage\n---------\n\nThe emoticons app also provides a tag named **emoticons** for converting raw\ntext. ::\n\n  {% load emoticons_tags %}\n  {% emoticons %}\n  Documenting is boring but usefull :p\n  {% endemoticons %}\n\nWhich will render :\n\n  Documenting is boring but usefull |razz|\n\nExcluding content within specific markup: ::\n\n  {% load emoticons_tags %}\n  {% emoticons \"h3\" %}\n  \u003ch3\u003eSerious title :[\u003c/h3\u003e\n  \u003cp\u003eDocumenting is boring but usefull :p\u003c/p\u003e\n  {% endemoticons %}\n\nWhich will render :\n\n  Serious title :[\n  Documenting is boring but usefull |razz|\n\n\nIndex\n-----\n\nIf you want to retrieve a list of all availables emoticons you can use the\n**emoticons_index** tag. ::\n\n  {% load emoticons_tags %}\n  {% emoticons_index as emoticons_list %}\n  {% for emoticons in emoticons_list %}\n  \u003cp\u003e{{ emoticons.0|emoticons }}: {{ emoticons|join:\" \" }}\u003c/p\u003e\n  {% endfor %}\n\nSettings\n========\n\nYou can use differents settings for customizing the application:\n\n* EMOTICONS_DIRECTORY\n\n  The directory where the emoticons files are located, use ``'emoticons'``\n  as default.\n\n* EMOTICONS_LIST\n\n  The list of the emoticons used by the application, something like this: ::\n\n    (('(devil)', 'devil.gif'),\n     ('(angel)', 'angel.gif'),\n     ((':)', ':-)', ':=)', '(smile)'), 'smile.gif'),\n     ((':(', ':-(', ':=(', '(sad)'), 'sadsmile.gif'),\n    )\n\nIf the HTML code of the emoticons does not fit to your needs, you can\noverride the ``'emoticons/emoticon.html'`` template to adjust it.\n\n.. |razz| image:: https://blog.fantomas.site/static/emoticons/tongueout.gif\n.. |smile| image:: https://blog.fantomas.site/static/emoticons/bigsmile.gif\n.. |mrgreen| image:: https://blog.fantomas.site/static/emoticons/cool.gif\n.. |travis-develop| image:: https://travis-ci.org/Fantomas42/django-emoticons.png?branch=develop\n   :alt: Build Status - develop branch\n   :target: http://travis-ci.org/Fantomas42/django-emoticons\n.. |coverage-develop| image:: https://coveralls.io/repos/Fantomas42/django-emoticons/badge.png?branch=develop\n   :alt: Coverage of the code\n   :target: https://coveralls.io/r/Fantomas42/django-emoticons\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffantomas42%2Fdjango-emoticons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffantomas42%2Fdjango-emoticons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffantomas42%2Fdjango-emoticons/lists"}