Система комментариев является приложением Django. Следовательно, требуется прописать его в параметре INSTALLED_APPS файла конфигурации проекта:

INSTALLED_APPS = (
    [...]
    'django.contrib.comments',
)

Если вы используете свои представления и точно не используете базовые представления, вам потребуется добавить нижеприведённую строчку в начала соответствующего файла urls.py. Базовые представления сами подключают этот класс, при их использовании об этом можно не беспокоиться.

from django.contrib.comments.models import FreeComment

Добавьте следующий шаблон URL в глобальный файл привязки:

urlpatterns = patterns('',
        [...]
        (r'^comments/', include('django.contrib.comments.urls')),
}

Потребуется обновить вашу базу данных, чтобы там появилась необходимая таблица. Для этого следует остановить веб сервер и выполнить python manage.py syncdb.

В каждом шаблонном файле, который должен будет предоставлять доступ к комментариям, следует подгрузить соответствующий пакет (вставьте эту строку в самое начало шаблона):

{% load comments %}

Для получения доступа к комментариям объекта вам нужен только идентификатор этого объекта. При его наличии вы можете получить сами комментарии, информацию об их количестве и другую информацию.

<ul>
  {% for object in object_list %}
    {% get_free_comment_count for blog.entry object.id as comment_count %}
    <li>
      <h2><a href="{{ object.url }}">{{ object.title }}</a></h2>
      <p class="description">{{ object.summary}}</p>
      <p class="details">
        <a href="{{ object.get_absolute_url }}">
          {{ comment_count }} Comments
        </a>
      </p>
    </li>
  {% endfor %}
</ul>

<ul>
  {% for object in latest %}
    {% get_free_comment_count for blog.entry object.id as comment_count %}
    [...]
  {% endfor %}
</ul>

Обычно добавление комментариев разрешено пользователям на страницах с детальной информацией об объекте. Можно разрешить добавление комментариев откуда угодно, но для простоты данный пример не будет так делать. При использовании любых базовых представлений для отображения детальной информации, таких как django.views.generic.list_detail.object_detail или django.views.generic.date_based.object_detail, у вас будет идентификатор объекта в object.id, таким образом получение информации о количестве комментариев для этого объект будет несложным:

{% get_free_comment_count for blog.entry object.id as comment_count %}

Для того, чтобы получить список комментариев, необходимо использовать нижеприведённый пример, который помещает список комментариев в шаблонную переменную comment_list:

{% get_free_comment_list for blog.entry object.id as comment_list %}

Каждый объект object в comment_list имеет следующие поля:

А также следующие встроенные методы:

Система комментирования не позволяет вам добавлять другие типы данных, такие как адрес электронной почты комментатора. Это может быть исправлено в будущем.

Пример:

{% get_free_comment_count for blog.entry object.id as comment_count %}

<h2><a href="{{ object.url }}">{{ object.title }}</a></h2>

<em>{{ object.description }}</em>

<div class="article_menu">
  <b>Added on {{ object.add_date|date:"F j, Y" }}</b>
  <a href="{{ object.get_absolute_url }}#comments">{{ comment_count }}
    Comment{{ comment_count|pluralize }}</a>
</div>

{% get_free_comment_list for blog.entry object.id as comment_list %}

<h2 id="comments">Comments</h2>
{% for comment in comment_list %}
<div class="comment_{% cycle odd,even %}" id="c{{ comment.id }}">
  <span class="comnum">
    <a id="c{{ comment.id }}" href="#c{{ comment.id }}">
      #{{ forloop.counter }}
    </a>
  </span>
  <p>
    <b>{{ comment.person_name|escape }}</b> commented,
    on {{ comment.submit_date|date:"F j, Y" }}
    at {{ comment.submit_date|date:"P" }}:
  </p>
  {{ comment.comment|escape|urlizetrunc:40|linebreaks }}
</div>
{% endfor %}

<h2>Post a comment</h2>
{% free_comment_form for blog.entry object.id %}

Django поставляется со встроенными стандартными шаблонами для системы комментирования.

Вы можете переопределить любой из них, создав каталог comments в каталоге с вашими шаблонами и соответствующие шаблоны в нём.

<h2>Post a comment</h2>
{% free_comment_form for blog.entry object.id %}

{% if display_form %}
  <form action="/comments/postfree/" method="post">
    <p>Your name: <input type="text" id="id_person_name" name="person_name" /></p>
    <p>Comment:<br /><textarea name="comment" id="id_comment" rows="10" cols="60"></textarea></p>
    <input type="hidden" name="options" value="{{ options }}" />
    <input type="hidden" name="target" value="{{ target }}" />
    <input type="hidden" name="gonzo" value="{{ hash }}" />
    <p><input type="submit" name="preview" value="Preview comment" /></p>
  </form>
{% endif %}

<h1>Preview your comment</h1>

