Aktualizácie z Gitu: prístupový token k súkromnému repozitáru

Aktualizácie z Gitu (Baza Helper > Aktualizácie z Gitu, nástroj Pro) nainštaluje tému z repozitára Git. Verejný repozitár token nepotrebuje. Súkromný potrebuje token, ktorý webu dovolí čítať ho, a iba čítať.

Skôr než začnete

• Verejný repozitár: pole Prístupový token (súkromný repozitár) nechajte prázdne. Ak je token už uložený, stlačte Odstrániť uložený token.
• Súkromný repozitár: vytvorte token, ktorý číta len tento jeden repozitár a nič iné, aby nenarobil škodu, ak by raz unikol.
• Token sa ukladá zašifrovaný a už sa nezobrazí. Skopírujte ho, keď ho hostiteľ ukáže.

GitHub: token typu fine-grained

1. Otvorte github.com/settings/personal-access-tokens/new (Settings, Developer settings, Personal access tokens, Fine-grained tokens).
2. Zadajte názov a vyberte dátum platnosti.
3. Resource owner: váš účet. Ak repozitár patrí organizácii, vyberte organizáciu. Organizácia možno musí token schváliť, kým začne fungovať.
4. Repository access: vyberte Only select repositories a označte repozitár s vašou témou.
5. Repository permissions: pre Contents nastavte Read-only. Metadata: Read-only pridá GitHub sám. Ostatné nechajte na No access.
6. Stlačte Generate token, skopírujte token a vložte ho do poľa Prístupový token (súkromný repozitár).
7. Stlačte Uložiť zmeny, potom Skontrolovať teraz. Tlačidlá pracujú s uloženým nastavením.

GitLab

Vytvorte osobný alebo projektový prístupový token s rozsahom read_repository. Projektový token potrebuje rolu Reporter alebo vyššiu. Vložte ho do rovnakého poľa.

Bitbucket

Otvorte repozitár, potom Repository settings, Access tokens, a vytvorte repository access token s oprávnením na čítanie. Vložte ho do rovnakého poľa.

Čo synchronizácia nahrádza

• Aktualizovať teraz nahradí celý priečinok témy obsahom archívu repozitára. Súbor, ktorý je na webe, ale nie je v archíve, potom zmizne.
• Baza Helper nečíta súbor .gitignore. To, čo je v ňom uvedené, napríklad vendor/ alebo node_modules/, nie je v repozitári, takže po synchronizácii z webu zmizne. Pošlite do repozitára priečinky, ktoré téma potrebuje za chodu, alebo ich pred odoslaním zostavte.
• GitHub do svojho archívu nedá to, čo je v .gitattributes označené export-ignore, takže aj tieto súbory z webu zmiznú.
• Pred každou aktualizáciou sa uloží zip aktuálnej témy. Uchovávajú sa najnovšie kópie (Počet uchovávaných kópií, predvolene 3) a Vrátiť späť nainštaluje najnovšiu.

Časté chyby

• Repozitár odmietol uložený token (401 alebo 403): platnosť tokenu vypršala, vytvorili ste ho pre iného vlastníka alebo iný repozitár, organizácia ho neschválila, pri Contents nie je nastavené Read-only, alebo bol token vložený s medzerou.
• Repozitár sa nenašiel (404), aj pri sťahovaní archívu: adresa je nesprávna, alebo token nevie čítať obsah tohto súkromného repozitára. Vytvorte token znova s právami uvedenými vyššie. Pri organizácii ju vyberte ako Resource owner.
• Repozitár žiada prihlásenie a token nie je uložený: repozitár je súkromný. Pridajte token a uložte.
• V repozitári tam nie je téma: na tom mieste chýba style.css s Theme Name. Skontrolujte Priečinok témy v repozitári.
• Repozitár je verejný, ale token je uložený: nesprávny alebo vypršaný token môže spôsobiť, že hostiteľ odmietne repozitár, ktorý môže čítať ktokoľvek. Token odstráňte: verejný repozitár ho nepotrebuje.