Package: djangocms-comments
Add it to your pages without modifying your models. It is highly customizable!Home-page: https://github.com/Nekmo/djangocms-commentsAuthor: NekmoAuthor-email: contacto@nekmo.comLicense: MITDownload-URL: https://github.com/Nekmo/djangocms-comments/archive/master.zipDescription: .. image:: https://img.shields.io/travis/Nekmo/djangocms-comments.svg?style=flat-square&maxAge=2592000:target: https://travis-ci.org/Nekmo/djangocms-comments:alt: Latest Travis CI build status.. image:: https://img.shields.io/pypi/v/djangocms-comments.svg?style=flat-square:target: https://pypi.python.org/pypi/djangocms-comments:alt: Latest PyPI version.. image:: https://img.shields.io/pypi/pyversions/djangocms-comments.svg?style=flat-square:target: https://pypi.python.org/pypi/djangocms-comments:alt: Python versions.. image:: https://img.shields.io/codeclimate/github/Nekmo/djangocms-comments.svg?style=flat-square:target: https://codeclimate.com/github/Nekmo/djangocms-comments:alt: Code Climate.. image:: https://img.shields.io/codecov/c/github/Nekmo/djangocms-comments/master.svg?style=flat-square:target: https://codecov.io/github/Nekmo/djangocms-comments:alt: Test coverage.. image:: https://img.shields.io/requires/github/Nekmo/djangocms-comments.svg?style=flat-square:target: https://requires.io/github/Nekmo/djangocms-comments/requirements/?branch=master:alt: Requirements Status.. role:: strike:class: strikeDjangoCMS Comments==================A comment system for Django CMS unintrusive and easy to use.Add it to your pages without modifying your models. It is highly customizable!These are the principles of Django CMS Comments:- It does not require javascript to work (but it is recommended).- Almost everything is customizable.- Anonymous users can post comments.- It is easy to use and install.- Comments really are in your website.Example: http://nekmo.com/es/blog/demo-page/Installation============You can install DjangoCMS-Comments From **Pypi**::pip install djangocms-comments...Or you can install directly from **source**::git clone https://github.com/Nekmo/djangocms-comments.gitcd djangocms-commentspython setup.py installYou can also install it from **Aldryn cloud**:https://marketplace.django-cms.org/en/addons/browse/djangocms-comments/Optional depends----------------* **user-agents==1.0.1**: Improved description of user agent in the comments.* **pykismet3==0.1.1**: Akismet support.* **aldryn-boilerplates>=0.7.4**: Bootstrap3 theme.All optional depends::pip install user-agents==1.0.1 pykismet3==0.1.1 aldryn-boilerplates>=0.7.4Configuration=============First you need to add ``djangocms_comments`` to your INSTALLED_APPS::INSTALLED_APPS = [# ...'djangocms_comments',]Now run migrations::python manage.py migrateAdd to your urlpatterns::urlpatterns = [url(r'^djangocms_comments/', include('djangocms_comments.urls')),]That's all!Optional: Akismet support-------------------------#. Install python-akismet: ``pip install python-akismet>=0.2.1``.#. Create an account and get a API KEY: https://akismet.com/ (You don't need to pay)#. Add to your settings:.. code-block:: pythonSPAM_PROTECTION = {'default': {'BACKEND': 'djangocms_comments.spam.Akismet','TOKEN': '1ba29d6f120c',},}Optional: Bootstrap3 theme usign Aldryn Boilerplates----------------------------------------------------#. Install aldryn-boilerplates: ``pip install aldryn-boilerplates>=0.7.4``.#. Configure Aldryn Boilerplates: https://github.com/aldryn/aldryn-boilerplatesUsage=====DjangoCMS-Comments includes a plugin. Add the plugin to a page, preferably in a "static placeholder".The first time you add a plugin, you need to create a new configuration. You can create different configurationsfor separate different comments lists on the same page.**For example, you have a blog with two languages. The posts are translated (the id is the same) and you need separatecomments. The solution is to create a plugin for each language with a different configuration.**Comments will be associated to the instance in the page. That instance is necessary.To make the relationship, DjangoCMS-Comments uses a ``GenericForeignKey``. If the primary key is not an integer, therelationship will not work! However, this is not usual.Settings========You can overwrite the following options in your settings file:https://github.com/Nekmo/djangocms-comments/blob/master/djangocms_comments/settings.pyFeatures========- Anonymous and registers users comments.- Pretty comment administration.- Akismet support.- Moderation options: spam, hidden, soft deleted, edited...- Easy to add to any page.- Many customization options.- Separates comments systems by language and sites.- Pretty Bootstrap3 integration.TODO====- Social authentication (Twitter, Google, Facebook, Github...).- Reply comments.- Rich text.- Options for authentication methods (disable anonymous...).- Send notifications to admins (new comment, moderation required...).- Sending messages to users (new answers, reply to my comment...).Contribute==========Please feel free to send a pull request. All suggestions are welcome.Keywords: djangocms,comments,djangocms-comments,cms,djangoPlatform: linuxClassifier: License :: OSI Approved :: MIT LicenseClassifier: Framework :: DjangoClassifier: Framework :: Django :: 1.6Classifier: Framework :: Django :: 1.7Classifier: Framework :: Django :: 1.8Classifier: Framework :: Django :: 1.9Classifier: Operating System :: POSIX :: LinuxClassifier: Programming Language :: Python :: 2.6Classifier: Programming Language :: Python :: 2.7Classifier: Programming Language :: Python :: 3.3Classifier: Programming Language :: Python :: 3.4Classifier: Programming Language :: Python :: 3.5Classifier: Natural Language :: EnglishClassifier: Development Status :: 1 - PlanningProvides: djangocms_comments