96 lines
4.0 KiB
Plaintext
96 lines
4.0 KiB
Plaintext
block head
|
|
title Taiga Your agile, free, and open source project management tool
|
|
|
|
block content
|
|
div.wrapper.roles(tg-github-webhooks, ng-controller="GithubController as ctrl",
|
|
ng-init="section='admin'")
|
|
sidebar.menu-secondary.sidebar(tg-admin-navigation="third-parties")
|
|
include views/modules/admin-menu
|
|
sidebar.menu-tertiary.sidebar(tg-admin-navigation="third-parties-github")
|
|
include views/modules/admin-submenu-third-parties
|
|
|
|
section.main.admin-common.admin-third-parties
|
|
include views/components/mainTitle
|
|
|
|
form
|
|
fieldset
|
|
label(for="secret-key") Secret key
|
|
input(type="text", name="secret-key", ng-model="github.secret", placeholder="Secret key", id="secret-key")
|
|
|
|
fieldset
|
|
.select-input-text(tg-select-input-text)
|
|
div
|
|
label(for="payload-url") Payload URL
|
|
.field-with-option
|
|
input(type="text", ng-model="github.webhooks_url", name="payload-url", readonly="readonly", placeholder="Payload URL", id="payload-url")
|
|
.option-wrapper.select-input-content
|
|
.icon.icon-copy
|
|
.help-copy Copy to clipboard: Ctrl+C
|
|
|
|
button(type="submit", class="hidden")
|
|
a.button.button-green.submit-button(href="", title="Save") Save
|
|
|
|
|
|
.help
|
|
h2 How to use it
|
|
|
|
h3 Configure Taiga
|
|
ol
|
|
li Fill
|
|
span Secret key
|
|
| or use the auto generated one
|
|
|
|
li Copy the
|
|
span Payload URL field.
|
|
|
|
h3 Configure Github
|
|
ol
|
|
li Go to your github repository.
|
|
li Click on
|
|
span Settings
|
|
| >
|
|
span Webhooks & Services
|
|
| >
|
|
span Add webhook
|
|
|
|
li On that screen set the payload url with the payload url of this screen.
|
|
li Secret must be filled with the same content as the secret field of this screen.
|
|
li Content type must be
|
|
span application/json.
|
|
li Taiga currently listen for three different kind of events:
|
|
ol
|
|
li Push events: changing element status via commit message
|
|
li Issues: issues created in github appear automatically in Taiga
|
|
li Issue comment: issue comments created in github appear automatically in Taiga
|
|
|
|
p Just check "send me everything" or just the events you want Taiga to listen for.
|
|
|
|
.img
|
|
.alt-image Github Webhooke page
|
|
img(src="/images/github-help.png", alt="webhook")
|
|
|
|
h2 Changing elements status via commit message
|
|
|
|
p
|
|
| The status of any issue, task or user story can be changed via commit message.
|
|
| Just add to your commit message something like:
|
|
|
|
code
|
|
| TG-REF #STATUS
|
|
|
|
ul.code-info
|
|
li
|
|
span REF:
|
|
| US/Issue/Task reference of the element you want to modify
|
|
li
|
|
span STATUS:
|
|
| New status slug to set, you can find all of them in:
|
|
a(href="", tg-nav="project-admin-project-values-us-status:project=project.slug") US STATUSES.
|
|
|
|
h3 An example please!
|
|
|
|
code
|
|
| TG-123 #closed
|
|
|
|
p In this example, 123 is an issue reference and with this command, the issue will change its status to closed.
|