EP-Modul

Ehrenamtsplattform	Infos für Engagierte	Gruppen & Vereine

Das EP-Modul ist automatisch Teil jeder Smart Village App, muss jedoch für eine Nutzung und Darstellung auf dem Main-Server in den Static-Contents konfiguriert werden. Es benötigt entweder einen Menüpunkt oder eine Service-Kachel, um den Einstieg in das Modul einzurichten.

Für einen Menüpunkt müssen Titel und Screen angegeben werden. Für das Ehrenamt kann dies wie folgt geschehen:

"Ehrenamtsplattform": {
  "title": "Ehrenamtsplattform",
  "screen": "VolunteerHome",
  "rootRouteName": "Ehrenamtsplattform"
}

Der screen ist hierbei immer vom Wert VolunteerHome und beschreibt den Haupteinstiegspunkt des Moduls, von wo aus in alle weiteren Bereiche gelangt werden kann.

Für eine Service-Kachel ist es ähnlich:

{
  "title": "Ehrenamts-Plattform",
  "routeName": "VolunteerHome",
  "iconName": "charity",
  "params": {
    "title": "Unsere vielfältige Vereinslandschaft",
    "rootRouteName": "Ehrenamtsplattform"
  }
}

Was bei den Menüpunken als screen angegeben wird, ist in den Service-Kachlen der routeName und folgedessen ebenfalls VolunteerHome. Zusätzlich kann es ein Icon aus der entsprechend verwendeten Icon-Bibliothek geben, auf welches über den Bezeichner in iconName referenziert werden kann.

Die weiteren Unterbereiche bestehen ebenfalls aus Static-Contents und können individuell eingerichtet werden. Dabei kann es mehrere Konfigurations-JSONs bzw. Inhalts-HTMLs geben.

Auf dem Home-Screen des EP-Moduls kann es oben ein Bilder-Karussell geben. Dafür braucht es eine JSON-Konfiguration unter dem Namen volunteerCarousel. Der Inhalt kann von beliebig vielen Bilder-Objekten bestimmt werden, mit jeweils picture.uri-Einträgen zu Bild-Adressen.

Der Text unterhalb des Bild-Karussells, bzw. ganz oben, wenn kein Bild-Karussell eingerichtet ist, kann per HTML-Inhalt volunteerhometext gestaltet werden.

Sobald ein solcher HTML-Inhalt angelegt wurde, kann dieser auch komfortabel über das CMS editiert werden.

Sowohl das Bilder-Karussell als auch der Einstiegstext auf dem Home-Screen haben die Besonderheit, dass bei Bedarf unterschiedliche Inhalte für ausgeloggte oder eingeloggte Nutzer dargestellt werden können. Dafür gibt es für das Bilder-Karussell den JSON-Konfiguration mit der Bezeichnung volunteerCarousel-loggedIn und für den Einstiegstext den HTML-Inhalt mit der Bezeichnung volunteerhometext-loggedin. Wenn die Inhalte identisch sein sollen, dann können inhaltlich Kopien erstellt werden. Weiterführende Service-Kacheln in die anderen Bereiche der Ehrenamtsplattform können mit einer JSON-Konfiguration namens volunteerHomeTiles erstellt werden.

Auch hier gibt es die Möglichkeit für eingeloggte Nutzer andere Service-Kacheln anzubieten mittels volunteerHomeTiles-loggedIn. Der Code für den Home-Screen ist auf GitHub zu finden unter https://github.com/smart-village-solutions/smart-village-app-app/blob/master/src/screens/volunteer/VolunteerHomeScreen.tsx oder openCode unter https://gitlab.opencode.de/bad-belzig/smart-village-app/-/blob/master/src/screens/volunteer/VolunteerHomeScreen.tsx.