Erste Schritte in CraftCMS

Nachdem die Installation von Craft vorgenommen wurde und sowohl das Front- wie auch das Backend erreichbar ist, benötigt es ein paar erste Schritte, damit mindestens mal irgend ein Inhalt im Frontend angezeigt wird. Für den einfacheren Einstieg sind diese ersten Punkte hier beschrieben.

Installation von Redactor

Um einen Wysiwyg-Editor für den Inhalt zu bekommen, wird das Plugin "Redactor" installiert. Dieses bietet einen einfachen und schlichten Editor. Das Plugin kann über den Plugin-Store kostenlos heruntergeladen und direkt installiert werden. Ein weiteres Setup ist hierbei vorerst nicht nötig.

Erste Felder erstellen

Um irgendwas im Frontend angezeigt zu bekommen, müssen zuerst ein paar Felder im Backen erstellt werden, die dann auch gefüllt werden können. Es bietet sich an, hier erstmal mit einem PageTitle und einem PageContent zu beginnen.

Page Title

Das Feld "Page Title" wird als reines Textfeld erfasst.

Page Content

Das Feld "Page Content" wird als Redactor Feld erfasst.

Erstellung einer Sektion

Für die Hauptseiten wird als erstes eine Sektion erstellt. Der Name kann hierbei z.B. Main Pages heissen. Dies generiert den Slug mainPages. Als Sektions-Typ wird "Struktur" gewählt, damit die Seiten in mehreren Ebenen erstellt werden können.

Website-Einstellungen

Die Einstellungen der Sektion sind sehr wichtig. Das Eintrags-URI-Format lautet:

{parent.uri}/{slug}

Bei der Vorlage wird der folgende Pfad eingetragen:

pages/_entry

Eintragstyp bearbeiten

Zurück auf der Sektionen-Übersicht, wird der Eintragstyp "MainPages" bearbeitet.

  • Titelfeld anzeigen -> deaktivieren
  • Titelformat -> {{pageTitle}}
  • Feld-Layout -> Content-Tab hinzufügen (inkl. PageContent und PageTitle)

Damit sind die Vorbereitungen abgeschlossen und es kann der erste Eintrag (die erste Seite) erstellt werden.

Erstellung der Startseite

Um die Startseite der Website zu erstellen, wird ein neuer Eintrag in der Sektion "Main Pages" erstellt. wichtig ist hierbei der Slug. Hier muss zwingend folgender Slug eingetragen werden, damit die Seite als Startpunkt fungiert:

__home__

Wird das Frontend nun aufgerufen, wird versucht, die gerade erstellte Seite mit dem Slug __home__ aufzurufen. Das klappt allerdings nicht, da das entsprechende Template noch nicht vorhanden ist. Um dieses Problem zu lösen, brauchen wir endlich einen Code-Editor. ;)

Basic Template-Setup

Als Basis wird im Ordner /templates folgende Dateistruktur angelegt:

_layouts
  base.twig
  site.twig
pages
  _entry.twig

Die Dateien base.twig und site.twig kümmern sich um das Basis-Layout aller Seiten. Die Datei _entry.twig beinhaltet das eigentliche Template, bzw. den eigentlichen Hauptinhalt der angezeigten Frontend-Seite.

Das Frontend ist da!

Nachdem diese Dateien erstellt wurden, sollte das Frontend angezeigt werden. Das ist ein guter Startpunkt für das nächste Projekt.


Lokales CraftCMS Setup

Lokale Installation via Composer

Im ersten Schritt wird Craft heruntergeladen und direkt an der schlussendlichen Stelle installiert. Der Pfad am Ende des folgenden Scripts muss daher je nach Projekt angepasst werden.

composer create-project craftcms/craft ~/Dropbox/Websites/projectname

Setup von MAMP Pro

In MAMP Pro wird ein neuer Host eingerichtet. Das Document Root zeigt dabei auf das /web Unterverzeichnis des gerade installierten CraftCMS. In oben stehendem Beispiel wäre das somit:

markus/Dropbox/Websites/projectname/web

Dabei soll gleichzeitig eine Datenbank erstellt werden, also wird die entsprechende Checkbox angewählt. Im folgenden Schritt werden die gewünschten Datenbank-Credentials eingetragen.

Der Name des Hosts in MAMP Pro kann so gewählt werden, dass eine Endung verwendet wird. Hier bietet sich beispielsweise projekt.loc an. Ausserdem kann der Port manuell auf 80 geändert werden, das vereinfacht die lokale Test-URL ein wenig, da sonst die Seite mit dem Port :8888 aufgerufen werden muss.

Nach diesem Schritt wird der neue Host in MAMP Pro gespeichert und sollte danach direkt erreichbar sein. Beim Aufruf der entsprechenden Seite wird allerdings noch ein Fehler angezeigt, da das Setup von Craft noch nicht stattgefunden hat.

Basic Setup von CraftCMS

Um das Setup von Craft vorzunehmen, wird die URL mit dem Zusatz /admin erweitert um auf das Control Panel zu gelangen.

1. Datenbankverbindung

Für die Datenbankverbindung wird der Datenbank-Name, der Benutzername und das Passwort eingetragen.

2. Benutzer-Account

Der Benutzeraccount wird entsprechend den Vorstellungen erstellt.

3. System-Name

Der Systemname ist der Name der Website, welche gerade erstellt wird. Die Basis-URL kann unverändert bleiben.

CraftCMS ist installiert

Herzlichen Glückwunsch, CraftCMS ist somit bereits installiert.