1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
|
===============================================================
Porting to ``django_comments`` from ``django.contrib.comments``
===============================================================
To move from ``django.contrib.comments`` to ``django_comments``,
follow these steps:
#. Install the comments app by running ``pip install django-contrib-comments``.
#. In :setting:`INSTALLED_APPS`, replace ``'django.contrib.comments'``
with ``'django_comments'``.
.. code-block:: python
INSTALLED_APPS = (
...
'django_comments',
...
)
#. In your project's ``urls.py``, replace the url include
``django.contrib.comments.urls`` with ``'django_comments.urls'``:
.. code-block:: python
urlpatterns = [
...
url(r'^comments/', include('django_comments.urls')),
...
]
#. If your project had :doc:`customized the comments framework
</custom>`, then update your imports to use the ``django_comments``
module instead of ``django.contrib.comments``. For example:
.. code-block:: python
from django.contrib.comments.models import Comment # old
from django_comments.models import Comment # new
from django.contrib.comments.forms import CommentForm # old
from django_comments.forms import CommentForm # new
#. If your database schema already contains the tables and data
for existing comments and you get an error like
``django.db.utils.ProgrammingError: relation "django_comments" already exists``
in your first subsequent migration, run
``manage.py migrate django_comments --fake-initial``.
|