<form action="/comments/postfree/" method="post">
  {% if comment_form.has_errors %}
    <p><strong style="color: red;">Please correct the following errors.</strong></p>
  {% else %}
    <div class="comment">
      {{ comment.comment|escape|urlizetrunc:"40"|linebreaks }}
      <p class="date small">Posted by <strong>{{ comment.person_name|escape }}</strong></p>
    </div>

    <p><input type="submit" name="post" value="Post public comment" /></p>

    <h1>Or edit it again</h1>
  {% endif %}

  {% if comment_form.person_name.errors %}
    {{ comment_form.person_name.html_error_list }}
  {% endif %}

  <p><label for="id_person_name">Your name:</label> {{ comment_form.person_name }}</p>

  {% if comment_form.comment.errors %}
    {{ comment_form.comment.html_error_list }}
  {% endif %}

  <p>
    <label for="id_comment">Comment:</label>
    <br />
    {{ comment_form.comment }}
  </p>

  <input type="hidden" name="options" value="{{ options }}" />
  <input type="hidden" name="target" value="{{ target }}" />
  <input type="hidden" name="gonzo" value="{{ hash }}" />

  <p>
    <input type="submit" name="preview" value="Preview revised comment" />
  </p>
</form>

<h1>Comment posted successfully</h1>

<p>Thanks for contributing.</p>

{% if object %}
        <ul>
                <li><a href="{{ object.get_absolute_url }}">View your comment</a></li>
        </ul>
{% endif %}

В настоящее время django.contrib.comments.views.comments в методе post_free_comment() имеет жёстко определённый адрес перенаправления на posted.html. Если вы желаете, чтобы отправка комментария возвращала пользователя на комментируемую страницу, вы можете переопределить метод post_free_comment() и добавить перенаправление в другое место после отправки комментария. URL может передаваться в виде скрытого параметра в шаблоне freeform.html. Для этого потребуется создать обработчик в views.py:

from django.contrib.comments.views.comments import post_free_comment
from django.http import HttpResponseRedirect

def my_post_free_comment(request):
    if request.has_key('url') and not request.has_key('preview'):
        response = post_free_comment(request)

        # Check there's a url to redirect to, and that post_free_comment worked
        if len(request['url'].strip()) > 0 and
               isinstance(response, HttpResponseRedirect):
            return HttpResponseRedirect(request['url'])

            # Fall back on the default post_free_comment response
            return response

        return post_free_comment(request)

После этого потребуется перенаправить запросу на это представление вместо оригинального. Для этого, перед строкой:

(r'^comments/', include('django.contrib.comments.urls.comments')),

надо добавить строку:

(r'^comments/postfree/', 'views.my_post_free_comment'),

Теперь надо добавить в форму скрытое поле с URL. Но как получить текущий URL в шаблонной переменной? Для этого потребуется активировать шаблонный контекстный процессор request добавив следующий код в файл settings.py:

from django.conf.global_settings import TEMPLATE_CONTEXT_PROCESSORS
TEMPLATE_CONTEXT_PROCESSORS += (
     'django.core.context_processors.request',
)

После активации контекстного процессора шаблонам будет доступна переменная request. Используя эту переменную вы можете выполнить request.get_full_path для получения текущего URL. Внесём эти изменения в freeform.html:

{% load i18n %}
{% if display_form %}
  <form action="/comments/postfree/" method="post">
    <p>
      <label for="id_person_name">{% trans "Your name:" %}</label>
      <input type="text" id="id_person_name" name="person_name" />
    </p>
    <p>
      <label for="id_comment">{% trans "Comment:" %}</label><br />
      <textarea name="comment" id="id_comment" rows="10" cols="60"></textarea>
    </p>
    <p>
      <input type="hidden" name="options" value="{{ options }}" />
      <input type="hidden" name="target" value="{{ target }}" />
      <input type="hidden" name="gonzo" value="{{ hash }}" />
      <input type="hidden" name="url" value="{{ request.get_full_path }}" />
      <input type="submit" name="preview" value="{% trans "Preview comment" %}" />
    </p>
  </form>
{% endif %}

В free_preview.html добавим:

<input type="hidden" name="url" value="{{ request.url }}" />

перед

<p><input type="submit" name="preview" value="Preview revised comment" /></p>

Этого должно быть достаточно!

Список свежих комментариев. Нижеприведённый код отображает в виде списка последние комментарии для всего вашего сайта, не обращая внимания на приложения:

<h1>Recent comments</h1>

<p>
  {% if has_previous %}
    <a href="?page={{ previous }}">Previous</a> |
  {% endif %}

  Page {{ page }} of {{ pages }}

  {% if has_next %}
    | <a href="?page={{ next }}">Next</a>
  {% endif %}
</p>

{% for comment in object_list %}
  <div class="comment" id="c{{ comment.id }}">
    <h3>
      <a href="{{ comment.get_absolute_url }}">
        {{ comment.person_name|escape }}
        <span class="small quiet">
          {{ comment.submit_date|date:"F j, Y" }} at {{ comment.submit_date|date:"P" }}
        </span>
      </a>
    </h3>
    {{ comment.comment|escape|urlizetrunc:"40"|linebreaks }}
  </div>
{% endfor %}

<p>
  {% if has_previous %}
    <a href="?page={{ previous }}">Previous</a> |
  {% endif %}

  Page {{ page }} of {{ pages }}

  {% if has_next %}
    | <a href="?page={{ next }}">Next</a>
  {% endif %}
</p>