Herausforderung: DIY Django Mini-Blog
In dieser Herausforderung werden Sie Ihr Django-Wissen aus dem Modul Django Web Framework (Python) nutzen, um einen sehr einfachen Blog zu erstellen.
Voraussetzungen: | Bevor Sie diese Herausforderung angehen, sollten Sie bereits alle Artikel in diesem Modul durchgearbeitet haben. |
---|---|
Ziel: | Das Verständnis grundlegender Django-Konzepte wie URL-Konfigurationen, Modelle, Ansichten, Formulare und Templates zu testen. |
Projektbeschreibung
Die Seiten, die angezeigt werden müssen, ihre URLs und andere Anforderungen sind unten aufgeführt:
Seite | URL | Anforderungen |
---|---|---|
Startseite | / und /blog/ |
Eine Indexseite, die die Website beschreibt. |
Liste aller Blog-Beiträge | /blog/blogs/ |
Liste aller Blog-Beiträge:
|
Blogger Detailseite |
/blog/blogger/<author-id>
|
Informationen zu einem angegebenen Autor (nach ID) und eine Liste seiner Blog-Beiträge:
|
Blog-Beitrag Detailseite |
/blog/<blog-id>
|
Details zum Blog-Beitrag.
|
Liste aller Blogger | /blog/bloggers/ |
Liste der Blogger im System:
|
Kommentarseite | /blog/<blog-id>/create |
Kommentar zu einem Blog-Beitrag erstellen:
|
Benutzerauthentifizierungsseiten |
/accounts/<standard urls>
|
Standard-Django-Authentifizierungsseiten für das Einloggen, Ausloggen und Einstellen des Passworts:
|
Admin-Seite |
/admin/<standard urls>
|
Die Admin-Seite sollte aktiviert werden, um das Erstellen/Bearbeiten/Löschen von Blog-Beiträgen, Blog-Autoren und Blog-Kommentaren zu ermöglichen (dies ist der Mechanismus für Blogger, um neue Blog-Beiträge zu erstellen):
|
Zusätzlich sollten Sie einige grundlegende Tests schreiben, um zu überprüfen:
- Alle Modelfelder haben das richtige Label und die richtige Länge.
- Alle Modelle haben den erwarteten Objektnamen (z.B.
__str__()
liefert den erwarteten Wert). - Modelle haben die erwartete URL für einzelne Blog- und Kommentar-Datensätze (z.B.
get_absolute_url()
liefert die erwartete URL). - Die BlogListView (Seite mit allen Blogs) ist an der erwarteten Stelle erreichbar (z.B. /blog/blogs)
- Die BlogListView (Seite mit allen Blogs) ist über die erwartete benannte URL erreichbar (z.B. 'blogs')
- Die BlogListView (Seite mit allen Blogs) nutzt das erwartete Template (z.B. das Standard-Template)
- Die BlogListView paginiert Datensätze um 5 (zumindest auf der ersten Seite)
Hinweis: Natürlich gibt es viele weitere Tests, die Sie durchführen können. Verwenden Sie Ihr eigenes Ermessen, aber wir erwarten, dass Sie mindestens die obigen Tests durchführen.
Der folgende Abschnitt zeigt Screenshots einer Site, die die oben genannten Anforderungen implementiert.
Screenshots
Die folgenden Screenshots bieten ein Beispiel dafür, was das fertige Programm ausgeben sollte.
Liste aller Blog-Beiträge
Dies zeigt die Liste aller Blog-Beiträge (zugänglich über den Link "Alle Blogs" in der Seitenleiste). Zu beachten:
- Die Seitenleiste zeigt auch den eingeloggten Benutzer an.
- Einzelne Blog-Beiträge und Blogger sind als Links auf der Seite zugänglich.
- Paginierung ist aktiviert (in Gruppen von 5)
- Sortierung ist neueste zuerst.
Liste aller Blogger
Dies bietet Links zu allen Bloggern, wie sie vom Link "Alle Blogger" in der Seitenleiste verlinkt sind. In diesem Fall sehen wir aus der Seitenleiste, dass kein Benutzer eingeloggt ist.
Blog Detailseite
Dies zeigt die Detailseite für einen bestimmten Blog.
Beachten Sie, dass die Kommentare ein Datum und eine Uhrzeit haben und von ältesten zu neuesten sortiert sind (umgekehrt zur Blog-Sortierung). Am Ende finden wir einen Link zum Zugriff auf das Formular, um einen neuen Kommentar hinzuzufügen. Wenn ein Benutzer nicht eingeloggt ist, würden wir stattdessen einen Vorschlag zum Einloggen sehen.
Kommentarformular hinzufügen
Dies ist das Formular, um Kommentare hinzuzufügen. Beachten Sie, dass wir eingeloggt sind. Wenn dies erfolgreich ist, sollten wir zur zugehörigen Blogseite zurückgeführt werden.
Autoren-Biografie
Dies zeigt biografische Informationen zu einem Blogger zusammen mit ihrer Blog-Beitragsliste.
Schritte zur vollständigen Umsetzung
Die folgenden Abschnitte beschreiben, was Sie tun müssen.
-
Erstellen Sie ein Skeleton-Projekt und eine Webanwendung für die Site (wie beschrieben in Django Tutorial Teil 2: Erstellen einer Skeleton-Website). Sie können 'diyblog' als Projektnamen und 'blog' als Anwendungsnamen verwenden.
-
Erstellen Sie Modelle für die Blog-Beiträge, Kommentare und andere benötigte Objekte. Denken Sie bei Ihrem Design daran:
- Jeder Kommentar wird nur einem Blog zugeordnet, aber ein Blog kann viele Kommentare haben.
- Blog-Beiträge und Kommentare müssen nach Veröffentlichungsdatum sortiert werden.
- Nicht jeder Benutzer wird notwendigerweise ein Blog-Autor sein, aber jeder Benutzer kann ein Kommentator sein.
- Blog-Autoren müssen auch biografische Informationen enthalten.
-
Führen Sie Migrationen für Ihre neuen Modelle durch und erstellen Sie einen Superuser.
-
Verwenden Sie die Admin-Seite, um einige Beispiel-Blog-Beiträge und -Kommentare zu erstellen.
-
Erstellen Sie Ansichten, Templates und URL-Konfigurationen für Blog-Beitrags- und Blogger-Listen-Seiten.
-
Erstellen Sie Ansichten, Templates und URL-Konfigurationen für Blog-Beitrags- und Blogger-Detailseiten.
-
Erstellen Sie eine Seite mit einem Formular zum Hinzufügen neuer Kommentare (denken Sie daran, dies nur für eingeloggte Benutzer verfügbar zu machen!)
Hinweise und Tipps
Dieses Projekt ist dem LocalLibrary Tutorial sehr ähnlich. Sie können das Skeleton, das Benutzer-Login/Logout-Verhalten, die Unterstützung für statische Dateien, Ansichten, URLs, Formulare, Basistemplates und die Admin-Seitenkonfiguration mit fast denselben Ansätzen einrichten.
Einige allgemeine Hinweise:
-
Die Indexseite kann als einfache Funktionsansicht und Template implementiert werden (genau wie bei der LocalLibrary).
-
Die Listenansicht für Blog-Beiträge und Blogger sowie die Detailansicht für Blog-Beiträge können mit den generischen Listen- und Detailansichten erstellt werden.
-
Die Liste der Blog-Beiträge für einen bestimmten Autor kann durch Verwendung einer generischen Blog-Listenansicht erstellt werden, wobei nach Blog-Objekten gefiltert wird, die dem angegebenen Autor entsprechen.
- Sie müssen
get_queryset(self)
implementieren, um die Filterung durchzuführen (ähnlich wie in unserer BibliotheksklasseLoanedBooksAllListView
) und die Autorinformationen aus der URL abrufen. - Sie müssen auch den Namen des Autors zur Seite im Kontext übergeben. Um dies in einer klassenbasierten Ansicht zu tun, müssen Sie
get_context_data()
implementieren (wie unten beschrieben).
- Sie müssen
-
Das Kommentar hinzufügen-Formular kann mit einer funktionsbasierten Ansicht (und dem zugehörigen Modell und Formular) oder einer generischen
CreateView
erstellt werden. Wenn Sie eineCreateView
verwenden (empfohlen), dann:-
Sie müssen auch den Namen des Blog-Beitrags zur Kommentarseite im Kontext übergeben (implementieren Sie
get_context_data()
wie unten beschrieben). -
Das Formular sollte nur die Kommentar-"Beschreibung" für die Benutzereingabe anzeigen (Datum und zugehöriger Blog-Beitrag sollten nicht bearbeitbar sein). Da sie nicht im Formular selbst angezeigt werden, muss Ihr Code in der Funktion
form_valid()
den Kommentarautor einstellen, damit er in das Modell gespeichert werden kann (wie hier beschrieben - Django-Dokumentation). In derselben Funktion setzen wir den zugehörigen Blog. Eine mögliche Implementierung ist unten zu sehen (pk
ist eine Blog-ID, die aus der URL/URL-Konfiguration übergeben wird).pythondef form_valid(self, form): """ Add author and associated blog to form data before setting it as valid (so it is saved to model) """ #Add logged-in user as author of comment form.instance.author = self.request.user #Associate comment with blog based on passed id form.instance.blog=get_object_or_404(Blog, pk = self.kwargs['pk']) # Call super-class form validation behavior return super(BlogCommentCreate, self).form_valid(form)
-
Sie müssen eine Erfolgs-URL bereitstellen, zu der nach der Formularvalidierung weitergeleitet wird; dies sollte der ursprüngliche Blog sein. Dazu müssen Sie
get_success_url()
überschreiben und die URL für den ursprünglichen Blog "umkehren". Sie können die erforderliche Blog-ID mit demself.kwargs
Attribut erhalten, wie im obigenform_valid()
-Methode gezeigt.
-
Wir haben kurz darüber gesprochen, einen Kontext in einer klassenbasierten Ansicht im Thema Django Tutorial Teil 6: Generische Listen- und Detailansichten an die Vorlage zu übergeben. Dazu müssen Sie get_context_data()
überschreiben (zuerst den vorhandenen Kontext abrufen, ihn mit zusätzlichen Variablen aktualisieren, die Sie an die Vorlage übergeben möchten, und dann den aktualisierten Kontext zurückgeben). Zum Beispiel zeigt der untenstehende Codeausschnitt, wie Sie ein Blogger-Objekt basierend auf ihrer BlogAuthor
-ID dem Kontext hinzufügen können.
class SomeView(generic.ListView):
# …
def get_context_data(self, **kwargs):
# Call the base implementation first to get a context
context = super(SomeView, self).get_context_data(**kwargs)
# Get the blogger object from the "pk" URL parameter and add it to the context
context['blogger'] = get_object_or_404(BlogAuthor, pk = self.kwargs['pk'])
return context
Bewertung
Die Bewertung für diese Herausforderung ist hier auf GitHub verfügbar. Diese Bewertung basiert hauptsächlich darauf, wie gut Ihre Anwendung die oben aufgeführten Anforderungen erfüllt, obwohl es einige Teile gibt, die überprüfen, ob Ihr Code geeignete Modelle verwendet, und dass Sie zumindest einige Testcodes geschrieben haben. Wenn Sie fertig sind, können Sie sich das fertige Beispiel ansehen, das ein "Vollpunkte"-Projekt widerspiegelt.
Sobald Sie dieses Modul abgeschlossen haben, haben Sie auch alle MDN-Inhalte zum Erlernen der grundlegenden Django-Serverseitigen Website-Programmierung abgeschlossen! Wir hoffen, Sie haben dieses Modul genossen und haben ein gutes Verständnis für die Grundlagen!