Оновлення з Git: токен доступу до приватного репозиторію

Оновлення з Git (Baza Helper > Оновлення з Git, інструмент Pro) встановлює тему з репозиторію Git. Публічному репозиторію токен не потрібен. Приватному потрібен токен, який дозволяє сайту читати його, і лише читати.

Перш ніж почати

• Публічний репозиторій: залишайте Токен доступу (приватний репозиторій) порожнім. Якщо токен уже збережено, натисніть Видалити збережений токен.
• Приватний репозиторій: створіть токен, який читає лише цей один репозиторій і нічого більше, щоб він не завдав шкоди, якщо колись потрапить не в ті руки.
• Токен зберігається в зашифрованому вигляді й більше не показується. Скопіюйте його, коли його покаже хостинг.

GitHub: fine-grained токен

1. Відкрийте github.com/settings/personal-access-tokens/new (Settings, Developer settings, Personal access tokens, Fine-grained tokens).
2. Введіть назву й виберіть дату завершення дії.
3. Resource owner: ваш обліковий запис. Якщо репозиторій належить організації, виберіть організацію. Можливо, організація має схвалити токен, перш ніж він запрацює.
4. Repository access: виберіть Only select repositories і позначте репозиторій із вашою темою.
5. Repository permissions: для Contents виберіть Read-only. Metadata: Read-only GitHub додає сам. Решту залиште як No access.
6. Натисніть Generate token, скопіюйте токен і вставте його в Токен доступу (приватний репозиторій).
7. Натисніть Зберегти зміни, потім Перевірити зараз. Кнопки працюють зі збереженими налаштуваннями.

GitLab

Створіть особистий або проєктний токен доступу з областю read_repository. Проєктному токену потрібна роль Reporter або вища. Вставте його в те саме поле.

Bitbucket

Відкрийте репозиторій, потім Repository settings, Access tokens, і створіть repository access token з правом читання. Вставте його в те саме поле.

Що замінює синхронізація

• Оновити зараз замінює всю папку теми вмістом архіву репозиторію. Файл, який є на сайті, але його немає в архіві, після цього зникає.
• Baza Helper не читає .gitignore. Усе, що там вказано, наприклад vendor/ чи node_modules/, у репозиторії немає, тож після синхронізації це зникне з сайту. Закомітьте папки, потрібні темі під час роботи, або зберіть їх перед надсиланням.
• GitHub не кладе до свого архіву те, що в .gitattributes позначено export-ignore, тож ці файли також зникнуть із сайту.
• Перед кожним оновленням зберігається zip поточної теми. Зберігаються найновіші копії (Скільки копій зберігати, типово 3), а Відкотити встановлює найновішу.

Часті помилки

• Репозиторій відхилив збережений токен (401 або 403): токен прострочено, його створено для іншого власника чи іншого репозиторію, організація його не схвалила, для Contents не встановлено Read-only або токен вставлено з пробілом.
• Репозиторій не знайдено (404), зокрема під час завантаження архіву: адреса неправильна, або токен не може читати вміст цього приватного репозиторію. Створіть токен знову з правами, описаними вище. Для організації виберіть її як Resource owner.
• Репозиторій просить вхід, а токен не збережено: репозиторій приватний. Додайте токен і збережіть.
• У репозиторії немає теми в цьому місці: там немає style.css з Theme Name. Перевірте Папка теми всередині репозиторію.
• Репозиторій публічний, але токен збережено: неправильний або прострочений токен може змусити хост відмовити в доступі до репозиторію, який може читати будь-хто. Видаліть токен: публічному репозиторію він не потрібен.