Aktionen und Einstellungen nach der Installation ermöglichen
Zusätzliche Einstellungen nach der App-Installation unterstützen.
Installiert ein/e Nutzer/in Ihre App, können Sie weitere Aktionen oder Konfigurationsschritte verlangen. Ihre App kann beispielsweise verlangen, dass der/die Nutzer/in gesonderte Anmeldedaten für den Zugriff auf externe Dienste bereitstellt. Bei Stripe-Apps werden diese Zusatzschritte als Aktionen nach der Installation bezeichnet. Dabei stehen verschiedene Kategorien zur Auswahl:
- Innerhalb der App mit der SettingsView-Komponente
- Extern über einen Link zu einer externen Website
Legen Sie keine Aktionen nach der Installation fest, zeigt das Dashboard die App nach der Installation an.
Aktion nach der Installation hinzufügen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
So fügen Sie eine sogenannte Aktion nach der Installation hinzu:
Öffnen Sie Ihre App-Manifest-Datei.
Fügen Sie das neue Feld
post_
hinzu.install_ action stripe-app.json{ "id": "com.invoicing.[YOUR_APP]", "version": "1.2.3", "name": "[YOUR APP] Shipment Invoicing", "icon": "./[YOUR_APP]_icon_32.png", "permissions": [], "app_backend": {}, "ui_extension": {}, "post_install_action": {} }
Fügen Sie eine Konfigurationsoption für die
post_
hinzu, die Ihrem Anwendungs-Setup spricht.install_ action Erstellen Sie eine neue App-Version.
Veröffentlichen Sie Ihre App im Marketplace.
Konfigurationsoptionen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe Apps unterstützt die folgenden Aktionen nach der Installation:
App-Verlinkung (Standardeinstellung)![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Standardmäßig werden die Nutzer/innen nach der Installation Ihrer App zur Nutzeroberfläche der Anwendung weitergeleitet (sofern vorhanden).
![Bildschirm nach der Installation mit einem Link zum Anzeigen einer App](https://b.stripecdn.com/docs-statics-srv/assets/app.09cbbc38c50cfef0a9aaf9a92f8d1d0e.png)
Dazu sind keine weiteren Einstellungen erforderlich.
Verlinken Sie eine externe URL![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Sollen die Nutzer/innen für die App-Konfiguration auf eine externe Seite weitergeleitet werden, ändern Sie in Ihrem App-Manifest den Parameter post_
folgendermaßen:
{ "id": "com.invoicing.[YOUR_APP]", "version": "1.2.3", "name": "[YOUR APP] Shipment Invoicing", "icon": "./[YOUR_APP]_icon_32.png", "permissions": [], "app_backend": {}, "ui_extension": {}, "post_install_action": { "type": "external", "url": "https://[YOUR-URL]" } }
Ersetzen Sie [YOUR-URL]
durch die URL der externen Website.
Nach der Installation wird in der App eine Schaltfläche angezeigt, über die die Nutzer/innen zu der in der Anwendungsmanifestdatei angegebenen URL weitergeleitet werden.
Diese URL enthält den Abfragezeichenfolgenparameter account_
, mit dem Sie den/die Nutzer/in identifizieren können. Zum Beispiel:
https://www.company.com/marketplace/stripe?account_id=12345
![Bildschirm nach der Installation mit einem externen Link](https://b.stripecdn.com/docs-statics-srv/assets/external.565e55096589e7c7580bc5d534c1ace1.png)
Verlinkung auf Einstellungen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Enthält Ihre App eine SettingsView-Komponente, können Sie eine post_
einrichten, damit diese nach der Installation geöffnet wird. Dazu ändern Sie Ihre Anwendungsmanifestdatei wie folgt:
{ "id": "com.invoicing.[YOUR_APP]", "version": "1.2.3", "name": "[YOUR APP] Shipment Invoicing", "icon": "./[YOUR_APP]_icon_32.png", "permissions": [], "app_backend": {}, "ui_extension": {}, "post_install_action": { "type": "settings" } }
Wird Ihre Anwendung installiert, wird darin eine Schaltfläche angezeigt, über die die Nutzer/innen zur SettingsView-Komponente Ihrer App gelangen.
![Bildschirm nach der Installation mit einem Link zum Anzeigen der Einstellungen](https://b.stripecdn.com/docs-statics-srv/assets/settings.e6bc859871bc657c25d353055497c8ee.png)