Django - Tutorial 029. Adding private messages and chats on the site - Part 1

чат, message, Django, chat, сообщение

According to the tradition, I will tell you about my experiences on the introduction of new functionality on the site. At the moment, this functionality is a personal message between users. Of course, this now does not work as well as in well-known social networks ... but in the end everything will work. The main feedback on the forum, please.

So. I really wanted to add personal messages on the site, especially since I already mentioned this six months ago. The question remained, how to do it. When searching on the Internet it was possible to stumble upon an option when the following data model is being formed.

  • Id of the message
  • from_user - sender
  • to_user - recipient
  • pub_date - the date of the message
  • message - message content

Tried to implement this option, but I was stopped by the fact that suddenly after personal messages I want to make chats? So why not immediately lay the foundation for chats?

Chat and Message models

This would be an excellent option for further development of the resource. But in this case, you need to create two models of Chat and Message .

# -*- coding: utf-8 -*-

from django.db import models
from django.contrib.auth.models import User
from django.utils import timezone
from django.utils.translation import ugettext_lazy as _

class Chat(models.Model):
    DIALOG = 'D'
    CHAT = 'C'
        (DIALOG, _('Dialog')),
        (CHAT, _('Chat'))

    type = models.CharField(
    members = models.ManyToManyField(User, verbose_name=_("Member"))

    def get_absolute_url(self):
        return 'users:messages', (), {'chat_id': }

class Message(models.Model):
    chat = models.ForeignKey(Chat, verbose_name=_("Chat"))
    author = models.ForeignKey(User, verbose_name=_("User"))
    message = models.TextField(_("Message"))
    pub_date = models.DateTimeField(_('Message date'),
    is_readed = models.BooleanField(_('Readed'), default=False)

    class Meta:

    def __str__(self):
        return self.message

If the Message model should be clear. There is a text message, status, whether it was read, the author of the message and the chat in which it was sent, as well as the date the message was sent.

That's the model of Chat somewhat more difficult to be. First, chats can be the spirit of species. The first is a personal conversation between two people. The second kind is a collective chat. Why was this done? This was necessary in order to simplify the search for the desired chat, when sending a message to the user from his personal page. Unfortunately at the moment, only such a way is done to send the first message to the user. That is, go to his page and click the button to write a message. In the future, you can find the user from the dialog page on your personal page. This is still a temporary limitation within the first User Story, which I wrote myself.

Each chat has many-to-many connection, which is responsible for the list of participants within the chat. Due to this, you can limit the viewing of chats, as well as the ability to write to chats, if the user was not invited to this chat room.

What kind of views will we need and what routes can be done? To implement this functionality in the simplest form, I had to write three views and three routes to respectively.

url(r'^dialogs/$', login_required(views.DialogsView.as_view()), name='dialogs'),
url(r'^dialogs/create/(?P<user_id>\d+)/$', login_required(views.CreateDialogView.as_view()), name='create_dialog'),
url(r'^dialogs/(?P<chat_id>\d+)/$', login_required(views.MessagesView.as_view()), name='messages'),

We will not go deep into which particular application we will use these routes - this is not a matter of principle.

In fact, there are three views, one for the list of dialogues for the user, another for creating a dialog from the page of another user, and the third for the messages in the dialog.

Message form

In this case, you can use the form for the model. We indicate the model, as well as which fields should be displayed with the label removed from the input field.

By default, you will have the usual textarea. I use my own WYSIWYG editor.

class MessageForm(ModelForm):
    class Meta:
        model = Message
        fields = ['message']
        labels = {'message': ""}

Views and Templates

Display a list of dialogs

To get a list of all the dialogs in which the user is involved, you need to filter all chats by participants, that is, by the Many-toMany members.

class DialogsView(View):
    def get(self, request):
        chats = Chat.objects.filter(members__in=[])
        return render(request, 'users/dialogs.html', {'user_profile': request.user, 'chats': chats})

In this case, I have a template for dialogs, in which I send an authorized user and a chat list. An active user will be needed to correctly display the messages read and not read in the dialog list.

The most interesting is the list of dialogs and its layout, so only the part responsible for the layout will be represented from the template.

<div class="panel">
        {% load tz %}
        {% if chats.count == 0 %}
            <div class="panel panel-body">{% trans "There is not a single dialogue started" %}</div>
        {% endif %}
        {% for chat in chats %}
            {% if chat.message_set.count != 0 %}
                {% with last_message=chat.message_set.last %}
                    {% get_companion user chat as companion %}
                    <a class="list-group-item {% if companion == and not last_message.is_readed %}unreaded{% endif %}" href="{{ chat.get_absolute_url }}">
                        <img class="avatar-messages" src="{{ companion.userprofile.get_avatar }}">
                        <div class="reply-body">
                            <ul class="list-inline">
                                <li class="drop-left-padding">
                                    <strong class="list-group-item-heading">{{ companion.username }}</strong>
                                <li class="pull-right text-muted"><small>{{ last_message.pub_date|utc }}</small></li>
                            {% if companion != %}
                                    <img class="avatar-rounded-sm" src="{{ }}">
                                    <div class="attached-reply-body {% if not last_message.is_readed %}unreaded{% endif %}">{{ last_message.message|truncatechars_html:"200"|safe|striptags }}</div>
                            {% else %}
                                <div>{{ last_message.message|truncatechars_html:"200"|safe|striptags }}</div>
                            {% endif %}
                {% endwith %}
            {% endif %}
        {% endfor %}

You can see my custom inline tag in the template. This tag is responsible for returning the interlocutor in the dialog in order to build on the information about the interlocutor an adequate layout for the list of dialogues and indication of the read and unread messages in the dialog list.

def get_companion(user, chat):
    for u in chat.members.all():
        if u != user:
            return u
    return None

Thus, the list of dialogs will look like this:

Current dialog and messages

To display the current dialog and messages, you will need more complex logic. The fact is that here the access to the chat is carried out by ID, but it is necessary to make not only an attempt to get a dialogue, but also to check if there is a user in the list of participants who is trying to get into this chat room. If it does not exist in the list of participants, then access to this chat room is forbidden to him. Among other things, the same view treats the sending of messages and the marking of messages read.

class MessagesView(View):
    def get(self, request, chat_id):
            chat = Chat.objects.get(id=chat_id)
            if request.user in chat.members.all():
                chat = None
        except Chat.DoesNotExist:
            chat = None

        return render(
                'user_profile': request.user,
                'chat': chat,
                'form': MessageForm()

    def post(self, request, chat_id):
        form = MessageForm(data=request.POST)
        if form.is_valid():
            message =
            message.chat_id = chat_id
   = request.user
        return redirect(reverse('users:messages', kwargs={'chat_id': chat_id}))

Message list template

{% if not chat %}
    <div class="panel panel-body">
        {% trans "It's impossible to start a conversation.No user is found or you do not have access to this conversation." %}
{% else %}
    {% load tz %}
    {% if chat %}
        <div id="messages" class="panel">
            <div id="innerMessages">
                {% for message in chat.message_set.all %}
                        {% include 'users/message.html' with message_item=message %}
                {% endfor %}
    {% endif %}
    <div id="message_form">
        <form id="message-form" class="panel panel-body" method="post" >
            {% load bootstrap3 %}
            {% csrf_token %}
            {% bootstrap_form form %}
            <button type="submit" class="btn btn-default btn-sm" onclick="return ETextEditor.validateForm('message-form')"><span class="ico ico-comment"></span>{% trans "Отправить" %}</button>
{% endif %}

Template of the message itself

{% url 'users:profile' as the_user_url%}
{% load tz %}
<div class="list-group-item {% if not message_item.is_readed %}unreaded{% endif %}">
    <a href="{{ the_user_url }}"><img class="avatar-comment" src="{{ }}"></a>
    <div class="reply-body">
        <ul class="list-inline">
            <li class="drop-left-padding">
                <strong class="list-group-item-heading"><a href="{{ the_user_url }}">{{ }}</a></strong>
            <li class="pull-right text-muted"><small>{{ message_item.pub_date|utc }}</small></li>
        <div>{{ message_item.message|safe }}</div>

Example of the resulting dialog

Starting a conversation with the user

At the moment, only one method is implemented to start a conversation with the user. It is necessary to go to the user's page and click on the "Write a message" button, then a link will be sent through the link in which the chat will be created or an already existing chat with this user is found. This is used to check whether the chat is a dialogue or a conversation between several users. This makes it possible to simplify the search for the necessary dialog.

class CreateDialogView(View):
    def get(self, request, user_id):
        chats = Chat.objects.filter(members__in=[, user_id], type=Chat.DIALOG).annotate(c=Count('members')).filter(c=2)
        if chats.count() == 0:
            chat = Chat.objects.create()
            chat = chats.first()
        return redirect(reverse('users:messages', kwargs={'chat_id':}))

Be sure to check for the number of users, since there can be only two users in a personal conversation, well, we check that these users are our authorized users, and also the user with whom we are trying to start a conversation.

After the chat is created, we redirect to the message page.

For Django I recommend VDS-server of Timeweb hoster .

We recommend hosting TIMEWEB
We recommend hosting TIMEWEB
Stable hosting, on which the social network EVILEG is located. For projects on Django we recommend VDS hosting.
Support the author Donate

Сделал всё в точности как написано, но возникает ошибка, возможно надо было что то импортировать воно это точно), мой первый проект на джанго, не кидайтесь тапками ). И так собственно ошибка:

NoReverseMatch at /messages/dialogs/

'users' is not a registered namespace
содержаниявот здесь думаю нне робит)
from django.shortcuts import render, redirect
from django.views import View
from .models import Chat
from .forms import MessageForm
from django.db.models import Count
from django.urls import reverse
from django.contrib import auth

