django-contrib-comments 2.2.0
The code formerly known as django.contrib.comments.
License: BSD

===========================
Django "excontrib" Comments
===========================

.. image:: https://img.shields.io/pypi/v/django-contrib-comments.svg
   :target: https://pypi.python.org/pypi/django-contrib-comments

.. image:: https://img.shields.io/travis/django/django-contrib-comments.svg
    :target: http://travis-ci.org/django/django-contrib-comments

.. image:: https://img.shields.io/pypi/pyversions/django-contrib-comments.svg
   :target: https://pypi.python.org/pypi/django-contrib-comments

.. image:: https://img.shields.io/pypi/djversions/django-contrib-comments.svg
   :target: https://pypi.org/project/django-contrib-comments/

Django used to include a comments framework; since Django 1.6 it's been
separated to a separate project. This is that project.

This framework can be used to attach comments to any model, so you can use it
for comments on blog entries, photos, book chapters, or anything else.

For details, `consult the documentation`__.

__ https://django-contrib-comments.readthedocs.io/
.. :changelog:

History
=======

2.2.0 (2022-01-31)
------------------

* Confirmed support for Django 4.0.

2.1.0 (2021-03-03)
------------------

* Dropped support for Django 1.11, 2.0, and 2.1.
* Added the ``delete_stale_comments`` management command.
* Added db_index to ``object_pk`` and ``is_removed`` fields.
* Altered ``object_pk`` from ``TextField`` to ``CharField(max_length=64)``
  so that the field can be indexed on MySQL, too. **Warning:** if you attach
  comments to objects whose primary key is serialized to more than 64
  characters, you should provide a custom Comment model
  (more about that in the documentation) with an appropriate
  ``object_pk`` field.
* Confirmed support for Python 3.9.
* Added support for Django 3.2.

2.0.0 (2020-12-20)
------------------

* Removed support for Python 2.
* Renamed zh_CN to zh_Hans and zh_TW to zh_Hant to match
  Django Chinese translations naming.
* Confirmed support for Django 3.1 and avoid deprecation warnings.
* Confirmed support for Python 3.8.
* Updated Arabic and German translations.

1.9.2 (2019-12-03)
------------------

* WARNING: This *is* the last version supporting Python 2.
* Confirmed support for Django 3.0.
* Prevented deprecation warnings with Django 3.0.
* Updated Danish and Indonesian translations.

1.9.1 (2019-02-20)
------------------

* WARNING: This is most probably the last version supporting Python 2.
* Added testing for Python 3.7.
* Confirmed support for Django 2.2 (no code changes required).
* Updated translations.

1.9.0 (2018-08-04)
------------------

* Added testing for Python 3.6.
* Confirmed support for Django 2.0 and 2.1.
* Dropped support for Django < 1.11.
* ``ip_address`` is set to None when ``REMOTE_ADDR`` is empty (#93).

1.8.0 (2017-02-03)
------------------

* Fixed a packaging error which caused sub-packages of the tests to be
  distributed.
* Use ``get_current_site`` to look up the site instead of ``settings.SITE_ID``.
* Confirmed support for Django 1.11.
* Dropped Django 1.7 and Python 3.2/3.3 support.
* Added testing for Python 3.5.
* Updated translations.

1.7.3 (2016-09-13)
------------------

* Fixed a regression which prevented the ``Comment`` model
  from registering with the admin.
* Updated translations.

1.7.2 (2016-08-04)
------------------

* ``get_comment_list`` now returns a ``QuerySet`` instead of a ``list``.
* Fixed a Django 1.9+ compatibility issue with a customized comment app in
  ``INSTALLED_APPS`` (#87).
* Confirmed support for Django 1.10.

1.7.1 (2016-05-03)
------------------

* Isolated abstract models outside of models.py so they can be imported without
  triggering Django's deprecation warning about models living outside of a
  'models' module.
* Updated translations.

1.7.0 (2016-03-29)
------------------

* Dropped Django 1.6 and Python 2.6 support
* Improved usage of ``AppConfig`` functionality for custom models.
* Added ``CommentAbstractModel`` as another abstract model layer for easier
  customization.
* Avoided N+1 query problem for users on comments.
* Made the moderation email subject translatable.
* Added a database index to ``Comment.submit_date``, since it is used for the
  default ordering.
* Fixed packaging so locale files are distributed.
* Updated translations.

1.6.2 (2016-12-10)
------------------

* Fixed some Django deprecation warnings.
* Setup translation system using Transifex.
* Added missing South migration for the email length.
* Updated translations.

1.6.1 (2016-05-08)
------------------

* Fixed migrations not working when installed as an egg.


1.6.0 (2016-04-29)
------------------

* Made ``CommentSecurityForm`` pass keyword arguments to its parent class.
* Added ``COMMENTS_TIMEOUT`` setting to configure the timeout for
  ``CommentSecurityForm``.
* Migrated ``Comment.user_email`` to 254 characters.
* Moved South migrations to ``south_migrations`` folder so they can exist with
  Django 1.7 migrations.
* Added Django 1.9 compatibility, dropped support for Django 1.5.