Konfigurieren von Google Firebase für MemberPress AppKit

Google Firebase Cloud Messaging powers push notifications on Android and iOS platforms. Firebase integration enables real-time alerts for members through the mobile application.

This document covers creating a Firebase project, enabling the API, generating service keys, registering mobile apps, and uploading configuration files.

Firebase-Integration verstehen

Firebase Cloud Messaging liefert Push-Benachrichtigungen an Mitgliedergeräte auf iOS- und Android-Plattformen. Firebase V1 API bietet die aktuelle Messaging-Infrastruktur und ersetzt ältere Messaging-Systeme. Die ordnungsgemäße Firebase-Konfiguration erfordert die Projekterstellung, die API-Aktivierung, die Generierung eines Service-Kontos und die App-Registrierung für beide Plattformen.

Firebase-Projekt erstellen

Die Erstellung eines Firebase-Projekts bildet die Grundlage für die Bereitstellung von Push-Benachrichtigungen.

1. Melden Sie sich bei der Firebase-Konsole an unter konsole.firebase.google.de.
2. Klicken Sie auf Erstellen Sie ein neues Firebase-Projekt auf der Seite Projekte.

3. Geben Sie einen Projektnamen in das Feld „Projektname“ ein.

4. Klicken Sie auf Weiter um mit dem nächsten Schritt fortzufahren.
5. Optional aktivieren Google Analytics durch Umschalten des Schalters.
6. Wählen oder akzeptieren Sie den Standard Analytik Konto, falls aktiviert.
7. Klicken Sie auf Projekt erstellen um die Projekterstellung abzuschließen.
8. Warten Sie, bis die Projekteinrichtung abgeschlossen ist.
9. Klicken Sie auf Weiter um das neue Projekt-Dashboard zu öffnen.

Aktivieren der Firebase Cloud Messaging-API

Die Firebase Cloud Messaging API muss aktiviert sein, bevor die Push-Benachrichtigungen funktionieren.

1. Klicken Sie auf die Einstellungen Zahnradsymbol im Firebase-Projekt.
2. Wählen Sie Projekt-Einstellungen aus dem Dropdown-Menü.

3. Klicken Sie auf die Cloud-Messaging tab.

4. Überprüfen Sie die Firebase Cloud Messaging API zeigt eine grüne “Aktiviert” Indikator.
5. Wenn die Firebase Cloud Messaging API (V1) nicht aktiviert ist, klicken Sie auf das Menü ⋮.

6. Wählen Sie Verwalten der API in der Google Cloud Console aus dem Menü.

7. Klicken Sie auf Aktivieren Sie über die Cloud Messaging API Seite.
8. Bestätigen Sie die Anzeige des API-Status als “Aktiviert“.

Firebase Cloud Messaging API (V1) ersetzt die Legacy Cloud Messaging API für eine verbesserte Funktionalität.

Erzeugen des Firebase Service Kontoschlüssels

Der Schlüssel für das Dienstkonto ermöglicht die Authentifizierung für WordPress, um Push-Benachrichtigungen über Firebase zu senden.

1. Navigieren Sie zu Projekteinstellungen > Dienstkonten in der Firebase-Konsole.

2. Blättern Sie zum Firebase Admin SDK Abschnitt.
3. Klicken Sie auf die Neuen privaten Schlüssel generieren Taste.
4. Klicken Sie auf Schlüssel generieren in dem Bestätigungs-Pop-up.

5. Speichern Sie die heruntergeladene JSON-Datei an einem sicheren Ort.

Anmerkung: Der Schlüssel für das Dienstkonto kann nach der ersten Erstellung nicht erneut heruntergeladen werden. Speichern Sie die Datei sicher für den WordPress-Upload.

Erstellen einer Firebase iOS App

Die iOS-App-Registrierung verbindet das MemberPress AppKit mit Firebase für iOS-Push-Benachrichtigungen.

1. Klicken Sie auf das + App hinzufügen auf dem Dashboard des Firebase-Projekts.

2. Klicken Sie auf die iOS um die Registrierung der iOS-App zu starten.

3. Navigieren Sie zu Dashboard > MP AppKit > Konfigurieren > iOS-Einstellungen in WordPress.
4. Kopieren Sie die Bundle-ID auf der iOS-Einstellungsseite.

