Quick Start

For those who doesn't have time to go through the docs, fasten your seat belt and let's go !

First you need to add Troglio as a custom power-up.

For this, you need to go to your power-up's admin interface to add a new Power-Up. If you didn't created a team yet, you can create one now (Power-Ups need a team). Once you selected your team, just click on "Create a new Power-Up", fill the form like this:

Power-Up name: Troglio

Author name: troglio

Email: team@troglio.com

Overview: Turn Trello into a CMS

Description: # Power your apps and websites from Trello

Category 1: Marketing & Social Media

Category 2: Developers Tools

Power-Up capabilities: authorization-status, board-buttons, callback, card-buttons, show-authorization, show-settings

Power-Up icon URL: https://powerup.troglio.com/troglio-logo.png

iFrame connector URL: https://powerup.troglio.com/index.html

Link to your privacy policy: https://troglio.com/privacy

Support team email: support@troglio.com

Once you have added the Power-Up, you are good to go !! Just go to any board in the selected team and add your custom Power-Up named Troglio:

Enable the Troglio power-up in a Trello board Enable Troglio power-up

Point Troglio to your back-end: github, gitlab, bitbucket or a custom endpoint Setup destination

Write content using markdown and/or HTML right into cards descriptions write using markdown

Add structured data using TOML add structured data using TOML

Publish !

Note: by default, cards are set to publish = false, so to publish a card, one needs to set its custom property to publish = true before clicking the Publish ! button.

Do not forget to set cards' property to publish = true before submitting data publish

Advanced: you can set properties for other cards from a special card named __config (2 underscores) in a special list named __root (2 underscores)

Control cards properties from a special card root list

Example of controlling all cards and cards in given lists:

[ cards ]
  type = page
  published = true
  permalink = /:list/:title

[ list.projects ]
  type = project

[ list.blog ]
  type = post

+++

What's going on here ?!?!

[ cards ] define properties for all cards in the board. In the above example, we just set all cards with a type of page, published by default and using an URL in the form of /list-name/post-title-here.

[ list.name ] (where name is the name of an existing Trello list) define properties for all cards in a given list. In our example above, we defined type of project and post for all cards in lists named projects and blog respectively.

Another thing to note is that the __config card is where one should centralize global/common site data like logo, header, menus etc...

Complete example with central shared information:

[ cards ]
  type = page
  published = true
  permalink = /:list/:title

[ list.projects ]
  type = project

[ list.blog ]
  type = post

[[ menu.items ]]
text = Home
link = /

[[ menu.items ]]
text = About
link = /about

[[ menu.items ]]
text = Blog
link = /blog

[ social ]
accounts = [
  {"name" : "Twitter", "link" : "https://twittter.com/my-account"}, 
  {"name" : "Facebook", "link" : "https://facebook.com/my-account"}, 
  {"name" : "Instagram", "link" : "https://instagram.com/my-account"}
]

+++

Developers will receive this card data separated from pages and thus can easily re-use information across the whole site. In our above complete example, menu.items is an array of objects representing items in a menu, and social.accounts is also an array of objects representing social accounts links.

Read the docs for more in-depth insights but we highly recommend you just proceed to try Troglio and publish data to your own back-end and just see what's going on: everything is isolated so there is nothing to break ! Try, Fail, Succeed !!

Enjoy :)