Staff++
<= 1.16.56
<= 1.16.56
  • Staff++
  • General information
    • Quick start
    • Reload Configuration
    • Multi Server Setup
    • General Configuration
  • Permissions & Commands
    • Commands
    • Permissions
  • Features
    • Alerts
      • X-Ray
    • Alt account detection
    • Authentication
    • Banning
      • Fixed Ban Reason
      • Templates
    • Broadcasting
    • Chat module
    • Chest/Inventory Interaction
    • Examine players
    • Infractions
    • Investigate
    • Protection
    • Reporting
      • Finding reports
      • Custom report types
    • Staff Chat
    • Staff Mode
      • Luckperms integration
      • Custom GUI
      • Staff Modules
      • Custom Staff Modules
    • Teleporting
    • Warnings
      • Quick start
      • Severity levels
      • Thresholds
      • Actions (punishments)
      • Appealing
      • Warning workflow
  • Integrations
    • Discord Integration
      • Staff Chat
      • Template Packs
      • Customize Discord Templates
    • Trello Integration
  • Migration guides
    • Staff+ migration guide
    • Migrating to >=V1.16.43
    • Upgrading Discord Integration to 1.16.51
  • Developers
    • API guide
Powered by GitBook
On this page
  • Configuration
  • Obtaining the API key
  • Obtaining the User Token
  • Obtaining the board ID
  • The lists
  • Example:

Was this helpful?

  1. Integrations

Trello Integration

PreviousCustomize Discord TemplatesNextStaff+ migration guide

Last updated 4 years ago

Was this helpful?

Staff++supports Trello integration. Whenever reports are created, or they change status it can by synchronized with Trello. However this a one way synchronization, if you change the cards created by Staff++ in Trello it will not be updated in game.

Install the Staff++ Trello Integration plugin:

Configuration

StaffPlusPlusTrello:
    reports:
        # Your api key
        apiKey: ""
        # Your user token
        userToken: ""
        # The id of your board, can be found in the url
        boardId: ""

        # The list names in which the cards should be placed when moved to this status
        openListName: "open"
        rejectedListName: "rejected"
        acceptedListName: "accepted"
        resolvedListName: "resolved"

Obtaining the API key

I recommend creating a new Trello user purely for the purpose of the Staff++ integration, but you can also use your existing user.

Log in into Trello with the user you want to use for the integration. The user needs access to the board where the reports should be added on.

Add your API key to the config file.

Obtaining the User Token

Make sure you first obtain the API key as explained in the previous section Visit the following url: (Change {your-api-key} with the API key)

This page gives you the user token. Keep this token a secret as anyone with this token can access your board.

Add your User Token to the config file.

Obtaining the board ID

Add your Board ID to the config file.

The lists

Lastly map the Staff++ statuses to the correct Lists on your Trello board. The match is done based on the List name and it must be an exact match. If the plugin can't find any of the configured lists on the board, an error message will be thrown at startup of the plugin

Example:

Go to: Your api Key is displayed here.

The board ID can be found inside the URL when navigating to your board For example: The board ID in this case is WkCJeuKv

https://www.spigotmc.org/resources/staff-trello-integration.84552/
https://trello.com/app-key
https://trello.com/1/authorize?expiration=never&name=StaffPlusPlusToken&scope=read,write&response_type=token&key={your-api-key}
https://trello.com/b/WkCJeuKv/staffplusplus