Джанго - 011-сабақ. Джанго көмегімен сайтқа түсініктемелер қосу

MaterializedPath, Django, Python

Мен Django сайтында түсініктемелерді енгізуді қолға алған кезде, мен Django түсініктемелерді енгізу үшін ешқандай модуль ұсынбағанына таң қалдым. Дәлірек айтқанда, ол оны бұрын берген, бұл django.contrib.comments модулі болды, бірақ 1.7 нұсқасында ол ескірген деп жарияланды және оны өзіңіз қиюды немесе Disqus сияқты нәрсені пайдалануды ұсынды. Жарайды, бұл код синтаксисін бөлектеуді де қолдайтын сияқты, бірақ... мақалаларда бір бөлектеу бар, түсініктемелерде басқа - бұл ұсқынсыз болады.

Сондықтан, біз өз велосипедімізді іске асырамыз және қателерімізді ұстаймыз.

Түсініктемелерді орындау үшін сізге қажет:

• Жаңа үлгі қосыңыз, оны Пікір; деп атаймыз.
• Пікір қосуды өңдейтін көріністі қосыңыз;
• Түсініктеме енгізу формасын қосыңыз;
• Ағаш құрылымын ұйымдастыру үшін Materialized Path тәсілін қолданыңыз;

Түсініктеме үлгісі

Түсініктеме үлгісі келесі өрістерді қамтиды:

• жол - түбірге толық жолды қамтитын бүтін мәндердің массивін қамтиды. Материалданған жол мақаласында айтылғандай, бұл барлық негізгі элементтердің идентификаторы;
• article_id - түсініктеме орналасқан мақаланың сыртқы кілті;
• автор_id - түсініктеме авторының сыртқы кілті;
• мазмұн - түсініктеменің өзі;
• pub_date - түсініктеме жарияланған күні мен уақыты;

Сонымен қатар, жолдың ұзындығы бойынша түсініктеменің ығысу деңгейін анықтайтын get_offset() және санын анықтайтын get_col() әдістері берілген. түсініктеме алатын тордағы бағандар, сондай-ақ әкімші панелінде түсініктеме мазмұнының бір бөлігін көрсетуге жауап беретін __str__ , қайта анықталған әдіс.

Ауыстыру және бағандар саны беттегі түсініктемелердің ағаш көрінісін ұйымдастырады, бірақ ығысу 6 бағаннан аспайды, себебі тор қазіргі уақытта 12 бағанға бөлінген.

class Comment(models.Model):
    class Meta:
        db\_table = "comments"

    path = ArrayField(models.IntegerField())
    article\_id = models.ForeignKey(Article)
    author\_id = models.ForeignKey(User)
    content = models.TextField('Комментарий')
    pub\_date = models.DateTimeField('Дата комментария', default=timezone.now)

    def \_\_str\_\_(self):
        return self.content[0:200]

    def get\_offset(self):
        level = len(self.path) - 1
        if level > 5:
            level = 5
        return level

    def get\_col(self):
        level = len(self.path) - 1
        if level > 5:
            level = 5
        return 12 - level

urls.py файлы

Түсініктеме urls.py. файлында сипатталуы керек белгілі бір мекенжайға POST сұрауы арқылы сайтқа жіберіледі.

from django.conf.urls import url

from . import views

app\_name = 'post'
urlpatterns = [
    url(r'^(?P<article\_id>[0-9]+)/$', views.EArticleView.as\_view(), name='article'),
    url(r'^comment/(?P<article\_id>[0-9]+)/$', views.add\_comment, name='add\_comment'),
]

Көптеген мақалаларда айтқанымдай, мен мақалалар мен бөлімдермен білім модулінде жұмыс істеймін, бірақ бұл жолы мақалалардың URL мекенжайларын бөлімдерге тәуелді болмайтындай етіп біріктіру және индекстеу жоғалмауы үшін мақалаларды бөлек модульге ауыстырдым. егер мақала басқа бөлімге ауыстырылса. Енді біз post модулімен жұмыс істейміз. Пікір де сонда жіберіледі. Нәтижесінде, егер пайдаланушы ID = 12 бар мақалаларға түсініктеме берсе, түсініктеме post/comment/12 жолымен жіберіледі.

