https://github.com/lode/trello-epic-relations
Quickly connect Trello cards in an easy way. EPIC!
https://github.com/lode/trello-epic-relations
Last synced: 5 months ago
JSON representation
Quickly connect Trello cards in an easy way. EPIC!
- Host: GitHub
- URL: https://github.com/lode/trello-epic-relations
- Owner: lode
- License: mit
- Created: 2021-06-18T20:30:23.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-08-15T21:15:03.000Z (almost 5 years ago)
- Last Synced: 2025-05-30T10:13:37.216Z (about 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 223 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Trello EPIC relations
This power-up for Trello allows to quickly connect project cards (epics) to task cards.
It works with native checklists and card attachments, so your data is yours even when you don't use the plugin.
Currently, you can't manually add/remove tasks in a checklist of an epic card or remove an epic card attachment of a task card.
Instead, use the card buttons to manage relations.
## Install
The power-up isn't published/listed yet. You'll need to install it as a custom power-up until then.
- Go to https://trello.com/power-ups/admin and click 'Create new Power-Up' the top right.
- Fill:
- Name: `EPIC relations`
- Workspace: the workspace you want to use the power-up in (you'll need to be an admin of that workspace).
- Iframe-connector-URL: `https://www.lodeclaassen.nl/trello-epic-relations/power-up/`
- If this is your first time using a custom power-up, you'll need to agree to a 'Joint Developer Agreement' first.
- On the baic information tab, fill:
- Symbol: `https://www.lodeclaassen.nl/trello-epic-relations/power-up/favicon.png`
- On the permissions tab, enable:
- `board-buttons` (optional)
- `card-badges`
- `card-buttons`
- `card-detail-badges`
- `authorization-status`
- `show-authorization`
- Go to the board where you want to use it and open the power-ups marketplace overlay.
- Click on the 'custom' section on the left, and add 'EPIC relations'.
## First time use
Every person using the power-up will need to authorize against the Trello API.
From the power-up in the board menu, choose 'Authorize' and complete the steps.
Currently the power-up needs write access from your account.
This is needed as it stores the relations in checklists and card attachments, and that needs write access from your account.
When not authorized, you can still see the relations and navigate between them, but you can't change them.
## Usage
To **add a task to an epic**, open an epic card and click the 'task' card button on the right.
To **add set the epic of a task**, open a task card and click the 'epic' card button on the right.
To **remove a relation**, open _the task card_, click the 'epic' card button on the right, and choose the last option to remove the epic.
Note, every add/remove action is automatically synced to the related card.
This works across boards within the same organization as well. Even if those boards don't have the plugin installed.
Be aware that **you can _not_ (yet) manually change the checklist or card attachment**. Always use the card buttons to do so.
You _can_ sort card attachments or checklists, rename checklists, or update checkitems (marking (in)complete, attaching people and due dates).
## Contributing
If you use the power-up, please ask questions or share what can be improved by [creating an issue](https://github.com/lode/trello-epic-relations/issues).
For bugs [issues](https://github.com/lode/trello-epic-relations/issues) or [Pull Requests](https://github.com/lode/trello-epic-relations/pulls) are welcome!
To develop improvements there is a [Glitch](https://glitch.com/edit/#!/trello-epic-relations) which you can remix.
## Licence
[MIT](/LICENSE)