Git-Updates: Zugriffstoken für ein privates Repository

Git-Updates (Baza Helper > Git-Updates, ein Pro-Werkzeug) installiert ein Theme aus einem Git-Repository. Ein öffentliches Repository braucht kein Token. Ein privates braucht ein Token, mit dem die Website es lesen kann, und nur lesen.

Bevor Sie anfangen

• Öffentliches Repository: Lassen Sie Zugriffstoken (privates Repository) leer. Ist schon ein Token gespeichert, klicken Sie auf Das gespeicherte Token entfernen.
• Privates Repository: Erstellen Sie ein Token, das nur dieses eine Repository lesen kann und sonst nichts, damit es keinen Schaden anrichtet, falls es einmal in falsche Hände gerät.
• Das Token wird verschlüsselt gespeichert und nie wieder angezeigt. Kopieren Sie es, sobald der Host es zeigt.

GitHub: ein Fine-grained-Token

1. Öffnen Sie github.com/settings/personal-access-tokens/new (Settings, Developer settings, Personal access tokens, Fine-grained tokens).
2. Geben Sie einen Namen ein und wählen Sie ein Ablaufdatum.
3. Resource owner: Ihr Konto. Gehört das Repository einer Organisation, wählen Sie die Organisation. Möglicherweise muss die Organisation das Token genehmigen, bevor es funktioniert.
4. Repository access: Wählen Sie Only select repositories und markieren Sie das Repository mit Ihrem Theme.
5. Repository permissions: Setzen Sie Contents auf Read-only. Metadata: Read-only fügt GitHub selbst hinzu. Alles andere bleibt auf No access.
6. Klicken Sie auf Generate token, kopieren Sie das Token und fügen Sie es in Zugriffstoken (privates Repository) ein.
7. Klicken Sie auf Änderungen speichern, dann auf Jetzt prüfen. Die Schaltflächen arbeiten mit den gespeicherten Einstellungen.

GitLab

Erstellen Sie ein persönliches oder ein Projekt-Zugriffstoken mit dem Scope read_repository. Ein Projekt-Token braucht die Rolle Reporter oder höher. Fügen Sie es in dasselbe Feld ein.

Bitbucket

Öffnen Sie das Repository, dann Repository settings, Access tokens, und erstellen Sie ein Repository access token mit Leseberechtigung. Fügen Sie es in dasselbe Feld ein.

Was ein Sync ersetzt

• Jetzt aktualisieren ersetzt den gesamten Theme-Ordner durch den Inhalt des Repository-Archivs. Eine Datei, die auf der Website liegt, aber nicht im Archiv, ist danach weg.
• Baza Helper liest die .gitignore nicht. Was dort steht, zum Beispiel vendor/ oder node_modules/, liegt nicht im Repository und verschwindet daher nach dem Sync von der Website. Committen Sie die Ordner, die Ihr Theme zur Laufzeit braucht, oder erzeugen Sie sie vor dem Push.
• GitHub lässt aus seinem Archiv weg, was in .gitattributes mit export-ignore markiert ist. Auch diese Dateien verschwinden von der Website.
• Vor jedem Update wird ein Zip des aktuellen Themes gespeichert. Die neuesten Kopien bleiben erhalten (Aufzubewahrende gespeicherte Kopien, standardmäßig 3), und Zurücksetzen installiert die neueste.

Häufige Fehler

• Das Repository hat das gespeicherte Token abgelehnt (401 oder 403): Das Token ist abgelaufen, wurde für einen anderen Besitzer oder ein anderes Repository erstellt, eine Organisation hat es nicht genehmigt, Contents steht nicht auf Read-only, oder das Token wurde mit einem Leerzeichen eingefügt.
• Das Repository wurde nicht gefunden (404), auch beim Laden des Archivs: Die Adresse stimmt nicht, oder das Token kann den Inhalt dieses privaten Repositorys nicht lesen. Erstellen Sie das Token neu mit den oben genannten Rechten. Wählen Sie bei einer Organisation diese als Resource owner.
• Das Repository verlangt eine Anmeldung und es ist kein Token gespeichert: Es ist privat. Fügen Sie ein Token hinzu und speichern Sie.
• Das Repository enthält dort kein Theme: An dieser Stelle fehlt eine style.css mit Theme Name. Prüfen Sie Theme-Ordner im Repository.
• Das Repository ist öffentlich, aber ein Token ist gespeichert: Ein falsches oder abgelaufenes Token kann dazu führen, dass der Host ein Repository verweigert, das jeder lesen darf. Entfernen Sie das Token: Ein öffentliches Repository braucht keines.