Paramètres DonateX

S'installe à part : ce module n'est pas inclus dans l'installateur de l'application. Ouvrez Catalogue de modules → Extensions et cliquez sur Installer sur sa carte ; d'ici là, l'application ne l'a pas.

Ce qu'est cette page

Connexions → Monétisation → DonateX est l'endroit où DonateX reçoit un jeton API pour que les dons atteignent l'application. Deux éléments se trouvent ici : le commutateur Accepter les dons et le jeton lui-même.

Comment le configurer

1. Ouvrez Connexions → Monétisation et appuyez sur Connecter DonateX sur la carte. Sur une carte déjà connectée, la même page s'ouvre avec Configurer. La flèche en haut à gauche, Retour, ramène à la liste.
2. La page est intitulée Paramètres DonateX, avec "Configurez DonateX pour recevoir les notifications de dons." en dessous.
3. La ligne du haut est Accepter les dons, sous-titrée DonateX, avec un badge et un commutateur. Le commutateur agit au moment où vous le basculez — il n'attend pas le bouton d'enregistrement. Lorsqu'il est désactivé, le badge indique Désactivé et rien n'est reçu.
4. Appuyez sur Ouvrir le tableau de bord DonateX. Cela ouvre donatex.gg dans votre navigateur habituel. L'indice indique où chercher : "DonateX fournit le jeton dans votre tableau de bord, sous Paramètres → Api."
5. Copiez le jeton de cette page et collez-le dans Jeton API. Le champ masque ce que vous tapez ; lorsqu'il est vide, il invite à "Collez votre jeton API DonateX".
6. Appuyez sur Enregistrer les paramètres dans le coin supérieur droit. Il rend compte de lui-même — Enregistrement…, puis Enregistré, ou Erreur si le jeton n'a pas été stocké. Après un enregistrement réussi, la page se ferme et retourne à la liste des services.
7. L'enregistrement avec le champ vide et aucun jeton stocké est refusé avec "Veuillez saisir votre jeton API DonateX."
8. Rouvrez la page pour vérifier. Le champ du jeton est vide intentionnellement — un jeton stocké ne vous est jamais montré. Son existence est indiquée par l'invite dans le champ : "Jeton enregistré — laissez vide pour le conserver". Laisser le champ vide et appuyer sur Enregistrer les paramètres garde le jeton stocké intact ; pour le remplacer, tapez le nouveau par-dessus.
9. Le badge à côté du commutateur vous indique l'état de la connexion : Non connecté (pas encore de jeton), Désactivé (le commutateur est désactivé), Connexion…, Nouveau jeton requis, Erreur de connexion, ou Connecté en tant que {username}. Il s'actualise tout seul toutes les quelques secondes pendant que la page est ouverte.
10. Nouveau jeton requis signifie que le jeton stocké ne fonctionne plus. Obtenez-en un nouveau dans le tableau de bord DonateX et enregistrez-le par-dessus l'ancien.

Un refus n'est pas considéré comme définitif tout de suite. Si DonateX a déjà accepté ce jeton, l'application répond à un refus par une pause et un nouvel essai : 5 secondes, puis 10, 20 et ainsi de suite, jusqu'à cinq minutes. Nouveau jeton requis n'apparaît que lorsque les refus durent depuis dix minutes, et même alors le jeton est réessayé toutes les cinq minutes : le badge se rétablit donc de lui-même dès que DonateX l'accepte. Un jeton que DonateX n'a jamais accepté demande tout de suite à être remplacé.

Ce qui arrive, et ce que cela compte

• Un don DonateX arrive comme un événement de don ordinaire, donc les alertes, les objectifs, la vente aux enchères et la voix off le récupèrent sans avoir besoin de connaître DonateX.
• Le montant est converti dans votre devise de base, comme pour tout autre service.
• Un don envoyé depuis le tableau de bord DonateX en tant que test arrive comme n'importe quel autre et compte pour les objectifs et la vente aux enchères. C'est intentionnel : un test qui ignorerait les totaux ne pourrait pas être utilisé pour les vérifier. Supprimez-le ensuite de Statistiques et sa contribution est retirée.
• Le nom du donateur arrive avec le don. Un don envoyé anonymement apparaît comme anonyme.

Ce qu'il ne peut pas faire

• Le jeton ne peut pas être relu depuis l'application — le champ n'affiche rien, et il n'y a pas de contrôle de révélation.
• Il n'y a pas de connexion navigateur ici : le jeton est copié manuellement. Le bouton ouvre seulement le tableau de bord DonateX, il ne récupère rien.
• Le nom du compte n'est pas saisi. Il arrive avec la connexion, et le badge l'affiche comme Connecté en tant que {username} une fois que le jeton fonctionne.
• Le commutateur ne gère que l'acceptation de DonateX. Ce n'est pas l'activation/désactivation du module dans le catalogue, et il ne déconnecte rien d'autre.
• La déconnexion et Supprimer la connexion (l'icône poubelle) se trouvent sur la carte DonateX sous Connexions → Monétisation, pas sur cette page.
• Aucun don, montant ou historique n'est affiché ici — cette page concerne uniquement l'accès.
• Les dons arrivés pendant que l'application était fermée ne sont pas récupérés. L'application ne rattrape que le temps où elle était réellement connectée : si la connexion en direct a été silencieuse pendant un moment, ce qu'elle a manqué est récupéré, mais les heures où l'application ne fonctionnait pas ne sont pas comblées après coup.