Обновления из 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. Проверьте Папка темы внутри репозитория.
• Репозиторий публичный, но токен сохранён: неверный или просроченный токен может заставить хост отказать в доступе к репозиторию, который может читать любой. Удалите токен: публичному репозиторию он не нужен.