This documentation provides you with an introduction to the ExpressTechSoftWares Discord Add-ons. It is intended for website owners who wish to offer their users the ability to connect their accounts to the Discord server. The ExpressTechSoftWares Add-ons make it possible to link Discord roles and:
- Memberships: if you offer a subscription system ( PMPRO, MemberPress, ...)
- Courses: if you have installed an LMS ( LearnDash, LearnPress, ...)
The first step requires creating a Discord Application and collecting the data necessary to make the Add-ons work correctly.
Click on New Application :
Give a relevant name to your application and click on Create .
Now you will create a Discord Bot, which will be responsible for managing Discord roles for users: assign roles, delete roles...
Click on the Bot menu:
Copy the Bot Token and save it, we will need it later.
Go to : OAuth2 menu :
Copy the Client ID and the Client Secret and save them as you did for the Bot Token.
To have the server ID, First You will activate the developer mode.
Click on the “User Settings” gear in the bottom left of the screen:
Advanced :
Enable Developer Mode
Now click on the server icon in the left-hand side of discord.com screen and copy the server ID :
Save the Server ID as you did for the Bot Token , Client ID and Client Secret.
All Discord add-ons have the same user interface.
After installing and activating an Add-On, you will have a submenu: Discord Settings.
in this example we will take LearnDash LMS as an example :
Now you fill in the form with the data saved before: Client ID, Secret ID, Bot Token, Server ID.
Also, you need to copy/paste the URLs: :
- Redirect URL.
- Admin Redirect URL Connect to bot
Go to : OAuth2
Add the URls and click 'Save Changes'.
Return to the AddOn dashboard and Click ‘Save Settings’.
After clicking on 'Save Settings', and if you have followed the steps correctly, you will have a new button that appears that you are invited to connect the Bot :
You also noticed the appearance of a new sentence:
Make sure the Bot ExpressTechSoftWares App BOT have the high priority than the roles it has to manage. Open DiscordServer.
Of course, the sentence contains the name of your Bot you named.
Now click on the red button 'Connect your Bot'. you will be redirected to Discord authentication :
Click Authorize.
You will be redirected to the Admin page.
Congratulations ! you have successfully connected the bot:
Also, you will be notified of the arrival of the Bot :
For the Bot to handle roles, it must have high priority.
Go to Server Settings
Drag & Drop Bot on top of all Roles and save changes:
To verify that the add-on works as expected, go to: Role Mappings.
you should see the discord roles:
