Github-Integration

GrischaBot

Erstellen von Issues aus Thema heraus

Erstelle Issues direkt aus einem Thema heraus. In Foren, welche mit Repositorys verbunden sind, erscheinen in Themen oben rechts der Button Issue erstellen. Das Formular zum Erstellen wird automatisch vorausgefüllt, kann aber durch den Anwender vorm Absenden beliebig verändert werden.

Nach dem Erstellen eines Issues, erhält der Themenersteller eine Benachrichtigung. Außerdem ist im Thema und in der Themenübersicht ersichtlich, dass dieses Thema mit einem Github-Issue verknüpft ist.

[Blockierte Grafik: https://www.woltlab.com/attachment/161012-board-create-issue-png/?thumbnail=1][Blockierte Grafik: https://www.woltlab.com/attachment/161013-board-show-linked-issue-png/?thumbnail=1]

Label-Sync

Sowohl in Github, als auch im WSC, gibt es die Möglichkeit Labels zu erstellen und diese zu verwenden. Der Label-Sync hilft beim Hinzufügen eines Repositorys automatisch die vorhandenen Github-Labels im WSC zu erstellen und anders herum automatisch die WSC-Labels in Github zu erstellen.

Sind bei einem Thema bereits Labels ausgewählt. Werden diese beim Issue erstellen automatisch vorausgewählt.

Allerdings werden aktuell keine Veränderungen von Labels innerhalb eines Issues oder Themas zwischen Github und Thema Issue synchronisiert. Dies ist aber für eine spätere Version geplant.

Meilensteine-Sync

Ähnlich wie beim Label-Sync ermöglicht der Meilensteine-Sync, dass Meilensteine automatisch in Labelgruppen als Label erstellt werden bzw. Labels als Meilensteine in Github erstellt werden.

Wird ein Meilenstein bei einem Issue in Github verwendet, wird automatisch das Label im verknüpften Thema gesetzt.

Verknüpfung zwischen Forum und Repository

Es besteht die Möglichkeit ein Forum mit einem oder sogar mehreren Repositorys zu verknüpfen. Wenn mehrere Repositorys verknüpft sind, wird beim Issue erstellen eine Auswahl der Repositorys angezeigt.

[Blockierte Grafik: https://www.woltlab.com/attachment/161008-acp-board-setting-png/?thumbnail=1]

Übersicht von Commits

Dieses Plugin bietet von Haus aus die Möglichkeit eine Überssichtsseite von Commits. Wenn du in deinem Repository Dateien änderst, werden die Commits automatisch via Webhook in deiner Datenbank gespeichert und auf der Übersichtsseite angezeigt. Zusätzlich kann auf dieser Überssichtsseite nach bestimmten Repositorys gefiltert werden.

[Blockierte Grafik: https://www.woltlab.com/attachment/161014-commits-png/?thumbnail=1]

Übersicht von Meilensteinen

Zusätzlich zu der Übersicht von Commits, gibt es eine Übersicht von Meilensteinen. Diese enthält alle Issues, welche mit einem Meilenstein verbunden sind. Bereits geschlossene Issues werden als durchgestrichen angezeigt. Für jeden Meilenstein gibt es eine eigene Progressbar mit Prozentanzeige.

[Blockierte Grafik: https://www.woltlab.com/attachment/161015-milestones-png/?thumbnail=1]

Benutzergruppenrechte

Recht Ort Beschreibung Kann Commits sehen Allgemeine Rechte > Github Regelt ob diese Gruppe die Commit-Übersicht sehen darf Kann Meilensteine sehen Allgemeine Rechte > Github Regelt ob diese Gruppe die Meilensteine-Übersicht sehen darf Kann Github Issue erstellen Moderative Rechte > Forum > Themen Regelt ob diese Gruppe aus einem Thema heraus Issues erstellen darf Kann Github Repositorys verwalten Administrative Rechte > Inhalt Regelt ob diese Gruppe die Github-Repositorys im ACP verwalten darf

Benachrichtigungseinstellungen

In den Benachrichtigungseinstellungen werden 3 neue Einstellungen hinzugefügt:

Einstellung Beschreibung Issue wird eröffnet der Themenersteller erhält eine Benachrichtigung wenn ein Issue durch sein Thema erstellt wurde Issue wird wiedereröffnet der Themenersteller erhält eine Benachrichtigung wenn ein verknüpftes Issue wiedereröffnet wird Issue wird geschlossen der Themenersteller erhält eine Benachrichtigung wenn ein verknüpftes Issue geschlossen wird

Voraussetzungen

WoltLab Suite Core 5.3 oder höher WoltLab Suite Forum 5.3 oder höher Github-Konto

Konfiguration

Github-Token

Gehe in Github zu deinen Personal access token Klicke auf den Button Generate new token Gib bei Note eine Beschreibung für deinen Token an. Aktiviere die Checkbox für repo. Klicke auf Generate token. Kopiere dir den generierten Token in die Zwischenablage. Melde dich im ACP an. Gehe zu ACP > Konfiguration > Allgemein > Github und gib den kopierten Token in dem Feld Github Token an. Klicke auf Absenden.

[Blockierte Grafik: https://www.woltlab.com/attachment/161011-acp-token-setting-png/?thumbnail=1]

Verbindung zwischen Benutzer und Github-Konto

Melde dich im ACP an.Gehe zu ACP > Benutzer > Benutzer.Wähle den Benutzer aus.Gib ganz unten bei Github-Benutzername den Namen des Github-Kontos an.Klicke auf Absenden.

Repositorys anlegen

Geh auf Github in dein Repository. Kopiere dir die URL des Repositorys in deine Zwischenablage. Melde dich im ACP an. Gehe zu ACP > Inhalt > Github Repositorys > Github Repository hinzufügen. Gib die kopierte Repository-URL an. Klicke auf Absenden.

[Blockierte Grafik: https://www.woltlab.com/attachment/161009-acp-repository-add-png/?thumbnail=1][Blockierte Grafik: https://www.woltlab.com/attachment/161010-acp-repository-list-png/?thumbnail=1]

Repositorys Foren zuordnen

Melde dich im ACP an. Gehe zu ACP > Apps > Foren. Wähle ein Forum aus und bearbeite dieses. Selektiere ein oder mehrere Repositorys unter Github-Repositorys. Klicke auf Absenden.