Quickstart Page
Bisher haben wir angeschaut, wie man ein Modul entwickelt und dessen Inhalte über Rocket verwalten kann. Jetzt schauen wir uns an, wie du mit dem Page Modul eine gesamte Webseite erstellen kannst. Ausserdem schauen wir uns an, wie wir das Blog Modul auf einer Seite einbinden können!
Voraussetzungen Quickstart Page
Der Quickstart für das Page Modul baut auf den Quickstarts von n2n und Rocket auf. Wir haben ein Composer Projekt vorbeitet, welches dir den benötigten Codestand automatisch installiert. Führe dazu folgenden Composer Befehl in der Konsole aus:
composer create-project n2n/page-quickstart-skeleton page-qs
Datenbank
Genau gleich wie für Rocket brauchen wir auch für das Page Modul eine Datenbank Verbindung. Du findest unter var/bak/backup.sql
ein komplettes Backup. Führe dieses SQL File auf deiner Datenbank aus!
Wenn du auf deinem bisherigen Projekt aufbauen willst, musst du auf deiner Datenbank die Installations SQL Datei im Page Modul (var/etc/page/install.my.sql
) ausführen.
Rocket
Um die Inhalte des Page Modules zu verwalten brauchen wir Rocket. Wie du die URL von Rocket anpassen kannst, ist im Quickstart von Rocket beschrieben. Wenn du jetzt ins Rocket gehst, werden wir in Rocket noch keine Möglichkeit haben, unsere Seiten zu verwalten.
Page konfigurieren
Wenn du das Composer Projekt installiert hast, dann ist Page bereits richtig konfiguriert. Falls nicht, musst du folgende Anpassungen machen:
Schau zuerst ins File /var/etc/page/rocket/specs.json
rein. Fast zuunterst findest du folgende Zeilen:
"menuItems": { "page-page": [] }
Diese bedeuten, dass das Page Modul die EiSpec page-page
als Menüpunkt zur Verfügung steht. Diesen Menüpunkt wollen wir in unser var/srv/rocket/layout.json
einbauen. Dieses soll so ausschauen:
{ "menuGroups": { "Seitenverwaltung": { "page-page": "Seiten" }, "Inhalt": { "qs-blog-article": "Artikel", "qs-blog-category": "Kategorien", "qs-blog-comment": "Kommentare" } } }
layout.json
muss den JSON Standard genau einhalten. Vergisst du ein Komma oder hast eines zu viel, wirft Rocket sofort eine Exception (corrupted json file source). Wenn du den Fehler nicht findest, empfehlen wir dir, dein JSON zu validieren. Dazu gibt es im Netz diverse Services (suche nach 'json lint' oder 'json validator'.Nach diesem Eintrag können wir in Rocket Seiten erfassen. Gehe jetzt ins Rocket. Neu müsstest du im Menü die Punkte Seitenverwaltung sehen. Im Moment hat es natürlich noch keine Seiten drinnen. Das werden wir gleich ändern!