Releases: HypheX/roblox-trello
v2 (First public preview)
This is purely experimental at this point! We don't recommend using this in your production environment as things can change quickly.
This is the first version of v2
that is going to be released so that you can toy with.
It's still quite incomplete, but you can begin to play with it to get the hang of it.
Recommendations
You can (and should) use this plugin to access the full API documentation from the v2 module (v1 doesn't have this!).
The API is still in design phase. This means that method names can change until v2 is complete - File an issue if you have a suggestion for v2!
Breaking changes from v1
A lot of them.
Need an example? Take a look at this script!
- The
auth
module has been removed; - You can now control more than one user at a time. All you need to do is to create a
TrelloEntity
:
local trello = require(game.ServerScriptService.Trello)
local me = trello.new("API KEY", "API TOKEN")
- Making boards (and in the future, lists, boards and labels) requires you to index the
TrelloClass
module:
local trello = require(game.ServerScriptService.Trello)
local TrelloClass = require(game.ServerScriptService.Trello.TrelloClass)
local me = trello.new("API KEY", "API TOKEN")
local board = TrelloClass.Board.new(me, "Board Name", true) -- The new board will be public
- Fetching a board from Trello will now absolutely require the board id:
local existentBoard = TrelloClass.Board.fromRemote(me, boardId)
- Changing metadata is now done "locally" and then pushed to Trello via the
:Commit()
method:
local board = TrelloClass.Board.new(me, "Board Name", true)
board.Name = "I changed my mind lol"
board.Public = false
-- These changes haven't arrived Trello yet
board:Commit()
-- Now they have!
Fixes to Error Messages
Some error messages were fixed:
Fixed two incorrect references:
-
HTTP 4XX errors are usually the fault of the user (generally bad KEY/TOKEN pairs), and not Trello's fault.
-
For creating a card, the argument 3 is a list (and not a card).
-
Also added some comments to the
auth.lua
module containing instructions on how to fetch the API key and token.
Changes introduced by 1.3.5:
Card:SetDesc(txt)
was brought back, so that you don't need to useCard:SetProperty("desc", txt)
1.3.4 - Dummy check fix
For some reason the authentication string was removed from the dummy check URL. (It didn't break anything else, though). This has since been resolved and it should be working now.
1.3.3 - HTTP 400 Fix
This update fixes an issue where trying to make a card (inside a list) would throw an Error 400.
This bug was caused by a typo - the Trello API wanted an idList
field but @HypheX gave them an idCard
instead.
1.3.2 - Debugging output
The label class was never implemented into the API, and thus, its constructor has been removed.
Helpful debugging information has been added by @ddavness
1.3.0 - New function
Card Class:
-Added new function :GetDesc()
1.2.0 - New function
List Class:
-Added new function :GetCards()
1.1.2 - bug fixes
The source code file will not be the same as the .rbxm file in this release, as it is very important to release asap, and I cannot roll back other changes.
Fixed Trello.new("Card")
1.1.1 - bug fixes
Board and List classes:
-Added checks
Card class:
-Fixed :Comment()
Extras:
-From now on, every update will also include the rbxm file to facilitate installing it.
-From now on, the Main script will contain the version number in the first line.
1.1.0 - New functions and critical security fixes.
Board class:
-Security fixes
-Fixed nil constructors after calling GetBoardByName()
-Added GetListByName() and GetCardByName()
List class:
-Added function GetCardByName()