¶ Video Guide
Sync your Discord roles with SonoranCMS permissions!
https://www.youtube.com/watch?v=LBMtUnddBZY
¶ Getting Started
By default, only Administrators of the Discord guild can access the commands below. These can be changed in the Settings menu of the server.
¶ 1. Discord SSO Linking
Users must link their Discord to their Sonoran account. This will also automatically add their Discord API ID.
Enable Discord Sync
- In the Administration Panel, under Advanced navigate to
Integrations>Discord - Click
Refresh Datato sync your CMS Community with your Discord.
Link your Discord Account
Once enabled in the CMS, users who do not yet have their Discord account linked with their Sonoran account will see the following banner:
¶ 2. Role Mapping
The command /rolemap can now be used.
Select a department, the rank you wish to modify, and the role you wish to apply to the rank.
There will be left and right arrows to page if you have more than 25 roles.
In this example, having Staff Role in Discord will get the rank Civilian Director in the CMS:
At any time, you can change the dropdowns to select another Department or Rank.
There is ample room for specific customization with role mapping. You can map multiple roles to the same rank and multiple ranks to one role should you so desire.
Keep in mind that sync is bi-directional, so if multiple ranks are mapped to one role (or vice versa) then granting a member one rank will grant them the associated role, which will subsequently grant them the other ranks mapped to the same role.
If you wish to remove a mapping, you can select the Role whose mapping you would like to remove and click the red Clear Mapping button.
¶ Role Syncing
Unlike the CAD sync mode, users will not use the
/linkmecommand - this is handled within the Sonoran Account SSO.
After setting up the above, the command /sync will set up everyone's permissions.
Setting the flag community to Yes will sync your entire community including any linked guilds. Setting it to no or running /sync by itself will only sync the server you run it in.
After the initial sync, changes in role mappings will generally sync themselves automatically.
¶ Features
All the below features can be changed through the /settings menu described here.
- Sonoran Bot can now ping users on Discord when their form or application statuses are updated in CMS.
- Sonoran Bot syncs calendar events created in your CMS by automatically creating an event in your discord server.
- If enabled, Sonoran Bot syncs the names of your CMS users with their Discord account. Their Discord accounts are automatically given nicknames accordingly.