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.

BuddyPress Instaban


The BuddyPress Instaban plugin allows site administrators to quickly remove problem members with a single click from the front-end. A confirmation dialog prevents accidental removals. If your site uses OneAll’s Social Login plugin to allow members to create new accounts, Instaban will add their unique token to a list of ‘unsafe’ tokens. Integration options with OneAll are included.


  • Eliminates additional steps of searching user accounts in the WordPress admin panel.
  • Integrates with member profiles on activation with predefined hooks.
  • Optionally bans members if they’ve created an account with OneAll social login.
  • Confirmation dialog with AJAX handler is fast, safe and efficient.
  • Ability to customize button placement in your theme with a template tag.
    For integration with OneAll Social Login, you may perform a check with the user_token returned from the API response, like so:

    // from oa-social-login/includes/communication.php:


    • Handle the callback
      function oa_social_login_callback () {

      //User Data
      if (is_object ($social_data)) {
      $identity = $social_data->response->result->data->user->identity;
      $user_token = $social_data->response->result->data->user->user_token;

      // verify that user token isn't associated with an unsafe login
      if ( bp_instaban_is_user_token_unsafe( $user_token, 'oa_social_login_user_unsafe_tokens' ) ) {
          header($_SERVER['SERVER_PROTOCOL'] . ' 501 Not Implemented', true, 501); // throw a 501 error


In the above example, the server returns an HTTP 501 error. This effectively prevents the user from creating an account again with the same social network provider.
You may choose to handle it differently. In the future, OneAll may provide a hook to enable this integration without modifying the plugin directly.


  • Screenshot of a member profile with the Instaban button.


  1. Download, install and activate the plugin.
  2. To remove (and optionally ban) a member, simply visit their profile and click the ‘Remove and Ban User’ button.
  3. Confirm the action with the dialog.
  4. You’re done!


Do I have to add template tags to my theme?

You should not have to change your theme template files. The Instaban plugin integrates into your site by using predefined hooks.

Does Instaban support custom embedding with a template tag?

Yes. You can add the Instaban button to your theme with the bp_instaban_add_kickban_button() function. We recommend embedding the tag like so:

<?php if ( function_exists( 'bp_instaban_add_kickban_button' ) ) : ?>
    <?php bp_instaban_add_kickban_button(); ?>
<?php endif; ?>
Is it possible to integrate Instaban with OneAll Social Login?

Yes. When removing and banning a member, Instaban adds the unique token returned by the user’s social network to a list of ‘unsafe’ tokens.
To prevent banned members from repeatedly creating new accounts with Social Login, oa_social_login_callback() must do a check with
the function bp_instaban_is_user_token_unsafe().


There are no reviews for this plugin.

Contributors & Developers

“BuddyPress Instaban” is open source software. The following people have contributed to this plugin.


Translate “BuddyPress Instaban” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Initial release.