Github-Integration

Zitat von Woltlab Plugin News

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

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

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

Verbindung zwischen Benutzer und Github-Konto

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

Repositorys anlegen

1. Geh auf Github in dein Repository.
2. Kopiere dir die URL des Repositorys in deine Zwischenablage.
3. Melde dich im ACP an.
4. Gehe zu ACP > Inhalt > Github Repositorys > Github Repository hinzufügen.
5. Gib die kopierte Repository-URL an.
6. 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

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

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

Firewall-Konfiguration

Sollte vor deinem Webserver eine Firewall laufen, ist es notwendig den IP-Range 140.82.112.0/20 zu erlauben. Der Webhook von Github verwendet diesen IP-Range.

Wie geht es nach dem Kauf weiter?

Erstellen Sie ein Benutzerkonto auf hanashi.dev. Gehen Sie in Ihren Einstellungen auf Käufe aktivieren. Und geben Sie Ihr API-Informationen von der Seite API-Zugriff ein. Klicken Sie nun auf Absenden. Damit haben Sie sich für den Zugriff im Supportforum freigeschaltet.

Alles anzeigen

Quelle: https://pluginstore.woltlab.com/file/6857-github-integration/