Түсініктеме формасы

Түсініктеме пішіні forms.py. бөлек файлға орналастырылады.

Пішінді өңдеу және түсініктемені сақтау көріністе орындалады, сондықтан мұнда сақтау әдісі жоқ. Бұл пішін тек түсініктеме енгізу және оны серверге жіберу үшін қызмет етеді.

from django import forms

from .models import Comment


class CommentForm(forms.Form):

    parent\_comment = forms.IntegerField(
        widget=forms.HiddenInput,
        required=False
    )

    comment\_area = forms.CharField(
        label="",
        widget=forms.Textarea
    )

ата-ана_түсініктеме өрісі өте маңызды, себебі ол мақаланың астындағы пікірлердің біріне жауап бергенде автоматты түрде толтырылатын ата-аналық түсініктеменің идентификаторын қамтиды. Пайдаланушы оны толтырмайды және ол жасырылады. Сонымен қатар, оны толтыру міндетті емес, өйткені түсініктеме тікелей мақалаға сілтеме жасай алады.

Белгілі бір түсініктемеге қатынас JavaScript сценарийі арқылы жасалады.

Өкілдік

Түсініктеме қосу үшін мен өзімді ешқандай көрініссіз әдіспен шектедім, әсіресе @login_required декораторын көрініске қарағанда әдіске тіркеу оңайырақ болғандықтан.

Мақаланы көрсетуге жауапты көрініс де өзгертілді, өйткені мақаланың берілген бетінің контекстіне түсініктеме пішінін қосу қажет болды, егер, әрине, пайдаланушы рұқсат етсе.

from django.views import View
from django.shortcuts import render\_to\_response, get\_object\_or\_404, redirect
from django.contrib import auth
from django.http import Http404
from django.contrib.auth.decorators import login\_required
from django.views.decorators.http import require\_http\_methods
from django.core.exceptions import ObjectDoesNotExist
from django.template.context\_processors import csrf

from knowledge.models import Article, Comment
from knowledge.forms import CommentForm


class EArticleView(View):
    template\_name = 'post/article.html'
    comment\_form = CommentForm

    def get(self, request, *args, **kwargs):
        article = get\_object\_or\_404(Article, id=self.kwargs['article\_id'])
        context = {}
        context.update(csrf(request))
        user = auth.get\_user(request)
        # Помещаем в контекст все комментарии, которые относятся к статье
        # попутно сортируя их по пути, ID автоинкрементируемые, поэтому
        # проблем с иерархией комментариев не должно возникать 
        context['comments'] = article.comment\_set.all().order\_by('path')
        context['next'] = article.get\_absolute\_url()
        # Будем добавлять форму только в том случае, если пользователь авторизован
        if user.is\_authenticated:
            context['form'] = self.comment\_form

        return render\_to\_response(template\_name=self.template\_name, context=context)

# Декораторы по которым, только авторизованный пользователь 
# может отправить комментарий и только с помощью POST запроса
@login\_required
@require\_http\_methods(["POST"])
def add\_comment(request, article\_id):

    form = CommentForm(request.POST)
    article = get\_object\_or\_404(Article, id=article\_id)

    if form.is\_valid():
        comment = Comment()
        comment.path = []
        comment.article\_id = article
        comment.author\_id = auth.get\_user(request)
        comment.content = form.cleaned\_data['comment\_area']
        comment.save()

        # Django не позволяет увидеть ID комментария по мы не сохраним его, 
        # хотя PostgreSQL имеет такие средства в своём арсенале, но пока не будем
        # работать с сырыми SQL запросами, поэтому сформируем path после первого сохранения
        # и пересохраним комментарий 
        try:
            comment.path.extend(Comment.objects.get(id=form.cleaned\_data['parent\_comment']).path)
            comment.path.append(comment.id)
        except ObjectDoesNotExist:
            comment.path.append(comment.id)

        comment.save()

    return redirect(article.get\_absolute\_url())

Түсініктемесі бар мақала үлгісі

