Blog einrichtung

In dieser Anleitung werden wir deine neleto-Instanz so einrichten, dass du ganz einfach Blogbeiträge veröffentlichen kannst.

Voraussetzungen

Dein Benutzer muss die Rolle developer oder admin haben, um die Einstellungen und Components verwalten zu können.

Du musst die erste Einrichtung deiner neleto-Installation abgeschlossen haben, bevor du mit Blogbeiträgen loslegen kannst. Mehr Infos findest du unter Einrichtung.

Du solltest dich auch mit Components und Seiten vertraut machen.

Component für Blogbeiträge erstellen

Als erstes musst du einen Component erstellen, der speziell für die Darstellung von Blogbeiträgen gedacht ist. Zum Glück kommt deine neleto-Installation bereits mit einer Vorlage dafür. Um diese Vorlage zu nutzen, geh auf die Components-Seite in der Admin-Oberfläche und klick auf + Neu aus Vorlage. Du siehst dann eine Liste mit verfügbaren Vorlagen, und eine davon heißt Blog post content. Klick auf die Vorlage namens Blog post content, um einen Component basierend auf dieser Vorlage zu erstellen. Jetzt kannst du diesen neuen Component anpassen, damit er zum Design deiner Website passt, oder einfach auf Speichern und schließen klicken, um das Fenster zu schließen. Dieser Component wird nun ein Blogbeitrag darstellen, wenn er in der richtigen Seite eingebunden wird.

Erstelle eine Seite zum Anzeigen von Blogbeiträgen

Zusätzlich zum Blogbeitrag-Content-Component brauchst du eine Seite, die als Pfad zur Darstellung von Blogbeiträgen dient. Um diese Seite zu erstellen, geh zur Seiten-Übersicht in der Admin-Oberfläche und klick auf + Neu. Du landest dann im Pagebuilder, wo wir ein paar Dinge einstellen müssen. Genau wie bei der Seite für Blogbeiträge muss die Route dieser Seite einen Parameter namens slug haben. Das kriegst du mit einem Pfad wie diesem hin: /post/:slug. Achte auf den Teil :slug, das ist der Pfad-Parameter (gekennzeichnet durch das :) und sein Name ist slug. Der erste Teil (/post) kann alles sein, was du willst, auch mehrere Wörter, getrennt durch /. Wir empfehlen, mindestens ein Wort vor dem Parameter zu verwenden, um das Risiko von Überschneidungen mit anderen Seiten zu verringern, da der :slug-Parameter durch den Slug des besuchten Blogbeitrag ersetzt wird. Wenn zum Beispiel jemand ein Blogbeitrag mit dem Slug mein-toller-post besucht und die Blogbeitrag-Seite eine Route von /post/:slug hat, sieht die resultierende URL so aus: /post/mein-toller-post.

Als zweites musst du deinen neuen Blog post content-Component in diese Seite einbauen. Wechsel dafür zum Elemente-Tab im Pagebuilder und klick auf + Element erstellen. Es erscheint ein Popup mit einer Liste aller Components in deiner Installation. Einer davon sollte der Blog post content sein. Wenn du ihn nicht siehst, kannst du die Suche oben im Popup nutzen, um danach zu suchen. Wenn du ihn gefunden hast, klick drauf, um ein Element mit diesem Component zu erstellen. Wenn du die Vorlage ohne Änderungen verwendest, musst du am Element selbst nichts mehr ändern.

Als drittes musst du den Status auf Veröffentlich setzen, sonst können Besucher deine Blogbeiträge nicht sehen.

Und als letztes musst du den Render-Modus auf Dynamisch stellen, da der Slug-Parameter für jeder Blogbeitrag anders sein wird. Wenn er auf Vorgerendert bleibt, kann es passieren, dass Besucher nicht den Blogbeitrag sehen, auf das sie geklickt haben.

Du kannst jetzt weitere Elemente zu dieser Seite hinzufügen oder deinen Blog-post-Content-Component in andere Elemente verschachteln. Wenn du fertig bist, speicher die Seite und sie ist bereit, Blogbeiträge anzuzeigen.

Verknüpfe die Blogbeitrag-Seite in den Einstellungen

Deine neu erstellte Seite muss jetzt in den Einstellungen registriert werden, damit neleto weiß, wie Blogbeitrag-Links generiert werden sollen. Geh dafür zur Einstellungen-Seite, die findest du in der unteren linken Ecke der Admin-Oberfläche (wenn du nicht gerade in einem Builder bist). Auf der Einstellungen-Seite musst du gar nicht runterscrollen, da der Seiten-Bereich ganz oben ist. In diesem Bereich findest du ein Dropdown namens Blog post page. Wenn der Status deiner Blogbeitrag-Seite auf Öffentlich steht, solltest du ihren Titel in diesem Dropdown sehen, wenn du drauf klickst. Klick auf deine Blogbeitrag-Seite im Dropdown, um sie für die Darstellung von Blogbeiträgen zu registrieren.

Jetzt kannst du deine Einstellungen speichern. Deine neleto-Installation ist jetzt bereit, Blogbeiträge anzuzeigen. Wir empfehlen allerdings auch eine Seite zu erstellen, die eine Übersicht über alle deine Blogbeiträge zeigt, was wir im nächsten Abschnitt machen werden.

Erstelle eine Seite zur Anzeige einer Blogbeitrag-Liste

Die einzige Voraussetzung für diese Seite ist, dass sie ein Element mit dem Component Blog post list braucht.

Erstelle einen Blogbeitrag-Listen-Component

neleto bietet auch für diesen Component eine Vorlage an. Um sie zu nutzen, geh zur Components-Seite in der Admin-Oberfläche und klick wieder auf + Neu aus Vorlage. Du solltest eine Vorlage namens Blog post list sehen, klick drauf, um sie zu erstellen. Das ist standardmäßig ein sehr simpler Component, er hat nur eine Eigenschaft, in der du die Liste der anzuzeigenden Blogbeiträge festlegen kannst. In der Vorlage gehen wir mit dem {{#each ...}}...{{/each}} Block durch alle Blogbeiträge in dieser Eigenschaft durch und erstellen einen einfachen Link für jeden Blogbeitrag. Der Helper post_path macht aus dem Blogbeitrag einen Link zur Blogbeitrag-Seite, die du in den Einstellungen registriert hast. Du könntest den Component so lassen, aber vielleicht willst du ihn erweitern, um zusätzlich den Titel, Start- und Endzeitpunkt und das Hero-Bild jedes Blogbeitrags anzuzeigen. Wenn du mit dem Bearbeiten des Components fertig bist, klick auf Speichern und schließen.

Den Blogbeitrag-Listen-Component verwenden

Um deinen neuen Blogbeitrag-Listen-Component zu verwenden, erstelle entweder eine neue Seite nur für die Blogbeitrag-Liste oder füge ihn in eine bestehende Seite ein. In beiden Fällen musst du nur zum Elemente-Tab im Pagebuilder wechseln und auf + Element erstellen an der Stelle klicken, wo deine Liste erscheinen soll. Dann wählst du den Component Blog post list aus und bist im Prinzip fertig. Du kannst jetzt auch die Liste der Blogbeiträge mit den Regeln im Element einschränken, denn standardmäßig zeigt sie jeden Blogbeitrag an, das du erstellst und veröffentlichst.