# Create your views here.

class DialogsView(View):
    def get(self, request):
        chats = Chat.objects.filter(members__in=[])
        return render(request, 'users/dialogs.html', {'user': request.user, 'chats': chats})

дальше всё как в статье

Скорее ошибка в том, что у вас App не зарегистрирован в проекте.

from django.apps import AppConfig
class UsersConfig(AppConfig):
    name = 'users'

Откуда вы взяли приложение users?
Я создал было для данной статьи отдельное приложение 'Messages', в нём есть файл с содержанием:

from django.apps import AppConfig

class MessagesConfig(AppConfig):
    name = 'Messages'
у вас есть отдельно статья по созданию 'user.apps.UsersConfig'?

users - это приложение для отображения личного кабинета пользователей. И некоторые страницы отображаются в рамках этого приложения.
Полагаю, что в вашем случае нужно сменить users на Messages в ряде мест в шаблонах, например, эту строку

return redirect(reverse('users:messages', kwargs={'chat_id':}))
заменить на
return redirect(reverse('Messages:messages', kwargs={'chat_id':}))
Примерно так всё и поменять, отслеживая, чего не хватает.
Конкретно для личного кабинета пользователей статьи нет. Статья основана конкретно на коде данного сайта и является обобщённым примером основных моментов, что-то может быть опущено. Многие статьи ориентированы на наличие определённого опыта у программиста. Поэтому данные статьи и не являются полным руководством к повторению.

