This documentation assumes that :
- you host your own dice.io server on an https domain.
- you are logged in to Miro
To get started you need to :
- Create Dev team for Sandbox (Allow to create application)
- Create an application and set it up (web-plugin url and scopes)
Note : you can skip this step if already have Dev Team.
Just follow instructions here. (click on the "Create a Developer team in Miro" link)
In Miro account profile settings, click on "Your apps" tab and click on "Create a new app" button (after checking box).
In "Create new app" modal, enter App Name then click on "Create app" button.
In App URL section enter the dice.io server web plugin url : it is server root url with /miro/ path, and click on "save" button.
(for example https://example.com/miro/)
In Permissions section select boards:read and identity:read scopes.
Finally, click on "Install app and get OAuth Token" button and choose the team where to install the app.
Note: this web plugin does not access to boards, it only get :
- the id of current logged in user and the list of online users to setup the dice roller nickname
- the board id to setup the dice roller channel name (shared by all users connected to the board)
When installed, the app is available by clicking the "more tools" button on the left side bar.
Just click on app button to open sidebar and type a dice formula.
Dice SVG icon originally made by Smashicons from www.flaticon.com.