DonateX-Einstellungen

Wird separat installiert: Dieses Modul ist nicht im Installer der App enthalten. Öffne Modulkatalog → Add-ons und klicke auf seiner Karte auf Installieren; bis dahin hat die App es nicht.

Was diese Seite ist

Verbindungen → Monetarisierung → DonateX ist der Ort, an dem DonateX ein API-Token gegeben wird, damit Spenden die App erreichen. Zwei Dinge befinden sich hier: der Schalter Spenden annehmen und das Token selbst.

Wie man es einrichtet

1. Öffne Verbindungen → Monetarisierung und drücke DonateX verbinden auf der Karte. Auf einer bereits verbundenen Karte öffnet dieselbe Seite mit Konfigurieren. Der Pfeil oben links, Zurück, bringt dich zurück zur Liste.
2. Die Seite ist mit DonateX-Einstellungen überschrieben, darunter steht "Konfiguriere DonateX, um Spendenbenachrichtigungen zu erhalten.".
3. Die oberste Zeile ist Spenden annehmen, mit dem Untertitel DonateX, einem Badge und einem Schalter. Der Schalter wirkt in dem Moment, in dem du ihn umlegst – er wartet nicht auf die Speichern-Schaltfläche. Wenn er aus ist, zeigt das Badge Deaktiviert an und es wird nichts empfangen.
4. Drücke DonateX-Dashboard öffnen. Es öffnet donatex.gg in deinem normalen Browser. Der Hinweis sagt, wo du suchen musst: "DonateX stellt das Token in deinem Dashboard unter Einstellungen → Api aus."
5. Kopiere das Token von dieser Seite und füge es in API-Token ein. Das Feld verbirgt, was du eingibst; solange es leer ist, steht dort "Füge dein DonateX-API-Token ein".
6. Drücke Einstellungen speichern in der oberen rechten Ecke. Es meldet den Status zurück – Speichern…, dann Gespeichert, oder Fehler, wenn das Token nicht gespeichert wurde. Nach erfolgreichem Speichern schließt sich die Seite selbst und kehrt zur Liste der Dienste zurück.
7. Ein Speicherversuch mit leerem Feld und noch keinem gespeicherten Token wird mit "Bitte gib dein DonateX-API-Token ein." abgelehnt.
8. Öffne die Seite erneut, um zu überprüfen. Das Token-Feld ist absichtlich leer – ein gespeichertes Token wird dir nie wieder angezeigt. Dass es existiert, wird durch den Hinweis im Feld gesagt: "Token gespeichert – leer lassen, um es beizubehalten". Wenn du das Feld leer lässt und Einstellungen speichern drückst, bleibt das gespeicherte Token unberührt; um es zu ersetzen, tippe das neue darüber.
9. Das Badge neben dem Schalter zeigt dir den Status der Verbindung an: Nicht verbunden (noch kein Token), Deaktiviert (der Schalter ist aus), Verbinde…, Neuer Token erforderlich, Verbindungsfehler oder Verbunden als {username}. Es aktualisiert sich selbst alle paar Sekunden, solange die Seite geöffnet ist.
10. Neuer Token erforderlich bedeutet, dass das gespeicherte Token nicht mehr funktioniert. Hole dir ein neues im DonateX-Dashboard und speichere es über das alte.

Eine Ablehnung gilt nicht sofort als endgültig. Hat DonateX dieses Token schon einmal angenommen, antwortet die App auf eine Ablehnung mit einer Pause und einem neuen Versuch: 5 Sekunden, dann 10, 20 und so weiter, bis zu fünf Minuten. Neuer Token erforderlich erscheint erst, wenn die Ablehnungen zehn Minuten lang anhalten, und selbst dann wird das Token alle fünf Minuten erneut versucht, sodass das Badge von selbst zurückspringt, sobald DonateX es annimmt. Ein Token, das DonateX noch nie angenommen hat, verlangt sofort nach Ersatz.

Was ankommt und was es zählt

• Eine DonateX-Spende kommt als gewöhnliches Spendenereignis an, sodass Alerts, Ziele, die Auktion und die Sprachausgabe sie aufgreifen, ohne überhaupt über DonateX informiert werden zu müssen.
• Der Betrag wird in deine Basiswährung umgerechnet, genau wie bei jedem anderen Dienst.
• Eine Spende, die vom DonateX-Dashboard als Test gesendet wird, kommt wie jede andere an und zählt für Ziele und die Auktion. Das ist beabsichtigt: Ein Test, der die Gesamtsummen überspringen würde, könnte nicht verwendet werden, um sie zu überprüfen. Lösche sie danach aus Statistiken und ihr Beitrag wird wieder herausgenommen.
• Der Name des Spenders kommt mit der Spende an. Eine anonym gesendete Spende wird als anonym angezeigt.

Was es nicht kann

• Das Token kann nicht aus der App ausgelesen werden – das Feld zeigt nichts, und es gibt keine Enthüllungsfunktion.
• Hier gibt es keine Browser-Anmeldung: Das Token wird von Hand kopiert. Die Schaltfläche öffnet nur das DonateX-Dashboard, sie holt nichts ab.
• Der Kontoname wird nicht eingegeben. Er kommt mit der Verbindung, und das Badge zeigt ihn als Verbunden als {username} an, sobald das Token funktioniert.
• Der Schalter regelt nur, ob DonateX akzeptiert wird. Er ist nicht das Ein/Aus des Moduls im Katalog, und er trennt nichts anderes ab.
• Trennen und Verbindung entfernen (das Mülleimer-Symbol) befinden sich auf der DonateX-Karte unter Verbindungen → Monetarisierung, nicht auf dieser Seite.
• Hier werden keine Spenden, Beträge oder Verläufe angezeigt – diese Seite betrifft nur den Zugang.
• Spenden, die ankamen, während die App geschlossen war, werden nicht nachgeholt. Die App holt nur die Zeit auf, in der sie tatsächlich verbunden war: Wenn die Live-Verbindung eine Weile still war, wird das Verpasste wiederhergestellt, aber die Stunden, in denen die App nicht lief, werden danach nicht aufgefüllt.