Ошибка не изменилась.

Ну а шаблоны? которые html. Там тоже есть {% url 'users:blablabla' %}


ну ошибка такая же но только не users а messeages найти не может

А вы когда создавали приложение для комментариев, вы его urls подключили в файле всего проекта?

Например, в этой статье есть два приложения: home и knowledge и их urls подключаются в файле всего проекта. Вы их подключали?

да, конечно, и в instaled_apps прописал как Messages.apps.MessagesConfig


и ещё, эта ссылка работает пока тебе или ты не напишешь сообщения
url(r'^dialogs/$', login_required(views.DialogsView.as_view()), name='dialogs'),

Внимательнее проанализируйте код из статьи и вывод ошибок, вы однозначно где-то накосячили. Вполне возможно, что вы не зарегистрировали пользовательский тег get_companion, Вы знаете как регистрировать пользовательские теги ?


Добрый день, очень интересные статьи у Вас на сайте, касательно Django  и  Python. Когда планируете создать часть 2 Чата. Евгений, это ведь не чат в режиме реального времени? каждый раз приходится обновлять страницу. Не планируете использовать для чата channels ?

Добрый день!

Спасибо за отзыв.
Всё планирую, а также планирую использовать channels, но пока не так много времени на внедрение всего функционала на сайте. Поэтому по срокам вообще ничего не могу сказать.



