{"id":30509539,"url":"https://github.com/26bz/whmcs-discord-client-verification","last_synced_at":"2026-01-24T18:31:39.847Z","repository":{"id":305252504,"uuid":"1016499365","full_name":"26bz/WHMCS-Discord-Client-Verification","owner":"26bz","description":"Discord Role Assignment for WHMCS Clients","archived":false,"fork":false,"pushed_at":"2025-10-25T11:10:30.000Z","size":268,"stargazers_count":5,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-21T22:59:55.130Z","etag":null,"topics":["discord","whmcs","whmcs-addon","whmcs-module"],"latest_commit_sha":null,"homepage":"https://26bz.online/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/26bz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"26bzz"}},"created_at":"2025-07-09T05:32:50.000Z","updated_at":"2025-10-25T11:10:33.000Z","dependencies_parsed_at":"2025-07-19T05:46:40.078Z","dependency_job_id":"8a2651fc-41fe-481b-bf59-217b1b226c02","html_url":"https://github.com/26bz/WHMCS-Discord-Client-Verification","commit_stats":null,"previous_names":["26bz/whmcs-to-discord-client-verification","26bz/whmcs-discord-client-verification"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/26bz/WHMCS-Discord-Client-Verification","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/26bz%2FWHMCS-Discord-Client-Verification","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/26bz%2FWHMCS-Discord-Client-Verification/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/26bz%2FWHMCS-Discord-Client-Verification/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/26bz%2FWHMCS-Discord-Client-Verification/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/26bz","download_url":"https://codeload.github.com/26bz/WHMCS-Discord-Client-Verification/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/26bz%2FWHMCS-Discord-Client-Verification/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28734307,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T17:51:25.893Z","status":"ssl_error","status_checked_at":"2026-01-24T17:50:48.377Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discord","whmcs","whmcs-addon","whmcs-module"],"created_at":"2025-08-26T01:31:04.321Z","updated_at":"2026-01-24T18:31:39.828Z","avatar_url":"https://github.com/26bz.png","language":"PHP","funding_links":["https://ko-fi.com/26bzz"],"categories":[],"sub_categories":[],"readme":"# WHMCS Discord Client Verification Addon\n\nA professional WHMCS addon module that integrates with Discord to automatically verify clients and assign roles based on their account status.\n\n## Features\n\n- **OAuth2 Discord Authentication**: Secure Discord verification using OAuth2 flow\n- **Automatic Role Assignment**: Assigns different roles based on active WHMCS products\n- **Real-time Updates**: Hooks into WHMCS events for instant role synchronization\n- **Daily Synchronization**: Cron job ensures roles stay in sync\n- **Environment Variable Support**: Secure credential management\n- **Comprehensive Logging**: Full activity and API call logging for debugging\n\n## Installation\n\n1. **Upload Files**: Copy the entire addon directory to your WHMCS installation:\n\n   ```\n   /path/to/whmcs/modules/addons/discord_verification/\n   ```\n\n2. **Activate Module**:\n\n   - Go to **Setup → Addon Modules** in WHMCS Admin\n   - Find \"Discord Client Verification\" and click **Activate**\n\n3. **Configure Module**:\n   - Click **Configure** next to the activated module\n   - Fill in your Discord application credentials:\n     - **Discord Client ID**: Your Discord app's client ID\n     - **Discord Secret ID**: Your Discord app's client secret\n     - **Discord Bot Token**: Your Discord bot token\n     - **Discord Guild ID**: Your Discord server ID\n     - **Active Role ID**: Role ID for clients with active products\n     - **Default Role ID**: Role ID for verified clients without active products\n\n## Discord Application Setup\n\n1. **Create Discord Application**:\n\n   - Go to [Discord Developer Portal](https://discord.com/developers/applications)\n   - Create a new application\n   - Note the **Client ID** and **Client Secret**\n\n2. **Create Bot**:\n\n   - In your application, go to the **Bot** section\n   - Create a bot and copy the **Bot Token**\n   - Enable required bot permissions: `Manage Roles`\n\n3. **Set OAuth2 Redirect URI**:\n\n   - In **OAuth2 → General**, add redirect URI:\n\n   ```\n   https://yourdomain.com/index.php?m=discord_verification\n   ```\n\n4. **Invite Bot to Server**:\n   - Use OAuth2 URL Generator with `bot` scope and `Manage Roles` permission\n   - Ensure bot role is higher than roles it needs to assign\n\n## Environment Variables (Optional)\n\nFor enhanced security, you can use environment variables:\n\n```bash\nexport DISCORD_CLIENT_ID=\"your_client_id\"\nexport DISCORD_SECRET_ID=\"your_client_secret\"\nexport DISCORD_BOT_TOKEN=\"your_bot_token\"\n```\n\nThese will override module configuration settings.\n\n## Usage\n\n1. **Client Verification**:\n\n   - Clients visit: `https://yourdomain.com/index.php?m=discord_verification`\n   - They authenticate with Discord and get verified\n   - Roles are automatically assigned based on account status\n\n2. **Admin Management**:\n\n   - Go to **Setup → Addon Modules → Discord Client Verification**\n   - View statistics: total verified users, active vs default role counts\n   - See all verified users with their Discord info and role status\n   - **Sync All Users**: Manually trigger role synchronization for all users\n   - **Individual Actions**: Sync or remove Discord associations per user\n\n3. **Client Area Widget**:\n\n   - Optional sidebar widget showing Discord verification status\n   - Shows \"Active Member\", \"Verified\", or \"Not Verified\" badges\n   - Quick access buttons to verify or manage Discord connection\n   - Can be enabled/disabled in addon configuration\n\n4. **Automatic Role Management**:\n   - Roles update when services are activated/suspended/terminated\n   - Daily cron job ensures synchronization\n   - Manual role updates via admin interface or activity log\n\n## Troubleshooting\n\n1. **Check WHMCS Activity Log**: All operations are logged for debugging\n2. **Verify Discord Permissions**: Ensure bot has `Manage Roles` permission\n3. **Check Role Hierarchy**: Bot role must be higher than assigned roles\n4. **Validate OAuth2 Settings**: Ensure redirect URI matches exactly\n\n## Requirements\n\n- WHMCS 7.0+\n- PHP 7.4+\n- cURL extension\n- Valid Discord application with bot\n\n## Support\n\nCreate a ticket via Github or join the discord\n\n- https://26bz.online/discord\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F26bz%2Fwhmcs-discord-client-verification","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F26bz%2Fwhmcs-discord-client-verification","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F26bz%2Fwhmcs-discord-client-verification/lists"}