Cevi Drupal Seite

Das ist ein Projekt, damit du mit Hilfe vom CMS "Drupal" deine eigene Cevi-Webseite erstellen kannst.

Schnellstart (Docker)

Für die lokale Entwicklung wird nur Docker benötigt — kein PHP, Composer oder Node lokal nötig.

git clone https://github.com/cevi/cevi-drupal.git
cd cevi-drupal
cp .env.example .env        # Werte anpassen falls nötig
docker compose up -d --build

Siehe DOCKER.md für die vollständige Dokumentation (Entwicklung, Produktion, Backups).

---

Voraussetzungen (ohne Docker)

Folgende Voraussetzungen müssen gegeben sein:

• PHP 8.2+, composer 2+ global installiert
• node 20+, npm global installiert
• Irgendein (lokaler) Server sollte vorhanden sein
• Eine Datenbank (mysql) mit den nötigen Zugängen muss vorhanden sein.

Vorbereitung

Im Ordner settings muss eine Datei settings.current.php erstellt werden. Als Vorlage können die Dateien settings/settings.example.development.php oder settings/settings.example.production.php dienen.

Lokaler Server so einrichten, dass die Webseite im Verzeichnis ./drupal/web aufgerufen werden kann

Einfache Installation

1. Frontend einmalig generieren: $ npm install; npm run build

2. $ cd drupal

3. Run $ ./cevi-install.sh

4. Besuche deine Seite und Logge dich ein unter DOMAIN/user/login mit dem Zugang admin/cevi. Wechsle dein Passwort.

Detaillierte Installation

1. Frontend einmalig generieren: $ npm install; npm run build

2. $ cd drupal

3. $ composer install

4. Drupal installieren: Seite besuchen und Installation starten. Installationsprogramm kann unter DOMAIN//core/install.php aufgerufen werden. Diese Seite wird automatisch geladen.

   1. Sprache: Deutsch
   2. Installationsprofil: Standard
   3. Eigene Informationen eingeben (Name der Webseite, Emailadresse, Admin-User, ...)
   4. Oder via Konsole: $ ./vendor/bin/drush si --locale=de

5. Ein paar Anpassungen an der frischen Drupal-Seite anpassen:

   1. $ ./vendor/bin/drush config-set system.site uuid eb76eb7c-70c3-4296-960b-673b5f7702af -y
   2. $ ./vendor/bin/drush config-set language.entity.de uuid 7e2040a3-be26-44ad-ba1e-c5902dded730 -y
   3. $ ./vendor/bin/drush config-set shortcut.set.default uuid 6e0504ef-46e5-42bf-a1a2-cd097c1689ce -y
   4. $ ./vendor/bin/drush cdel field.field.node.article.body
   5. $ ./vendor/bin/drush cdel field.field.node.page.body
   6. $ ./vendor/bin/drush ev '\Drupal::service("entity_type.manager")->getStorage("shortcut_set")->load("default")->delete();'

6. $ vendor/bin/drush cim -y Importiert die Konfiguration für die ganze Webseite.

Erste Schritte

1. Admin-Passwort wechseln
2. Unter Inhalt > Inhalt hinzufügen > Landingpage (/node/add/landingpage) eine Startseite hinzufügen.
3. Weitere Seiten hinzufügen.
4. Unter Cevi (/admin/cevi) kannst du dein Logo hinzufügen und dein Slogan für die Startseite. Das Logo kannst du im Cevi-Logo-Generator erstellen.
5. Unter Struktur > Menüs > Social-Media (/admin/structure/menu/social-media-menu) kannst du deine Sozialen Medien verlinken.
6. Am gleichen Ort bei der Hauptnavigation kannst du das Hauptmenü bearbeiten.
7. Ebenfalls bei den Menüs kannst du das Fussmenü erstellen und da zumindest die beiden folgenden Links hinzufügen
   1. Login der auf /user/login verlinkt
   2. Logout der auf /user/logout verlinkt. Drupal wird automatisch nur den einen der beiden anzeigen.

Frontend bearbeiten

$ npm install

Die Dateien vom Frontend liegen im Ordner ./cevi-themes bereit und werden im Composer-Prozess (siehe Installation in die entsprechenden Verzeichnisse im Drupal-Verzeichnis kopiert.

$ npm run build Bereitet alle Dateien vor und optimiert alle Frontend-Dateien

$ npm run watch Startet den Befehl, die aktuellen Bearbeitungen am Frontend zu überwachen.

$ cd drupal && composer install && cd .. Um die Frontend-Dateien ins Drupal-System einzugliedern.

Weitere Funktionen

Datenbank-Abbild

$ drupal/vendor/bin/drush cr && drupal/vendor/bin/drush sql-dump --result-file=../../db_dumps/export.sql --gzip