1. Install the add-on through the XenForo admin panel, as normal.
  2. Navigate to your XenForo admin panel -> Setup -> Connected providers -> Discord. Leave this page open as we will need to fill out the values.
  3. You will need to create a new Discord application by going here and then clicking "New Application".

    Screenshot 2020-08-23 at 16.05.07.png
    1. Set the "Name" to whatever you want your bot to be called and continue. You may optionally set a description and icon for your bot. Leave this page open as you will need to grab the values from here in later steps.

      Screenshot 2020-08-23 at 15.42.21.png


    2. Copy the "Client ID" and "Client Secret" values and paste them in to the according fields for the Discord connected account provider in your admin panel (from step 2, above).

      Screenshot 2020-08-23 at 15.48.02.png


    3. Using the sidebar on the left, navigate to the OAuth2 section for your Discord application and click "Add Redirect". Fill in a URL in the form of your board URL followed by connected_account.php. So for example: https://mysite.com/connected_account.php

      Screenshot 2020-08-23 at 15.51.27.png


    4. Using the sidebar on the left, navigate to the Bot section, click "Add Bot" and then accept the warning. Ensure 'Public Bot' and 'Require OAuth2 Code Grant' are both unchecked.

      Screenshot 2020-08-23 at 15.53.30.png


      Screenshot 2020-08-23 at 15.55.17.png


    5. Copy the "Token" displayed under the username for the bot and paste it in to the corresponding field in the Discord connected account provider in your admin panel.

      Screenshot 2020-08-23 at 15.56.55.png
  4. You'll also need your Discord Server ID which can be obtained by following the steps listed here.
    1. Once you've obtained this, paste it in to the Guild ID field of the Discord connected account provider in your admin panel and finally, save the connected account provider.
  5. Navigate to your XenForo admin panel -> Tools -> Test Discord integration. Run the test and initially, it will be red and failing.
    1. Locate the "Invite bot to server" button, click it and follow the prompts to automatically add the bot to your server with appropriate permissions.
    2. Click "Open WebSocket" to ensure messages can be sent by the bot.
  6. Re-run the test and you should be all good to go.