Chancenportal

Datenbank und Landkarte der Angebote und Anbieter zur Unterstützung von Benachteiligten

Hintergrund und Zweck des Portals

Das „Chancenportal“ wurde im Rahmen des Projekts „Synergien vor Ort“ der Bertelsmann Stiftung entwickelt. Das Projekt hatte zum Ziel, die Zusammenarbeit zwischen Zivilgesellschaft, Verwaltung und Bürgern in den Handlungsfeldern Kinder- und Jugendarbeit, Flüchtlingshilfe und Seniorenarbeit zu untersuchen und zu verbessern. Ein zentraler Befund des Projekts lag darin, dass es in vielen Kommunen in den genannten Bereichen an einem Überblick über Angebote und Anbieter fehlt, ohne den eine bessere Zusammenarbeit nur begrenzt realisierbar ist. Das „Chancenportal“ dient dem Zweck, einen umfassenden Überblick über Angebote und Anbieter für soziale Leistungen im lokalen Raum herzustellen (insbesondere in den Bereichen Kinder- und Jugendarbeit, Bildung, Seniorenarbeit und Flüchtlingshilfe). Konkret sollen im Portal unterstützende Angebote von nicht gewinnorientierten Anbietern eingestellt werden. Die Stiftung verfolgt damit ausschließlich und unmittelbar gemeinnützige Zwecke, darunter die in § 2 Abs. 2 b und f ihrer Satzung genannte Förderung zeitgemäßer und wirkungsvoller Strukturen sowie innovative Modelle von Führung und Organisationen zur Erbringung öffentlicher Leistungen. Das Portal hat dabei mehrere Nutzergruppen im Blick, die einen unterschiedlichen Mehrwert durch das Portal erhalten sollen. Für die Zielgruppe (Kinder, Eltern, Senioren, Menschen mit Behinderungen, Geflüchtete etc.) aber auch vermittelnde Akteure (Lehrer, Betreuer, Sozial- und Sonderpädagogen) soll das Portal vor allem das zielsichere Finden passender Angebote ermöglichen. Für Anbieter (öffentliche, freie Träger, Initiativen, Vereine) soll sie eine Möglichkeit bieten, Angebote an zentraler Stelle darzustellen und damit die jeweilige Zielgruppe besser zu erreichen. Für Planer auf Seiten der Träger und der Kommunalverwaltung soll sie einen Überblick über die Angebotslandschaft herstellen, der ein Auffinden von Überangeboten und Angebotslücken erleichtert, um neue Angebote darauf anzupassen, Kooperationspartner zu finden und die Angebotslandschaft beispielsweise im Rahmen der Jugendhilfeplanung besser auszubalancieren. Ergänzend zum Portal wurde eine praxisorientierte Handlungsanleitung für kommunale Vertreter/innen erstellt, die Empfehlungen gibt, wie der Einführungsprozess inhaltlich begleitet werden kann (Durchführung einer Bestandsaufnahme von Anbietern und Angeboten für ein Handlungsfeld, Überzeugung von relevanten Stakeholdern und Bewerbung des Portals bei den Zielgruppen).

Kernfunktionen des Portals

Das Portal stellt im Kern eine Datenbank über Angebote und Anbieter dar, die durch den Nutzer durchsucht und umfangreich gefiltert werden können. Der Nutzer kann über das Portal via mail-to Funktion einen Anbieter zu einem Angebot kontaktieren. Die Eingabe der Daten zu Angeboten und Anbietern kann durch eine zentrale Redaktion sowie durch Nutzer erfolgen, die sich als Anbieter registriert haben und durch den Betreiber als solche qualifiziert und freigeschaltet wurden. Anbieter können zudem weitere Personen in ihrer Organisation freischalten, um Daten einzupflegen. Alle Anbieterbeschreibungen und Angebote müssen durch den Betreiber in Rolle der Redaktion freigeschaltet werden sowohl bei der Ersteinstellung als auch bei der Anpassung. Der Betreiber trägt damit Sorge dafür, dass nur solche Angebote und Darstellungen auf dem Portal ausgegeben werden, die dem Ziel des Portals entsprechen und den Nutzungsbedingungen nicht zuwiderlaufen. Hierfür kann er sich auch über die Nutzungsbedingungen das Recht einräumen, beispielsweise diskriminierende, kommerziell werbende oder dem Zweck nicht dienliche Inhalte nicht freizugeben, abzuändern oder auch nachträglich zu entfernen.

Hintergrund und Technik

Die Plattform wird durch die Bertelsmann Stiftung herausgegeben und wurde durch u+i interact im Auftrag der Bertelsmann Stiftung erstellt. Am Konzept der Plattform haben zudem die Stadt Rheda-Wiedenbrück als Pilot-Kommune sowie die SYSPONS GmbH mitgewirkt. Sie wird unter einer Open Source Lizenz veröffentlich, so dass die technologische Basis auch von anderen Städten und Gemeinden eingesetzt werden kann.

