Discord Integration

Discord Integration 2.2.4

Release date
Last update
Price
$35.00
Initial support
12 months
Renewal price
$15.00

Feature summary

  • Sync Discord roles with XenForo user groups.
  • View and manage your Discord server from the Admin Control Panel.
  • Send customised alerts to Discord channels.
  • Flexible API and Widget Framework support included.

Product details

Discord Integration allows you to establish a connection and manage your Discord server from the comfort of the XenForo Admin Control Panel.
Screenshot_2018-07-02_at_20.30.27.png
Features:
  • Allows for XenForo user groups to be synced with Discord server roles. Essentially this allows you to automate the giving and removing of Discord server roles based on the groups that a XenForo user is part of. Users can associate their Discord identities with their XenForo usernames to establish a sync.
  • Discord nicknames can also be updated to match forum names.
  • New for XenForo 2.x: Allow the bot to show up as online and display a custom status message.
  • Manage your Discord instance from the ACP.
  • Allow your users to register and sign up via Discord.
  • Send alerts to connected users and channels via the ACP.
  • Automatically post links to threads from XenForo forums to defined Discord channels as soon as they're posted. The user who posted the thread, the thread title, a short snippet and a link to the thread are included in the message.
    • This is set on a per-forum basis allowing you to fine-tune what channels should get the notifications.
  • New for XenForo 2.x: Automatically post links to resources from XenForo Resource Manager to defined Discord channels as soon as they're posted. The user who posted the resource, the resource title, a short snippet and a link to the resource are included in the message.
    • This is set on a per-category basis allowing you to fine-tune what channels should get the notifications.
  • Allow staff members with permission to 'promote' links to threads to Discord channels.
  • Allow users to receive watch notifications from forums and threads they specify (in addition to emails and alerts). They will receive these notifications privately from your configured bot. There are plans for future expansion with 1-to-1 communication with the bot.
4b8df950fbc64698add0d473bbc74625.png

Installation:
  1. Extract the contents of the .zip file provided upon successful purchase.
  2. Upload the contents of the 'upload' folder to your root XenForo directory.
  3. Install the add-on through the XenForo Admin Control Panel.
  4. Create a Discord Web API application by going here.
    1. Set your App Name to what you want your bot to be called. You may optionally set a description and icon for your bot.
    2. These steps vary if you're on XenForo 1 or XenForo 2:
      1. XenForo 1: Ensure you have a Redirect URL like so:
        Code:
        https://mysite.com/index.php?_=register/discord
        If you're using friendly URLs you'll need to use something similar to:

        Code:
        https://mysite.com/register/discord
      2. XenForo 2: Ensure you have a Redirect URL set in the form of your board URL followed by connected_account.php. So for example:
    3. Code:
      https://mysite.com/connected_account.php
    4. Click 'Create App' and your application will have now been created. You'll now see a new option that says 'Create a Bot User'. Click this and accept the warning. Ensure 'Public Bot' and 'Require OAuth2 Code Grant' are unchecked.
  5. Once you have created your Discord Web API application, it's time to copy the values for 'Client ID', 'Client Secret' and 'Token' to the Discord connected provider in the XenForo Admin Control Panel -> Setup -> Connected providers.

    If you're on XenForo 1, you'll need to copy this information to the Discord options area under the 'NixFifty: Discord Integration Options' group in the XenForo Admin Control Panel.
  6. You'll also need your Discord Server / Guild ID which can be obtained by following the steps listed here.
  7. Once you've done this, be sure to use the 'Test Discord Integration' located at XenForo Admin Control Panel -> Tools to make sure everything is dandy and you're good to go!
Allowing the bot to appear online:
This is a slightly more advanced feature that you'll need to setup yourselves. Eventually, I hope to expand this part of the add-on but until then, here's the run down:
  1. You'll need to install node on your server. Contact your host or sysadmin if you're unsure of how to do this.
  2. Download the add-on's zip file, navigate to the "bot" folder in the zip root and open config.json.
  3. Set the token to the value you copied from your Discord Web API application when you installed the add-on.
  4. Set the status field to anything you want. It'll read "Playing {status}" on your server.
  5. Run the script by executing the following at the command line. You'll want to run this command in a screen or something similar.
    Code:
    node app.js
Top