Installation

Hinweise zur lokalen Installationunter Windows für Tests und den Grundaufbau.

12.11.2017: Installation des Apache-Webserver XAMPP, da er unter Windows 10 gut funktioniert und einige der ursprünglichen Probleme mit dem Admin-Plugin von GRAV behebt. Der ursprüngliche Ansatz mit einer separaten Installation von PHP wird nicht mehr weiterverfolgt.

01.04.2018: Nach einem Rechnerwechsel und vielen Versuchen (mit Linux in verschiedenen virtuellen Umgebungen) wird der Ansatz unter Windows 10 mit XAMPP wieder weiter verfolgt und funktioniert bislang ohne Probleme.

08.02.2021: Nach der Aktualisierung auf PHP 7.4 wurde die Startseite nicht mehr gefunden. Lösung: Anmelden als admin und das Theme aktivieren (war seltsamerweise inaktiv). Nicht vergessen: Startseite auch als Default-Seite eintragen in den Einstellungen.

Installationsinhalte und Reihenfolge

Das CMS GRAV erlaubt eine einfache Installation unter Windows zum Testen der Website. Ich verwende lokal Windows 10. Das Entpacken der einzelnen Archive ist ausreichend.

  1. XAMPP herunterladen Link und installieren bzw. das entsprechende Archiv entpacken unter C:\xampp.

  2. Anpassung der Datei "httpd.conf" im Verzeichnis "C:\xampp\apache\conf" im Bereich "" => AllowOverride All

  3. Apache Webserver über XAMPP starten. Am einfachsten über das mitinstallierte XAMPP Control Panel.

  4. GRAV (oder ein Skeleton mit vorkonfigurierten Themes und Templates) herunterladen und entpacken in "C:\xampp\htdocs". Die Benennung grav des Ordners kann zwar beibehalten werden; ich habe den Ordner entsprechend meiner Website umbenannt in jvoigtmann. ACHTUNG: Das Admin-Plugin finde ich absolut empfehlenswert. In manchen vorbereiteten Skeletons wird zwar beschrieben dass diese enthalten ist - fehlt dann aber doch.

  5. Prüfen ob das Admin-Plugin vorhanden ist: unter "C:\xampp\htdocs\Website\user\plugins" mitWebsite = jvoigtmann in meinem Fall, muss der Ordner "admin" vorhanden sein. Falls nicht Schritt 5 ausführen.

  6. PHP-Installation ggf. prüfen: neue Datei "phpinfo.php" erstellen im grav-Verzeichnis "C:\xampp\htdosc\WEBSITE\" mit dem folgenden Inhalt. ACHTUNG: Datei vor der Veröffentlichung im Internet löschen, da diese sonst Sicherheitsprobleme machen kann.

    • <?PHP
    • phpinfo ();
    • ?>

  7. Das Admin-Plugin kann nachträglich installiert werden: Herunterladen der folgenden PlugIns von der GRAV-Website: "admin", "login", "form" und "email". PlugIns extrahieren in "C:\xampp\htdocs\WEBSITE\user\plugins.

  8. Starten des Admin-PlugIns über Webbrowser und "http://localhost/WEBSITE/admin". Admin-User wird einmalig angelegt und kann danach angewendet werden.

  9. Ab hier und in Zukunft: im Admin-PlugIn >"GRAV aktualisieren" und > "Check for updates" um alle GRAV-Inhalte zu aktualisieren.

  10. Mit dem Admin-PlugIn ist es zum Beispiel möglich online/lokal die Inhalte der Website (auch der einzelnen Seiten über einen integrierten Editor und deren Struktur) zu bearbeiten.

  11. Weitere User können bei Bedarf über die Admin-Oberfläche angelegt werden. Die ist für mich aktuell nicht notwendig.

  12. Bei Bedarf weitere PlugIns oder Themes herunterladen und installieren. Ich habe dies meist über das jeweilige ZIP-Archiv direkt in die Verzeichnisstruktur erledigt.

  13. Der eigentliche Seitenaufbau und die Gestaltung erfolgt über die Erstellung der einzelnen Seiten der Website.

  14. Das komplette Paket (also den Ordner unter "C:\xampp\htdocs\WEBSITE") auf die Internetpräsenz hochladen.

Updates

Bei dem Update von Plugins unbedingt auf die empfohlene Reihenfolge achten: Zuerst GRAV, danach PlugIns aktualisieren. Wird diese Reihenfolge nicht eingehalten kann es zu erheblichen Problemen kommen.

Wird die Website hochgeladen kommt es häufiger vor, dass der Aufruf der Startseite zum Fehler "404" führt; d.h. es wird keine Seite gefunden. Ich kann aus der Erfahrung folgende Vorgehensweise empfehlen:

  1. Startseite lokal aufrufen (mit laufendem Webserver) => alles in Ordnung
  2. Startseite der Internetpräsenz aufrufen => Fehler "404"
  3. Zum Admin-Plugin wechseln => www.WEBSITE/admin => wird das Admin-Loginpanel angezeigt, ist dies ein gutes Zeichen
  4. Als Admin anmelden
  5. Alle Caches löschen
  6. In das Konfigurationspanel wechseln und "Save" (auch wenn nichts geändert wurde)
  7. Aus Adminpanel ausloggen
  8. Erfahrungsgemäß kann die Startseite jetzt aufgerufen werden. Wenn nicht dann nochmals die Seiten prüfen (evtl. mit Browser-Entwicklertools)

Lokal können die Updates (wie auch online) direkt über das Admin-PlugIn abgerufen und installiert werden. Falls ein Befehl über das Kommandozeilenfenster aufgerufen wird, muss unter Windows "php" vorangestellt werden. Beispiel: "bin/grav install" funktioniert nicht. Die korrekte Befehlszeilenagabe lautet "php bin/grav install".

Theme

Es wird von GRAV empfohlem keine Änderungen an dem installierten Theme vorzunehmen, sondern über ein abgeleitetes, selbst verwaltetes, Theme alle Anpassungen zu machen. Dies funktioniert bei mir leider nur zum Teil (was auch ältere Forenbeiträge dokumentieren). Ich berichte ausführlicher wnn es neue Erkenntnisse gibt.