https://github.com/26bz/whmcs-to-discord-client-verification

Simple Discord Role Assignment for Verified WHMCS Clients
https://github.com/26bz/whmcs-to-discord-client-verification

whmcs whmcs-addon whmcs-hook

Last synced: about 1 month ago
JSON representation

Simple Discord Role Assignment for Verified WHMCS Clients

• Host: GitHub
• URL: https://github.com/26bz/whmcs-to-discord-client-verification
• Owner: 26bz
• License: mit
• Created: 2024-10-07T12:03:28.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-11-12T17:25:23.000Z (about 1 month ago)
• Last Synced: 2024-11-12T18:29:17.068Z (about 1 month ago)
• Topics: whmcs, whmcs-addon, whmcs-hook
• Language: PHP
• Homepage:
• Size: 17.6 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# WHMCS Discord Client Verification

This integration allows paying customers to obtain a Discord role by visiting `/discord.php` in your WHMCS installation. It features enhanced security measures and error handling for a better user experience.

## Installation

1. **Place Files**:

   - Add `discord.php` to the root directory of your WHMCS installation.

   - Place `discord.tpl` inside your themes folder alongside the other .tpl files

   - Place `config.php` outside the web root or use environment variables to store sensitive credentials securely. Sample `config.php` content:

     ```php

      'YOUR_DISCORD_CLIENT_ID',

         'secret_id' => 'YOUR_DISCORD_SECRET_ID',

         'scopes' => 'identify email', // Adjust scopes as needed

         'domainurl' => 'https://billing.yourdomain.com/', // Update with your WHMCS domain URL

         'redirect_uri' => 'https://billing.yourdomain.com/discord.php',

         'guild_id' => 'YOUR_DISCORD_GUILD_ID',

         'role_id' => 'YOUR_DISCORD_ROLE_ID',

         'bot_token' => 'YOUR_DISCORD_BOT_TOKEN'

     ];

     ```

     Store `config.php` securely outside the web root or use environment variables to prevent unauthorized access.

2. **Update Discord.php**:

   - In `discord.php`, update the line to load sensitive information from `config.php`:

     ```php

     // Load sensitive information from config file

     $config = require __DIR__ . '/config.php';

     ```

3. **Create Custom Field**:

   - [Create a custom client field named `discord` in WHMCS](https://docs.whmcs.com/Custom_Client_Fields) to store the customer's Discord ID.

4. **Usage**:

   - Paying customers can visit `/discord.php` to link their Discord account.

   - Upon verification, they will receive a Discord role based on their active product status in WHMCS.

## Disclaimer

This project doesn't include support. However, if you discover an issue, please open a github issue, and we'll work to provide a fix. Feel free to fork and submit a pull request to contribute to future updates if you desire. 

If you find this project helpful, consider giving it a star! 🌟