https://github.com/26bz/whmcs-to-discord-client-verification
This integration allows WHMCS clients to automatically receive Discord roles based on their account status. Clients with active products receive one role, while verified clients without active products receive a different role. The system automatically updates roles when client status changes.
https://github.com/26bz/whmcs-to-discord-client-verification
discord whmcs whmcs-addon
Last synced: 5 months ago
JSON representation
This integration allows WHMCS clients to automatically receive Discord roles based on their account status. Clients with active products receive one role, while verified clients without active products receive a different role. The system automatically updates roles when client status changes.
- Host: GitHub
- URL: https://github.com/26bz/whmcs-to-discord-client-verification
- Owner: 26bz
- License: gpl-3.0
- Created: 2025-05-12T04:55:32.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-12T04:56:28.000Z (5 months ago)
- Last Synced: 2025-05-12T05:34:00.979Z (5 months ago)
- Language: PHP
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
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! 🌟