Thank you for the article. Is there the github folder or the source code folder for this chat features, because for the code provided here sometimes I don't really know the exact place to put and make the project work.

Hi, unfortunately - no. But You can ask your question on the forum of this site . I try answer on questions in all sections of forum.


Привет! Пытаюсь освоить создание чата по вашей статье, сделал все как написано. Пока что результат такой (см. на прикрепленные скрины). Подскажите, пожалуйста, почему такой внешний вид и вдруг мб я чего не учел? Я так понял того, что вы выложили - недостаточно для полноценного чата и у меня получился тот максимум, котоырй можно выжать из вашего кода. Подскажите, как развить дальше, пожалуйста, ресурс какой-нибудь или из своего поделитесь! Спасибо большое за статью!

Добрый день.
Вам нужно самостоятельно написать стили, то есть CSS, это здесь уже на усмотрение пользователей, то есть на ваше личное усмотрение. Изучайте CSS и делайте как хотите вёрстку.


Добрый вечер! Монжно по подробней о теге get_companion? ссылка не работает.

Добрый день. Это кастомный тег, помещается в файл, который находится в каталоге templatetags

  • myapp/
    • templatetags/


Only authorized users can post comments.
Please, Log in or Sign up

Hello, Dear Users of EVILEG!!!

If the site helped you, then support the development of the site financially, please.

You can do it by following ways:

Thank you, Evgenii Legotckoi

April 1, 2020, 8:03 a.m.
Dmitry Kozhinov

C++ - Test 001. The first program and data types

  • Result:40points,
  • Rating points-8
March 30, 2020, 12:47 p.m.

C++ - Test 001. The first program and data types

  • Result:60points,
  • Rating points-1
March 29, 2020, 12:14 p.m.

C++ - Тест 003. Условия и циклы

  • Result:71points,
  • Rating points1
Last comments
April 3, 2020, 8:06 a.m.
Konstantin Grudnitskiy

Я надеюсь вы уже разобрались в чем дело, но если вдруг нет, то проблема состоит в том, что вы пытаетесь запустить программу из интерпретатора питона. Файл это уже готова…
April 3, 2020, 6:18 a.m.
Konstantin Grudnitskiy

>>> text = 'hello world'>>> ' '.join(word for word in text.split()[:-1])'hello'>>> def remove_last_word(text):... return text and ' '.join(word for word in text.s…
March 27, 2020, 2:40 p.m.
Evgenij Legotskoj

Добрый день. В конце пятой статьи скачать можете.
March 27, 2020, 2:28 p.m.
mkdir _

Здравствуйте, а можно, пожалуйста, ссылку на целые исходники, если есть?
March 27, 2020, 4:36 a.m.
Evgenij Legotskoj

Скорее всего также, как и для установки всех остальных переменых в CMake, через использование set
Now discuss on the forum
April 5, 2020, 5:09 a.m.

Попробуйте CQtDeployer или windeployqt.
April 5, 2020, 2:35 a.m.

Так работает console.log(textEmail.text) var str = textEmail.text; var n =^((([0-9A-Za-z]{1}[-0-9A-z\.]{1,}[0-9A-Za-z]{1})|([0-9А-Яа-я]{1}[-0-9А-я\.]{1,}[…
April 3, 2020, 12:53 p.m.

Само собою на компе этого незаметно.
April 3, 2020, 8:48 a.m.

Евгений, добрый день. Спасибо!
April 3, 2020, 7:52 a.m.

да вроде много чего установленно, если неправильный путь указать то же самое, пробовал запустить видео через плей лист (по примерам из док)и из него назад путь взять, не получилось
© EVILEG 2015-2019
Recommend hosting TIMEWEB