Sonoran CMS Integration
Link Sonoran Bot to Sonoran CMS for role syncing and other handy features!
Video Guide
Sync your Discord roles with SonoranCMS permissions!
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.
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>DiscordClick
Refresh Datato sync your CMS Community with your Discord.
Link your Discord Account
Once the bot has been added and linked to CMS, any users who do not yet have their Discord account linked with their Sonoran account will see the following banner:
They will be required to link their discord in order for the bot's features to work on them. This banner will show until they link their Discord to their Sonoran account.
Role Mapping in CMS
You can also configure rolemapping from within CMS as well.
This window can be accessed from CMS in Admin Panel > Integrations > Discord > Role Mapping
Here you can view all mapped ranks and what Discord roles they're mapped to, as well as add or delete mappings.
To add a new mapping, first start by selecting a rank:
Next, select the Discord role(s) you wish to map this rank to:
Hint: You can select multiple roles to map to one rank. However, you can't select multiple ranks at once. Thus, if you want to map multiple ranks to one role, you will have to create a separate entry for every rank you wish to map.
When you're ready to create the mapping, click the Add button on the right-hand side.
When you've clicked Add, it will show in the list alongside all previously existing mappings.
At any time, you can add additional Discord roles to an existing Rank mapping by clicking the plus button.
This will open up a dropdown where you can select additional Discord roles to map.
When you've selected all desired roles, click outside and it will automatically save your new mapping.
Role Syncing
Unlike the CAD sync mode, users will not use the /linkme command - 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.
Import Discord Roles as CMS Ranks
For any Discord guild linked to your CMS, you can choose to import specific roles as ranks into any CMS department.
It will automatically create ranks matching the name and color of your roles, though in depth permission customization will still have to be done as normal.
You can read more on importing Discord roles here.
CMS Calendar Integration
If you have linked SonoranBot to your community, creating an event in CMS will automatically create an event within your community's Discord channel making it easy to coordinate community events across multiple platforms!
By clicking the Interested button, you will be automatically RSVP'd in CMS.
Legacy Role Mapping
You can also set up role mapping directly from Discord, rather than CMS. We generally recommend doing this through CMS as the UI is easier to work with, however we still offer the "legacy" role mapping through Discord as an option.
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.
Last updated
