Title: Sign In With BitBadges
Author: trevormil
Published: <strong>April 12, 2025</strong>
Last modified: April 12, 2025

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/sign-in-with-bitbadges/assets/icon-256x256.png?rev=3271536)

# Sign In With BitBadges

 By [trevormil](https://profiles.wordpress.org/trevormil/)

[Download](https://downloads.wordpress.org/plugin/sign-in-with-bitbadges.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/sign-in-with-bitbadges/#description)
 * [Reviews](https://wordpress.org/plugins/sign-in-with-bitbadges/#reviews)
 *  [Installation](https://wordpress.org/plugins/sign-in-with-bitbadges/#installation)
 * [Development](https://wordpress.org/plugins/sign-in-with-bitbadges/#developers)

 [Support](https://wordpress.org/support/plugin/sign-in-with-bitbadges/)

## Description

This plugin allows users to gate their site with BitBadges – claims, payments, NFT
badges, and more!

Important Note: This plugin ONLY handles authentication with BitBadges – it does
not restrict access to your site by itself. For restricting access, we recommend
using this plugin in conjunction with:

 * [Force Login](https://wordpress.org/plugins/wp-force-login/) – Forces users to
   log in to view your site
 * [Restrict Content](https://wordpress.org/plugins/restrict-content/) – Restrict
   content to logged-in users
 * [Members](https://wordpress.org/plugins/members/) – Advanced user roles and permissions
 * Or other plugins that restrict access to your site

### Translation

The Sign In With BitBadges plugin is currently available in English only. The plugin
is translation-ready and uses WordPress’s internationalization system, making it
easy to add support for additional languages in the future.

### Configuration

 1. Create a new application (OAuth App) in the [BitBadges Developer Portal](https://bitbadges.io/developer)
 2. Set your redirect URI to: `https://your-wordpress-site.com/wp-login.php?action=
    bitbadges-callback`
 3. Copy your Client ID and Client Secret
 4. Go to your WordPress admin panel > Settings > BitBadges SIWBB
 5. Enter your Client ID and Client Secret
 6. (Optional) Configure a claim ID to gate access and other additional settings
 7. Save the settings

### Features

 * Adds a “Sign in with BitBadges” button to the WordPress login form
 * Creates WordPress users automatically when they first sign in with BitBadges
 * Secure OAuth 2.0 implementation with state verification
 * Simple admin interface for configuration
 * Optional exclusive BitBadges authentication mode (disable normal WordPress login)
 * Claim-gated access support
 * Emergency admin access URL for exclusive mode
 * Customizable claim visibility on authorization page

### Security

 * CSRF protection using state parameter
 * Secure storage of client credentials
 * WordPress nonce verification
 * Input sanitization
 * Proper error handling
 * Secure admin access fallback
 * Claim verification

### User Experience

 * Clean, centered login button design
 * Shortened wallet addresses for better readability
 * Clear separation between traditional and BitBadges login
 * Visible claim requirements before authentication
 * Seamless first-time user setup

### Requirements

 * WordPress 5.0 or higher
 * PHP 7.0 or higher
 * HTTPS enabled on your site (required for secure OAuth)

### Support

For support or feature requests, please visit the [BitBadges website](https://bitbadges.io)
or create an issue in the GitHub repository.

### License

This plugin is licensed under the GPL v2 or later.
 License URI: https://www.gnu.
org/licenses/gpl-2.0.html

### External Services

This plugin connects to BitBadges (https://bitbadges.io) for authentication and 
claim verification. BitBadges is a blockchain-based authentication and digital credentials
platform.

#### Service Endpoints Used

 * Authentication: https://bitbadges.io/siwbb/authorize
 * Token Management: https://api.bitbadges.io/api/v0/siwbb/token
 * Claim Verification: https://api.bitbadges.io/api/v0/claims/success

#### Data Transmission

The plugin transmits the following data to BitBadges servers:

 1. During Authentication:
 2.  * Client ID and Secret (from your BitBadges OAuth app)
     * Redirect URI (your WordPress login callback URL)
     * State parameter (for security)
 3. During Claim Verification:
 4.  * User’s BitBadges address
     * Claim ID (if configured)
     * API key (for authentication)
 5. Token Management:
 6.  * Access tokens are stored in WordPress user meta
     * Tokens are used to verify user authentication status

No personal user data beyond the BitBadges address is transmitted to our servers.
All communication is done over HTTPS.

#### Service Documentation

 * Terms of Service: https://bitbadges.io/policies
 * Privacy Policy: https://bitbadges.io/policies
 * Developer Documentation: https://docs.bitbadges.io

BitBadges is required for this plugin to function. Without access to BitBadges services,
users will not be able to authenticate or verify claims.

## Installation

 1. Download the plugin files and upload them to your `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Go to Settings > BitBadges SIWBB to configure the plugin

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Sign In With BitBadges” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ trevormil ](https://profiles.wordpress.org/trevormil/)

[Translate “Sign In With BitBadges” into your language.](https://translate.wordpress.org/projects/wp-plugins/sign-in-with-bitbadges)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/sign-in-with-bitbadges/),
check out the [SVN repository](https://plugins.svn.wordpress.org/sign-in-with-bitbadges/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/sign-in-with-bitbadges/)
by [RSS](https://plugins.trac.wordpress.org/log/sign-in-with-bitbadges/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release with basic OAuth functionality
 * Added exclusive authentication mode
 * Added claim-gating support
 * Added emergency admin access
 * Improved user display names
 * Enhanced UI/UX for login button
 * Added claim visibility options

## Meta

 *  Version **1.0.0**
 *  Last updated **1 year ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.0 or higher **
 *  Tested up to **6.7.5**
 *  PHP version ** 7.0 or higher **
 * Tags
 * [authentication](https://wordpress.org/plugins/tags/authentication/)[nft](https://wordpress.org/plugins/tags/nft/)
   [web3](https://wordpress.org/plugins/tags/web3/)
 *  [Advanced View](https://wordpress.org/plugins/sign-in-with-bitbadges/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/sign-in-with-bitbadges/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/sign-in-with-bitbadges/reviews/)

## Contributors

 *   [ trevormil ](https://profiles.wordpress.org/trevormil/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/sign-in-with-bitbadges/)