Das Chancenportal ist als Erweiterung für das TYPO3 CMS entwickelt worden, sodass die Inhalte und gespeicherten Daten durch eine Redaktion eingesehen und bearbeitet werden können. Eine Kommune, die sich dazu entscheidet, das Portal bei sich zu installieren und zu betreiben, hat die Möglichkeit, die Oberfläche mit geringem Aufwand optisch anzupassen. Der Einsatz ist dabei nicht auf den Bereich der Kinder- und Jugendarbeit begrenzt sondern für alle Bereiche offen, in denen eine Vielzahl von Anbietern und Angebote existieren und ein Überblick ermöglicht werden soll.

Installation

Das Repository enthält sämtliche Daten, um eine Basisplattform lauffähig zu machen:

• Anwendungscode
• Definierte Abhängigkeiten
• Datenbankdump (TYPO3, Extensions, Anwendungsdaten)

Systemanforderungen

• die Anwendung setzt PHP in Version 7.2 voraus
• Für den Import von Daten aus Excel-Dateien wird die Software PhpSpreadsheet, für die die folgenden Systemanforderungen erfüllt werden müssen: [PhpSpreadsheet Systemanforderungen] (https://phpspreadsheet.readthedocs.io/en/latest/#software-requirements)
• composer muss für die Installation der PHP-Abhängigkeiten installiert sein: https://getcomposer.org/. Eine alternative, aber nicht empfohlene Art der Installation für Shared Web-Hoster wird weiter unten unter dem Punkt "Step-by-step - Web-Hosting" beschrieben.
• darüber hinaus gelten die Anforderungen von TYPO3: https://typo3.org/cms/requirements/
• Symlinks erstellbar (Composer Installation)
• Unix / Linux Betriebssystem
• Das Document-Root sollte anpassbar sein, denn es muss auf den web Ordner gesetzt werden (Composer Installation)

Darüber hinaus empfehlen wir einen Root-Server / vServer zu benutzen, da Sie bei einfachen Web-Hosting-Angeboten meist nicht die erforderlichen Aktionen für die Installation ausführen können. Eine Anleitung für die Installation auf einfachen Web-Hosting-Angeboten finden Sie unter "Step-by-step - Web-Hosting".

Step-by-step - Root-Server / vServer

Zur Installation sind folgende Schritte notwendig:

1. Repository klonen: git clone https://github.com/bertelsmannstift/Chancenportal.git
2. Abhängigkeiten über composer installieren: composer install
3. Datenbankdump /database/chancenportal.sql in eine MySQL oder MariaDB laden
4. Setzen des Webroots auf den Ordner web
5. Konfiguration der Datenbank in der Datei .env vornehmen
6. Im TYPO3 kann über den Menüpunkt "Sites bzw. Seiten" eine Konfiguration für das Chancenportal erzeugt werden. Dies hat z.B. Auswirkungen auf die Erzeugung sprechender URLs. Siehe dazu auch Site Handling in der TYPO3 Dokumentation.

Je nach gesetzter TYPO3_CONTEXT Umgebungsvariable wird die entsprechende Konfigurationsdatei aus dem Ordner configuration geladen. Sie überschreibt die Standard-Konfiguration aus der Datei LocalConfiguration.php. Das bedeutet, dass eventuelle Änderungen im TYPO3 Installtool durch diese Datei überschrieben werden können.

Step-by-step - Web-Hosting

1. Laden Sie TYPO3 9.x herunter
2. Extrahieren Sie den Inhalt und laden Sie die Dateien auf Ihren Server, z. B. per (S)FTP oder SCP. Beachten Sie ggf. auch die offiziellen TYPO3-Hinweise zur Installation: Install TYPO3 Without Composer
3. Laden Sie die aktuelle Chancenportal-Anwendung herunter Chancenportal
4. Extrahieren Sie das Zip-Archiv und laden Sie den Inhalt des Ordners web auf Ihren Server
5. Laden Sie ebenfalls den Inhalt des Ordners packages auf Ihren Server in den Ordner typo3conf/ext hoch
6. Laden Sie das Paket Flux 9.2.0 herunter und kopieren Sie den Inhalt des Archivs nach typo3conf/ext/flux
7. Laden Sie das Paket PHPOffice/PhpSpreadsheet herunter und kopieren Sie den Inhalt des Archivs nach typo3conf/ext/chancenportal/Vendor/PhpSpreadsheet
8. Laden Sie das Paket Simple Cache PSR herunter und kopieren Sie den Inhalt des Archivs nach typo3conf/ext/chancenportal/Vendor/psr/simple-cache
9. Kopieren Sie die Datei typo3conf/ext/ui_sitepackage/Resources/Public/assets/css/_custom.css nach typo3conf/ext/ui_sitepackage/Resources/Public/assets/css/custom.css.
10. Ihre Datenbank wird in der Datei typo3conf/LocalConfiguration.php konfiguriert (Details zur Datenbank und den Zugangsdaten sollten im Backend Ihres Providers zu finden sein)
11. Importieren Sie den Datenbankdump (/database/chancenportal.sql) in eine neue MySQL- oder MariaDB-Datenbank
12. Melden Sie sich im TYPO3 Install-Tool (http://www.example.org/typo3/install.php) an und wählen Sie hier den Punkt "Maintenance" aus. Klicken Sie hier den Button "Dump autoload" in der Kachel "Rebuild PHP Autoload Information".
13. Melden Sie sich am TYPO3 Backend an https://www.example.org/typo3
14. Installieren und aktivieren Sie folgende Extensions im TYPO3 Backend:
    • typoscript_rendering (Version 2.2.2)
    • vhs (Version 5.2.0)
15. Im TYPO3 kann über den Menüpunkt "Sites bzw. Seiten" eine Konfiguration für das Chancenportal erzeugt werden. Dies hat z.B. Auswirkungen auf die Erzeugung sprechender URLs. Siehe dazu auch Site Handling in der TYPO3 Dokumentation.

TYPO3 Login

Folgende Standardpasswörter sind gesetzt und müssen nach der Installation geändert werden!

TYPO3 Backend

Benutzer: admin
Password: @hGjMZRjktL7u&

TYPO3 Installtool

Passwort: 760iniY9sTUUUF

Anpassung

Die Basisplattform kann über Farbwerte und den Austausch von Logos an das jeweilige Design der Kommune o.ä. angepasst werden. Folgende Änderungen sind vorgesehen:

• Tausch des Hauptlogos
• Anpassung der Hauptfarben im Portal
• Anpassung der Kategoriefarben
• Austausch des Favicons in web/favicons/ (https://www.favicon-generator.org/)
• Erweiterte CSS-Anpassung können in der Datei web/typo3conf/ext/ui_sitepackage/Resources/Public/assets/css/custom.css vorgenommen werden. Änderungen niemals in web/typo3conf/ext/ui_sitepackage/Resources/Public/assets/css/main.min.*.css vornehmen, da diese Datei ggf. durch Deployments aus dem Git heraus überschrieben wird!

Individuelle Frontend-Entwicklung

Für eine individuelle Frontend-Entwicklung werden die Source-Dateien im Verzeichnis ui_frontend bereitgestellt. Für eine lokale Entwicklung wird npm vorausgesetzt. Folgende Befehle müssen im Verzeichnis ui_frontend ausgeführt werden um die lokale Entwicklung zu starten:

• npm i
• npm run dev

Das Frontend ist nach dem Start im Browser über http://0.0.0.0:3000 erreichbar. Die zugrunde liegenden Source-Dateien liegen unter ui_frontend/src.

Um einen entwickelten Stand zu kompilieren und an den korrekten Stellen in der TYPO3 Verzeichnisstruktur abzulegen, muss folgender Befehl ausgeführt werden:

• npm run build

TYPO3 Upgrade von 9.5.x auf 10.4.x (Non-Composer)

Für das Upgrade von bestehenden Versionen des Chancenportals, die auf TYPO3-Version 9.5.x basieren, müssen die nachfolgenden Schritte ausgeführt werden. Es empfiehlt sich vor dem Upgrad Backups von Datenbank und Dateisystem zu machen und das Upgrade zunächst auf einer lokalen Maschine durchzuspielen.

1. Aktuelle TYPO3 10.4 Version von https://get.typo3.org/version/10 herunterladen und entpacken. Die Ordner typo3 und vendor in das Webroot des bestehenden Chancenportal kopieren und ggf. vorhandene Verzeichnisse ersetzen.
2. Aus dem aktuellen Github-Stand des Chancenportals müssen die folgenden TYPO3-Extensions aus dem Verzeichnis packages nach typo3conf/ext/ des bestehenden Chancenportals kopiert und bestehende Verzeichnisse ersetzt werden:
   • chancenportal
   • ui_ce
   • ui_ce_overrides
   • ui_forms
   • ui_grid
   • ui_provider
   • ui_sitepackage
3. Aus dem aktuellen Github-Stand des Chancenportals müssen die folgenden Dateien in das bestehende Chancenportal kopiert und bestehende Dateien ersetzt werden:
   • web/typo3conf/AdditionalConfiguration.php nach typo3conf/AdditionalConfiguration.php kopieren
   • web/typo3conf/PackageStates.php nach typo3conf/PackageStates.php kopieren
4. Folgende TYPO3-Extensions müssen im Verzeichnis typo3conf/ext/ des bestehenden Chancenportals mit den nachfolgend verlinkten Versionen ersetzt werden:
   • flux
   • typoscript_rendering
   • vhs
5. Im TYPO3-InstallTool unter DOMAIN/typo3/install.php anmelden und die folgenden Aufgaben durchführen:
   • Menüpunkt Maintenance
     • Analyze database
       • Alle Haken setzen und Apply selected changes klicken
       • Ggf. so lange wiederholen bis keine DB-Änderungen mehr angezeigt werden
   • Menüpunkt "Upgrade"
     • Run Upgrade Wizard und dann folgende Wizards ausführen:
       • Execute database migrations on single rows
   • Menüpunkt Maintenance
     • Caches leeren
6. Die Seite sollte nun wieder funktionieren und eine normale Anmeldung im TYPO3 möglich sein.

Bildmaterial

Als Platzhalter wurden Bilder der folgenden Fotografen verwendet:

• Kai Pilger on Unsplash
• Roman Kraft on Unsplash
• Matthew Kane on Unsplash