Мен бет орналасуы үшін django-bootstrap3 модулін қолданатынымды айттым ба? Сондықтан, бұл үлгінің қалай орналастырылғанына таң қалмаңыз.

Түсініктемелер Bootstrap Grid жүйесіндегі тұрақты жолдар болып табылады және ағаш көрінісі бағандарды ауыстыру арқылы қол жеткізіледі.

Бұл жерде әрбір жолда id={{ comment.id }} болуы өте маңызды - бұл пайдаланушы мақалаға емес, біреуге түсініктеме берсе, жасырын пішін өрісінде ауыстырылатын мәннің дәл өзі. пікірлерден.

Дәл сол идентификатор JavaScript арқылы түсініктеме пішінін беттің айналасында жылжыту үшін пайдаланылады. Пішін show_comments_form() функциясы арқылы орналастырылады. Бұл функция әрбір түсініктеме үшін «Жауап беру» сілтеме өңдегішінде, сондай-ақ тек түсініктеме жазу үшін сілтеме өңдегішінде орналастырылады. Бұл функция jQuery. кітапханасын пайдаланады, сондықтан оны негізгі үлгіге қосуды ұмытпаңыз. Мен Bootstrap. көмегімен пайдаланылатын нұсқаны қосып жатырмын.

{% extends 'home/base.html' %}
{% load bootstrap3 %}
{% block page %}
    <article>
        <h1>{{ article.article\_title }}</h1>
        {{ article.article\_content|safe }}
    </article>
    <h2>Комментарии</h2>
    {% for comment in comments %}
        <a name="comment-{{ comment.id }}"></a>
        <div class="row" id="{{ comment.id }}">
            <div class="col-md-{{ comment.get\_col }} col-md-offset-{{ comment.get\_offset }}">
                <div class="panel panel-default">
                    <div class="panel-heading">
                        <strong>{{ comment.author\_id.get\_full\_name|default:comment.author\_id.username }}</strong>&nbsp;&nbsp;
                        {{ comment.pub\_date }}
                        <a href="#comment-{{ comment.id }}">#</a>
                    </div>
                    <div class="panel-body">
                        <div>{{ comment.content|safe }}</div>
                        {% if form %}<a class="btn btn-default btn-xs pull-right"
                                        onclick="return show\_comments\_form({{ comment.id }})">
                            {% bootstrap\_icon "share-alt" %}&nbsp;&nbsp;Ответить</a>
                        {% endif %}
                    </div>
                </div>
            </div>
        </div>
    {% endfor %}
    {% if form %}
        <h3 id="write\_comment"><a onclick="return show\_comments\_form('write\_comment')">Написать комментарий</a></h3>
        <form id="comment\_form" action="{% url 'post:add\_comment' article.id %}" method="post">
        {% csrf\_token %}
        {% bootstrap\_form form %}
        {% buttons %}
            <button type="submit" class="btn btn-primary">{% bootstrap\_icon "comment" %}&nbsp;&nbsp;Комментировать</button>
        {% endbuttons %}
        </form>
    {% else %}
        <div class="panel panel-warning">
            <div class="panel-heading">
                <h3 class="panel-title">Комментарии</h3>
            </div>
            <div class="panel-body">
                Только авторизованные пользователи могут оставлять комментарии.<br />
            </div>
        </div>
    {% endif %}
{% endblock %}

Пікірлерді бетке жылжыту үшін JavaScript

Жарайды, мұның бәрі жай ғана былық. Егер id = write_comment болса, онда бұл түсініктемеде бірінші деңгей бар және жасырын өріс бос болады және пішін "Пікір жазу" жазуының астына жылжытылады. Әйтпесе, толтырыңыз. жасырын өріске және оны түсініктеме астына қойыңыз , оның астында біз жауап береміз.

function show\_comments\_form(parent\_comment\_id)
{
    if (parent\_comment\_id == 'write\_comment')
    {
        $("#id\_parent\_comment").val('')
    }
    else
    {
        $("#id\_parent\_comment").val(parent\_comment\_id);
    }
    $("#comment\_form").insertAfter("#" + parent\_comment\_id);
}

Django үшін Timeweb хостының VDS-сервері ұсынамын.