5. Kehren Sie zur Firebase-Konsole zurück und fügen Sie die Bundle-ID ein.
6. (Optional) Fügen Sie Ihren App-Spitznamen und Ihre App Store ID hinzu.

7. Klicken Sie auf App registrieren um die iOS-App zu erstellen.
8. Herunterladen der GoogleService-Info.plist Datei.
9. Klicken Sie auf Weiter durch die restlichen Einrichtungsschritte.
10. Klicken Sie auf Weiter zur Konsole um die Registrierung der iOS-App abzuschließen.

Firebase Android App erstellen

Die Android-App-Registrierung verbindet das MemberPress AppKit mit Firebase für Android-Push-Benachrichtigungen.

1. Klick + App hinzufügen auf dem Firebase-Projekt-Dashboard, wenn es nicht bereits geöffnet ist.

2. Klicken Sie auf die Android Symbol, um die Registrierung der Android-App zu starten.

3. Navigieren Sie zu Dashboard > MP AppKit > Konfigurieren > Android-Einstellungen in WordPress.
4. Kopieren Sie die ID der Anwendung auf der Seite mit den Android-Einstellungen.

5. Kehren Sie zur Firebase-Konsole zurück und fügen Sie die Anwendungs-ID ein.
6. (Optional) Fügen Sie Ihren App-Spitznamen hinzu.

7. Klicken Sie auf App registrieren um die Android-App zu erstellen.
8. Herunterladen der google-services.json Datei.
9. Klicken Sie auf Weiter durch die Schritte 2-4 des Einrichtungsassistenten.
10. Klicken Sie auf Erledigt um die Registrierung der Android-App abzuschließen.

Verbindung von Firebase mit MemberPress AppKit

Die Firebase-Konfigurationsdateien müssen für die Push-Benachrichtigungsfunktion in WordPress hochgeladen werden.

1. Navigieren Sie zu Dashboard > MP AppKit > Configure > Google Firebase.
2. Suchen Sie die Firebase Cloud Messaging API V1 Abschnitt.
3. Klicken Sie auf Hochladen neben dem Feld für den Schlüssel des Servicekontos.

4. Wählen Sie die heruntergeladene JSON-Dienstkontodatei aus.
5. Klicken Sie auf Hochladen neben dem Feld iOS-Konfigurationsdatei.
6. Wählen Sie die GoogleService-Info.plist Datei für iOS.
7. Klicken Sie auf Hochladen neben dem Feld Android-Konfigurationsdatei.
8. Wählen Sie die google-services.json Datei für Android.
9. Optional können Sie die Konfigurationsdateien der Testanwendung in die Testabschnitte hochladen.
10. Klicken Sie auf Einstellungen speichern um die Firebase-Konfiguration abzuschließen.

Die Firebase V1 API-Konfiguration ersetzt die Legacy Cloud Messaging API für eine verbesserte Bereitstellung von Push-Benachrichtigungen.

Überprüfen der Firebase-Konfiguration

Die Überprüfung der Firebase-Konfiguration gewährleistet die ordnungsgemäße Einrichtung der Push-Benachrichtigungsfunktion.

1. Navigieren Sie zu Dashboard > MP AppKit > Configure > Google Firebase.
2. Überprüfen Sie, ob die Schlüsseldatei für das Dienstkonto erfolgreich hochgeladen wurde.
3. Bestätigen Sie, dass die iOS-Konfigurationsdatei im Abschnitt iOS angezeigt wird.
4. Bestätigen Sie, dass die Android-Konfigurationsdatei im Abschnitt Android angezeigt wird.
5. Prüfen Sie das Einstellungen speichern wurde nach dem Hochladen angeklickt.
6. Navigieren Sie zur Firebase-Konsole und stellen Sie sicher, dass sowohl iOS- als auch Android-Apps angezeigt werden.
7. Bestätigen Sie, dass die Firebase Cloud Messaging API ein “Aktiviert”Status".

Eine ordnungsgemäße Firebase-Konfiguration ermöglicht das Testen von Push-Benachrichtigungen und deren Zustellung an die Geräte der Mitglieder.