Plugin Update Checker: Konfiguration
Konfiguration des Plugin Update Checkers: Cache Duration (hours, Standard 6) und GitHub Token (optional), Zahlenregeln, Rate Limits und Einrichtung eines Tokens.
Plugin Update Checker: Konfiguration
Die Konfiguration öffnest du im Admin Panel unter Manage > Plugins über das Plugin Plugin Update Checker und dessen Instanz. Das Plugin ist ein Singleton und hat genau eine Instanz. Die Feldbezeichnungen erscheinen in der Standardsprache auf Englisch. Beide Felder sind optional, das Plugin funktioniert auch mit den Standardwerten.
Felder
| Feld | Typ | Standard | Wirkung |
|---|---|---|---|
| Cache Duration (hours) | Textfeld, maximal 4 Zeichen | 6 |
Wie viele Stunden eine erfolgreiche GitHub-Antwort wiederverwendet wird, bevor GitHub erneut gefragt wird. |
| GitHub Token (optional) | Textfeld, maximal 255 Zeichen | leer | Personal Access Token, der bei jeder GitHub-Anfrage als Authorization: Bearer-Header mitgeschickt wird. |
Die Hinweistexte im Admin Panel lauten: How long to cache GitHub API responses (default: 6 hours) und Personal Access Token for higher API rate limits (60/h without, 5000/h with token).
Regeln für die Cache-Dauer
- Der Wert wird als ganze Zahl gelesen. Eine Eingabe wie
1.5zählt als1. - Leer,
0oder kein Zahlenwert ergibt den Standard von 6 Stunden. - Der kleinste wirksame Wert ist 1 Stunde. Kleinere und negative Zahlen werden auf 1 angehoben.
- Die Dauer gilt für erfolgreiche Antworten. Fehlgeschlagene Abfragen werden fest eine Stunde gemerkt, unabhängig von dieser Einstellung.
- Bereits gespeicherte Cache-Einträge behalten ihre alte Ablaufzeit. Eine geänderte Dauer wirkt erst bei neu geschriebenen Einträgen.
GitHub-Token
Ohne Token fragt das Plugin GitHub anonym ab. Laut Hinweistext des Feldes gelten dann 60 Anfragen pro Stunde, mit Token 5000. Pro geprüftem Plugin ist bei leerem Cache eine Anfrage nötig. Ein Token brauchst du daher nur bei vielen Plugins oder wenn du in der Fehlerbehebung auf Rate-Limit-Meldungen stößt.
- In GitHub unter Settings > Developer settings > Personal access tokens einen Token erzeugen.
- Für öffentliche Repositories sind keine Berechtigungen (Scopes) nötig.
- Den Token in das Feld GitHub Token (optional) einfügen und speichern.
Das Feld ist ein gewöhnliches Textfeld, kein Passwortfeld. Der Token steht im Klartext in der Plugin-Konfiguration und ist für jeden Admin sichtbar, der die Konfiguration öffnet. Vergib deshalb einen Token ohne Berechtigungen.
Private Repositories lassen sich nur prüfen, wenn der Token Zugriff darauf hat. Ohne Token ist nur öffentlicher Zugriff möglich.