kerry1207/trellotools

Trello Tools is an Add-In for Outlook application for adding cards into your Trello boards in one click.

TrelloTools (Outlook Add-In) 👋

Trello Tools is an Add-In for Outlook application for adding cards into your boards in one click. In detail, this tool permits you to:

• Connecting your Trello account;
• Adding card into different views define in a specific board;
• Adding some details to a specific card like: Title, description and attachments;
• Attaching email you're viewing to a card.
  
  

Demo

Setup and Installation

First all, click on the latest release present into "Releases" section inside repository page. Then, download only zipped folder called "TrelloTools_Setup.zip" and extract it wherever path you want.
Open your Outlook application, and follow these steps:

• Click "File" tab and then on "Options" label (at the bottom of that page);
• Then, click on "Add-ins" label;
• Into "Manage" section, you must choose from dropdown the value: "COM Add-ins" (it should be set by default) and then you must click on "Go..." button;
• Into form that appears at video, click on "Add" button and select the EXE called "setup" inside "TrelloTools_Setup" folder and click on "OK" button;
• It should be appeared, on screen, the window for installation of the Add-In, you must only click first on "Install", then on "Close" button, in the end on "Ok" button to close Add-In window;
• In the end, restart your Outlook and enjoy with this Add-In.

It's important to say: the Add-In you can use it only when expand a single email.

For use the plugin, you must know your Trello API credentials. If you don't have them, you can read and following the first two paragraphs of this article to generate: API Introduction.

NOTE: The Add-In doesn't memorize externally your API credentials. These data will store into user storage and retrieve when application must do data about Boards, Views, and others similar operations. At the same time, it's possible that Trello can register the whole activity that you'll do. If you need to know more view their Privacy Policy at this link: Trello Privacy Policy.

Architecture

The architecture of this project is based on four layers:

• View Layer (Trello Tools) = This layer provides to build and manage layout of Add-In and form about the different functionalities;
• Business Layer (TrelloToolsLogic) = This layer incorporate whole logic about Add-In. It's a main project for handle the various functionalities and for manager the error that a user can encounter while use this tool;
• Data Access Layer (TrelloToolsAccess) = This layer provides to querying the Trello API using user API credentials to retrieve data from his account. It's important to say that the API credentials are stored only into storage user memory. An example of data are: Boards and Views names;
• Model Layer (TrelloToolsBean) = This layer provide to define a bean classes useful for handle the data between Data Access Layer and Business Layer into application.

Please, follow this architecture for implementing new features/bug fixing.

Author

👤 @Kerry1207

🤝 Contributing

Contributions, issues and feature requests are welcome!
For contributing to the project, please follow this steps:

1. Fork the repository from "develop" branch;
2. Create your branch using this standard: feature/[NewFeatureName];
3. Commit and push your changes;
4. Open Pull Request.

NOTE: When you have developed new functionalities or make bug fixing operation, please write unit test inside "TrelloTools_Test" project and then send Pull Request.
If PRs don't include tests won't be accepted.

📝 License

This project is MIT licensed.