GitHub Action
Support Requests
Support Requests is a GitHub Action that comments on and closes issues labeled as support requests.
The legacy version of this project can be found here.
The continued development of Support Requests is made possible thanks to the support of awesome backers. If you'd like to join them, please consider contributing with Patreon, PayPal or Bitcoin.
Support Requests can perform the following actions when an issue is labeled, unlabeled or reopened:
- The support label is added: leave a comment, close and lock the issue
- The support label is removed: reopen and unlock the issue
- The issue is reopened: remove the support label, unlock the issue
Create a workflow file named support.yml
in the .github/workflows
directory,
use one of the example workflows to get started.
The action can be configured using input parameters.
All parameters are optional, except github-token
.
github-token
- GitHub access token, value must be
${{ github.token }}
- Required
- GitHub access token, value must be
support-label
- Label used to mark issues as support requests
- Optional, defaults to
support
issue-comment
- Comment to post on issues marked as support requests,
{issue-author}
is an optional placeholder - Optional, defaults to
:wave: @{issue-author}, we use the issue tracker exclusively for bug reports and feature requests. However, this issue appears to be a support request. Please use our support channels to get help with the project.
- Comment to post on issues marked as support requests,
close-issue
- Close issues marked as support requests,
value must be either
true
orfalse
- Optional, defaults to
true
- Close issues marked as support requests,
value must be either
lock-issue
- Lock issues marked as support requests,
value must be either
true
orfalse
- Optional, defaults to
false
- Lock issues marked as support requests,
value must be either
issue-lock-reason
- Reason for locking issues, value must be one
of
resolved
,off-topic
,too heated
orspam
- Optional, defaults to
off-topic
- Reason for locking issues, value must be one
of
The following workflow will comment on and close issues marked as support requests.
name: 'Support requests'
on:
issues:
types: [labeled, unlabeled, reopened]
jobs:
support:
runs-on: ubuntu-latest
steps:
- uses: dessant/support-requests@v2
with:
github-token: ${{ github.token }}
This workflow declares all the available input parameters of the action
and their default values. All parameters can be omitted, except github-token
.
name: 'Support requests'
on:
issues:
types: [labeled, unlabeled, reopened]
jobs:
support:
runs-on: ubuntu-latest
steps:
- uses: dessant/support-requests@v2
with:
github-token: ${{ github.token }}
support-label: 'support'
issue-comment: >
:wave: @{issue-author}, we use the issue tracker exclusively
for bug reports and feature requests. However, this issue appears
to be a support request. Please use our support channels
to get help with the project.
close-issue: true
lock-issue: false
issue-lock-reason: 'off-topic'
Copyright (c) 2017-2020 Armin Sebastian
This software is released under the terms of the MIT License. See the LICENSE file for further information.