Discord Login Plugin by Blesta.Club - Installation Guide

Welcome to the Discord Login Plugin installation guide. This plugin allows users to log into Blesta using their Discord credentials, providing secure and easy single sign-on (SSO) functionality.

Prerequisites

1. A Discord Developer Application with OAuth 2.0 credentials (Client ID and Client Secret).
2. A valid Blesta installation.

Installation Guide

Step 1: Create a Discord Application

1. Go to the Discord Developer Portal and create a new application.
2. Under the OAuth2 section, generate your Client ID and Client Secret.
3. Set the Redirect URI to: https://yourdomain.com/plugins/discord_login/callback/ Replace yourdomain.com with your actual Blesta installation domain.

Step 2: Download the Plugin

1. Download the Discord Login Plugin from Blesta Club.

Step 3: Upload the Plugin to Blesta

1. Upload the plugin to your Blesta directory:

   /var/www/html/blesta/plugins/discord_login/

Step 4: Install the Plugin

1. Log in to your Blesta admin account.
2. Navigate to Settings > Plugins.
3. Locate Discord Login Plugin and click Install.

Step 5: Configure the Plugin

1. After installation, navigate to Settings > Plugins > Discord Login.
2. Enter your Discord Client ID and Client Secret from the Discord Developer Portal.
3. Set the Redirect URI in the Discord Developer Portal, if not already done.
4. Click Save Settings.

The Discord Login Plugin is now installed and ready to be used.

Contact Us

For any issues during installation, visit Blesta Club.

Discord Login Plugin by Blesta.Club - Update Guide

Keeping the Discord Login Plugin up-to-date ensures compatibility with Blesta and Discord's OAuth 2.0 system. Follow these steps to update the plugin.

Steps for Updating

Step 1: Backup Your Installation

Before updating, always backup your Blesta installation to avoid any data loss.

Step 2: Download the Latest Version

1. Download the latest version of the Discord Login Plugin from Blesta Club.

Step 3: Upload the New Files

1. Upload the updated plugin files to your Blesta installation directory, replacing the existing ones:

   /path_to_blesta/plugins/discord_login/

   Step 4: Run the Update in Blesta

2. Log in to your Blesta admin account.

3. Navigate to Settings > Plugins.

4. Locate the Discord Login Plugin and click Update.

Step 5: Test the Update

After updating, ensure that users can still log in using their Discord accounts.

Contact Us

If you encounter any issues during the update process, please contact Blesta Club.

Discord Login Plugin by Blesta.Club - Usage Guide

This guide explains how to use the Discord Login Plugin to enable clients to log into their Blesta accounts using their Discord credentials.

How It Works

The Discord Login Plugin uses OAuth 2.0 to authenticate users with their Discord accounts. Once authenticated, the user can log in to Blesta without needing a separate Blesta username and password.

Key Features

• Login with Discord: Clients can log in to Blesta by clicking a Login with Discord button.
• OAuth 2.0 Security: Ensures secure authentication between Discord and Blesta.

Client View

Logging In with Discord

1. On the Blesta login page, clients will see a Login with Discord button.
2. Clicking the button redirects them to the Discord login page, where they enter their Discord credentials.
3. Upon successful authentication, they are redirected back to Blesta and automatically logged in.

Managing Linked Discord Accounts

• Clients can manage their linked Discord account from the Account Settings page in Blesta.
• If a client no longer wishes to use Discord for login, they can unlink their Discord account from this page.

Admin View

Security Considerations

• The plugin uses OAuth 2.0, a secure and widely adopted protocol for authorization.
• User data is securely exchanged between Discord and Blesta, ensuring that client credentials are protected.

Contact Us

For further assistance, please visit Blesta Club.