Похоже, что нет возможности добавлять задачи в:
Как-то бейджи не работают. Неужели я что-то делаю неправильно?
Вам нужен URL-адрес реального репозитория или URL-адрес проекта?
Можете ли вы добавить пример возможных URL-адресов в файл README?
Могу ли я просто добавить организацию, и все публичные репозитории будут учитываться для бейджей?
Есть ли какая-либо визуальная обратная связь, которая могла бы подсказать мне, делаю ли я что-то неправильно или правильно?
Также, не могли бы вы подробно объяснить, как именно происходит сопоставление пользователя с коммитами в GitHub? Работает ли это через сопоставление адресов электронной почты или имён? Что мне следует посоветовать моим сообществам сделать, чтобы получить бейджи GitHub? Им необходимо авторизоваться через GitHub?
Приносим извинения за задержку с ответом на ваш вопрос. Сейчас я тестирую плагин, следуя инструкции: https://meta.discourse.org/t/discourse-github/99895.
Одно из отличий между инструкцией и файлом README плагина заключается в том, что в инструкции указано: для получения бейджей необходимо сгенерировать токен доступа к GitHub. Этот токен нужно добавить в настройку сайта github linkback access token, прежде чем бейджи будут присвоены.
Чтобы создать токен доступа, перейдите по адресу Sign in to GitHub · GitHub. Если вы используете токен только для выдачи бейджей, вам не нужно выбирать какие-либо области доступа (scopes). Просто прокрутите страницу в самый низ и нажмите кнопку «Generate Token».
Ещё одной настройкой, необходимой для бейджей, является github badges repo. Введите полный URL каждого вашего репозитория GitHub, для которого вы хотите получать бейджи. URL, отображаемый в адресной строке вашего браузера, подойдёт для этой цели.
Плагин создаёт 6 бейджей:
Первые три бейджа в списке автоматически включаются при их создании плагином. Последние три бейджа необходимо включить вручную на странице «Администрирование / Бейджи».
Количество коммитов, необходимое для получения бейджей «Frequent committer» и «Amazing committer», можно настроить с помощью параметров сайта github silver badge min commits и github gold badge min commits.
Ещё один важный момент: бейджи выдаются фоновой задачей, которая запускается каждые 4 часа. Это означает, что между моментом активности пользователя на GitHub и моментом получения им бейджа может пройти до 4 часов.
Пользователи определяются по адресу электронной почты, указанному в коммите GitHub. В большинстве случаев это будет email пользователя. Для пользователей, которые настроили git на использование адреса без ответа от GitHub (<username>@users.noreply.github.com), плагин пытается найти пользователя по части имени пользователя в этом адресе. Для этого он ищет совпадение по имени пользователя в таблице Discourse GithubUserInfo. Пользователи будут найдены таким образом только в том случае, если они ранее входили в Discourse через GitHub.
Я также изучаю функционал обратных ссылок (linkback) плагина. Очень скоро я обновлю файл README плагина и руководство на Meta.
Если вы настраиваете плагин на хостинге, который предоставляем мы, вы можете получить персональную поддержку, отправив письмо на адрес технической поддержки, указанный в панели администратора вашего сайта.
Большое спасибо за такое подробное объяснение. Это действительно очень помогло.
У меня есть одно предложение по добавлению функционала в плагин, которое, вероятно, не слишком сложно реализовать. Как администратор, я знаю ключевых инженеров, с которыми моя команда взаимодействует на GitHub и на форуме. Таким образом, мы знаем обе идентичности. Считаете ли вы возможным вручную связать пользователя Discourse с учётной записью GitHub через настройки плагина? Это позволило бы активировать плагин даже в тех случаях, когда он не может автоматически найти пользователя.