Herausforderung: DIY Django Mini-Blog
In dieser Herausforderung werden Sie die in dem Modul Django Web Framework (Python) erworbenen Kenntnisse nutzen, um einen sehr einfachen Blog zu erstellen.
Voraussetzungen: | Bevor Sie diese Herausforderung angehen, sollten Sie alle Artikel in diesem Modul durchgearbeitet haben. |
---|---|
Zielsetzung: | Das Verständnis der grundlegenden Django-Konzepte, einschließlich URL-Konfigurationen, Modelle, Ansichten, Formulare und Vorlagen, zu testen. |
Projektbeschreibung
Die anzuzeigenden Seiten, deren URLs und weitere Anforderungen sind unten aufgeführt:
Seite | URL | Anforderungen |
---|---|---|
Startseite | / und /blog/ |
Eine Indexseite, die die Website beschreibt. |
Liste aller Blogartikel | /blog/blogs/ |
Liste aller Blogartikel:
|
Detailseite des Blogautors (Blogger) |
/blog/blogger/<author-id>
|
Informationen für einen bestimmten Autor (nach ID) und Liste seiner Blogartikel:
|
Detailseite des Blogartikels |
/blog/<blog-id>
|
Details des Blogartikels.
|
Liste aller Blogger | /blog/bloggers/ |
Liste der Blogger im System:
|
Kommentarseitenformular | /blog/<blog-id>/create |
Einen Kommentar für einen Blogartikel erstellen:
|
Authentifizierungsseiten für Benutzer |
/accounts/<standard urls>
|
Standard-Django-Authentifizierungsseiten für die Anmeldung, Abmeldung und das Setzen des Passworts:
|
Verwaltungsbereich |
/admin/<standard urls>
|
Der Verwaltungsbereich sollte aktiviert werden, um das Erstellen/Bearbeiten/Löschen von Blogartikeln, Blogautoren und Blogkommentaren zu ermöglichen (dies ist der Mechanismus, mit dem Blogger neue Blogartikel erstellen):
|
Zusätzlich sollten Sie einige grundlegende Tests schreiben, um zu überprüfen:
- Alle Modulfelder haben die richtige Bezeichnung und Länge.
- Alle Modelle haben den erwarteten Objektnamen (z.B.
__str__()
gibt den erwarteten Wert zurück). - Modelle haben die erwartete URL für einzelne Blog- und Kommentareinträge (z.B.
get_absolute_url()
gibt die erwartete URL zurück). - Die BlogListView (Seite mit allen Blogs) ist an der erwarteten Stelle zugänglich (z.B. /blog/blogs)
- Die BlogListView (Seite mit allen Blogs) ist unter der erwarteten benannten URL zugänglich (z.B. 'blogs')
- Die BlogListView (Seite mit allen Blogs) verwendet die erwartete Vorlage (z.B. die Standardvorlage)
- Die BlogListView paginiert die Einträge in Bündeln von 5 (mindestens 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 mindestens die oben genannten Tests.
Der folgende Abschnitt zeigt Screenshots einer Site, die die oben genannten Anforderungen implementiert.
Screenshots
Die folgenden Screenshots zeigen ein Beispiel dafür, was das fertige Programm ausgeben sollte.
Liste aller Blogartikel
Dies zeigt die Liste aller Blogartikel (zugänglich über den "Alle Blogs"-Link in der Seitenleiste). Zu beachten:
- Die Seitenleiste listet auch den angemeldeten Benutzer auf.
- Einzelne Blogartikel und Blogger sind als Links auf der Seite zugänglich.
- Paginierung ist aktiviert (in Gruppen von 5)
- Sortierung ist von neuester zu ältester.
Liste aller Blogger
Dies bietet Links zu allen Bloggern, die über den Link "Alle Blogger" in der Seitenleiste verlinkt sind. In diesem Fall sehen wir aus der Seitenleiste, dass kein Benutzer angemeldet ist.
Blogdetailseite
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 geordnet sind (entgegengesetzt zur Blogreihenfolge). Am Ende haben wir einen Link, um auf das Formular zum Hinzufügen eines neuen Kommentars zuzugreifen. Wenn ein Benutzer nicht angemeldet ist, würden wir stattdessen einen Vorschlag zum Anmelden sehen.
Kommentarformular hinzufügen
Dies ist das Formular zum Hinzufügen von Kommentaren. Beachten Sie, dass wir angemeldet sind. Wenn dies erfolgreich ist, sollten wir zur entsprechenden Blogseite zurückgeführt werden.
Autorenbio
Dies zeigt biografische Informationen für einen Blogger sowie deren Blogartikel-Liste.
Schritte zur Fertigstellung
Die folgenden Abschnitte beschreiben, was Sie tun müssen.
-
Erstellen Sie ein Gerüstprojekt und eine Webanwendung für die Site (wie in Django Tutorial Teil 2: Erstellung einer Gerüstwebsite beschrieben). Sie könnten 'diyblog' für den Projektnamen und 'blog' für den Anwendungnamen verwenden.
-
Erstellen Sie Modelle für die Blogartikel, Kommentare und alle anderen benötigten Objekte. Denken Sie bei der Planung daran:
- Jeder Kommentar wird nur einen Blog haben, aber ein Blog kann viele Kommentare haben.
- Blogartikel und Kommentare müssen nach Veröffentlichungsdatum sortiert werden.
- Nicht jeder Benutzer wird notwendigerweise ein Blogautor sein, obwohl jeder Benutzer Kommentator sein kann.
- Blogautoren müssen auch biografische Informationen enthalten.
-
Führen Sie Migrationen für Ihre neuen Modelle durch und erstellen Sie einen Superuser.
-
Verwenden Sie die Verwaltungsseite, um einige Beispiel-Blogartikel und Blogkommentare zu erstellen.
-
Erstellen Sie Ansichten, Vorlagen und URL-Konfigurationen für Blogartikel- und Bloggerlisten-Seiten.
-
Erstellen Sie Ansichten, Vorlagen und URL-Konfigurationen für Blogartikel- und Bloggerdetailseiten.
-
Erstellen Sie eine Seite mit einem Formular zum Hinzufügen neuer Kommentare (denken Sie daran, dass dies nur für angemeldete Benutzer verfügbar ist!).
Hinweise und Tipps
Dieses Projekt ist dem LocalLibrary Tutorial sehr ähnlich. Sie können das Gerüst, das Benutzeran-/Abmeldeverhalten, die Unterstützung für statische Dateien, Ansichten, URLs, Formulare, Basistemplates und die Admin-Site-Konfiguration fast alle nach denselben Ansätzen einrichten.
Einige allgemeine Hinweise:
-
Die Indexseite kann als einfache Funktionsansicht und -vorlage implementiert werden (genau wie für die locallibrary).
-
Die Listenansicht für Blogartikel und Blogger sowie die Detailansicht für Blogartikel können mit den generischen Listen- und Detailansichten erstellt werden.
-
Die Liste der Blogartikel für einen bestimmten Autor kann durch Verwendung einer generischen Bloglistenansicht erstellt werden, indem die Blogobjekte gefiltert werden, die dem angegebenen Autor entsprechen.
- Sie müssen
get_queryset(self)
implementieren, um das Filtern durchzuführen (ähnlich wie in unserer BibliotheksklasseLoanedBooksAllListView
) und die Autorinformationen aus der URL abrufen. - Sie müssen auch den Namen des Autors der Seite im Kontext übergeben. Um dies in einer klassenbasierten Ansicht zu tun, müssen Sie
get_context_data()
implementieren (weiter unten besprochen).
- Sie müssen
-
Das Kommentar hinzufügen Formular kann mit einer funktionsbasierten Ansicht (und zugehörigem Modell und Formular) oder mit einer generischen
CreateView
erstellt werden. Wenn Sie eineCreateView
verwenden (empfohlen), dann:-
Sie müssen auch den Namen des Blogartikels zur Kommentarseite im Kontext übergeben (implementieren Sie
get_context_data()
, wie weiter unten besprochen). -
Das Formular sollte nur die Kommentar-"Beschreibung" für die Benutzereingabe anzeigen (Datum und zugeordneter Blogartikel sollten nicht bearbeitbar sein). Da sie nicht im Formular selbst enthalten sein werden, muss Ihr Code den Autor des Kommentars in der Funktion
form_valid()
festlegen, damit er im Modell gespeichert werden kann (wie hier beschrieben — Django-Dokumentation). In derselben Funktion setzen wir den zugehörigen Blog. Eine mögliche Implementierung wird unten gezeigt (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 angeben, um nach der Formularvalidierung dorthin zu leiten; dies sollte der ursprüngliche Blog sein. Um dies zu tun, müssen Sie
get_success_url()
überschreiben und die URL für den ursprünglichen Blog "umkehren". Sie können die benötigte Blog-ID mit dem Attributself.kwargs
abrufen, wie in derform_valid()
Methode oben gezeigt.
-
Wir haben kurz darüber gesprochen, wie man einen Kontext an das Template in einer klassenbasierten Ansicht übergibt, im Thema Django Tutorial Teil 6: Generische Listen- und Detailansichten. Um dies zu tun, müssen Sie get_context_data()
überschreiben (zuerst den bestehenden Kontext abrufen, ihn mit zusätzlichen Variablen aktualisieren, die Sie an das Template übergeben möchten, und dann den aktualisierten Kontext zurückgeben). Beispielsweise zeigt das folgende Codefragment, wie Sie ein Bloggerobjekt basierend auf deren BlogAuthor
-ID in den 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 das fertige Beispiel anschauen, das ein Projekt mit "vollen Punkten" widerspiegelt.
Sobald Sie dieses Modul abgeschlossen haben, haben Sie auch alle MDN-Inhalte zum Erlernen der grundlegenden Django-Server-Seiten-Website-Programmierung abgeschlossen! Wir hoffen, Sie haben dieses Modul genossen und haben Sie ein gutes Verständnis der Grundlagen erlangt!