BuddyPress Private Community User Guide

Get Started

Getting Started

Installation

  1. Upload the plugin to /wp-content/plugins/
  2. Activate the plugin through the WordPress admin
  3. Navigate to WB Plugins → Private Community

First Time Setup

When you first access Private Community, you’ll see five tabs:

  • 🏠 Welcome – Overview and quick start
  • 🔓 Partial Protection – Protect specific pages/sections
  • 🔒 Full Protection – Lock entire site
  • ⚙️ Protection Rules – Configure protection behavior
  • 🆘 Support – Help and documentation

Understanding Protection Types

Partial Protection

Best for: Sites that need some public content

  • Protect specific URLs or pages
  • Lock BuddyPress/BuddyBoss components
  • Allow public access to most content

Full Protection

Best for: Private communities, membership sites

  • Lock entire website
  • Define whitelist for public pages
  • Force login for all content

Protection Priority

⚠️ Important: Full Protection always overrides Partial Protection settings.


Partial Protection Setup

Step 1: Choose What to Protect

Protecting Specific URLs

  1. Go to Partial Protection tab
  2. In the URLs to Protect textarea, enter one URL per line:
    /members
    /private-content
    /premium-resources
    

Using Wildcards

You can use asterisks (*) for pattern matching:

/blog/*           # All blog posts
/shop/products/*  # All product pages
*/private/*       # Any URL containing /private/
*.pdf            # All PDF files

Protecting BuddyPress Components

If you have BuddyPress/BuddyBoss installed:

  1. Check the components you want to protect:
    • ☑️ Members Directory
    • ☑️ Groups
    • ☑️ Activity Streams
  2. Click Save Changes

Step 2: Save Your Settings

Click the Save Changes button at the bottom of the page.

Note: Full Protection overrides these settings


Full Protection Setup

Step 1: Enable Complete Protection

  1. Go to Full Protection tab
  2. Check ☑️ Enable Complete Site Protection
  3. Your entire site is now private!

Step 2: Configure Whitelist

Add URLs that should remain public. By default, these are whitelisted:

# Homepage (remove this line to protect homepage too)
/
# WordPress Login Page (required)
wp-login.php
wp-admin
admin-ajax.php

# Add your public pages below:
/about
/contact
/terms

Whitelist Examples

# Exact URLs
/public-page
/contact-form

# Wildcards
/api/*           # All API endpoints
/public/*        # All URLs starting with /public/
*.xml           # All XML files (sitemaps, feeds)
*.txt           # robots.txt, etc.

# WordPress Core
/wp-json/*      # REST API
/feed           # RSS feed

Step 3: Save Changes

Click Save Changes to activate full protection.


Protection Rules Configuration

Protection Methods

1. Plugin Form (Default)

Shows a built-in login/register form:

  • Clean, integrated design
  • Works without additional setup
  • Includes login and registration options

2. Custom Form

Display your own content:

  • Add custom HTML
  • Use shortcodes
  • Embed third-party forms

Example:

<div class="custom-locked-content">
  <h2>Members Onlyh2>
  <p>This content requires membership.p>
  [your_custom_login_shortcode]
div>

3. Page Redirect

Redirect visitors to a specific page:

  1. Select Page Redirect
  2. Choose your login/membership page
  3. Visitors automatically redirect

Locked Content Message

Customize the message shown to locked-out visitors:

  1. Use the visual editor to format your message
  2. Add images, links, or videos
  3. Include a call-to-action

Example message:

Welcome to Our Exclusive Community!

This content is available to members only. Join today to access:

  • Premium resources
  • Member discussions
  • Exclusive content

[Login] or [Register] to continue.


Common Use Cases

1. Membership Site

Goal: Paid members-only content

Setup:

  1. Enable Full Protection
  2. Whitelist:
    • Homepage
    • Pricing page
    • Registration page
    • Payment pages
  3. Set redirect to membership sales page

2. Private Company Portal

Goal: Employee-only access

Setup:

  1. Enable Full Protection
  2. Whitelist only:
    • Login page
    • Password reset
  3. Custom message: “Company employees only”

3. Protected Blog Section

Goal: Some posts public, some private

Setup:

  1. Use Partial Protection
  2. Protect URLs:
    /premium/*
    /members-only/*
    
  3. Keep main blog public

4. BuddyPress Community

Goal: Public homepage, private community

Setup:

  1. Use Partial Protection
  2. Check all BuddyPress components
  3. Add community pages to protected URLs
  4. Keep marketing pages public

5. Course Website

Goal: Free previews, paid courses

Setup:

  1. Use Partial Protection
  2. Protect:
    /courses/*/lessons/*
    /courses/*/quizzes/*
    
  3. Keep course overviews public

Troubleshooting

Protected Pages Still Accessible

Check these:

  1. Clear your browser cache
  2. Clear any caching plugins
  3. Log out completely (use incognito mode to test)
  4. Verify URLs are entered correctly
  5. Check if Full Protection is overriding Partial Protection

Login Form Not Appearing

Solutions:

  1. Check Protection Method setting
  2. Ensure theme compatibility
  3. Look for JavaScript errors in console
  4. Disable conflicting plugins temporarily

Redirect Loop Issues

Fix:

  1. Ensure login page is whitelisted
  2. Check redirect page isn’t protected
  3. Clear cookies and cache
  4. Verify WordPress Address settings

Some Users Can’t Access Protected Content

Verify:

  1. Users are properly logged in
  2. User roles and capabilities
  3. No conflicting membership plugins
  4. Session/cookie issues

Changes Not Taking Effect

Steps:

  1. Click Save Changes button
  2. Clear all caches:
    • Browser cache
    • Plugin cache
    • CDN cache
  3. Test in incognito/private mode

FAQ

Q: Can I protect custom post types?

A: Yes! Add their URLs to the protected URLs list. Use wildcards for patterns.

Q: Will this affect SEO?

A: Protected pages won’t be indexed by search engines. Consider keeping key pages public for SEO.

Q: Can I have different messages for different pages?

A: Currently, one message applies to all protected content. Use the Custom Form method with conditional shortcodes for variety.

Q: Does it work with page builders?

A: Yes, compatible with popular builders like Elementor, Divi, and Gutenberg.

Q: Can logged-in users see everything?

A: Yes, any logged-in user bypasses protection. For role-based access, consider additional membership plugins.

Q: How do wildcards work exactly?

A:

  • * matches any characters
  • /blog/* matches /blog/post-1/blog/category/news
  • */private/* matches /section/private/content
  • Pattern matching is case-insensitive

Q: Can I protect media files?

A: Direct file protection requires server configuration. The plugin protects attachment pages, not direct file URLs.

Q: Is there a way to temporarily disable protection?

A: Deactivate the plugin or uncheck all protection settings.

Q: Can I export/import settings?

A: Settings are stored in the WordPress database. Use standard WordPress export/import tools.

Q: Does it support multisite?

A: Yes, activate per-site or network-wide. Each site maintains independent settings.


Best Practices

Security

  1.  Always whitelist login pages
  2.  Use strong passwords
  3.  Keep plugin updated
  4.  Regular backups

Performance

 

  1.  Use caching wisely
  2. Minimize protected URLs
  3.  Optimize whitelist rules
  4.  Monitor server resources

User Experience

 

  1.  Clear, friendly locked messages
  2.  Obvious login/register options
  3.  Mobile-responsive forms
  4.  Quick loading times

Testing

 

  1.  Test as logged-out user
  2.  Check mobile experience
  3.  Verify all protected URLs
  4.  Test in different browsers

Quick Reference

URL Pattern Examples

# Exact match
/exact-page

# All subpages
/parent/*

# Specific file types
*.pdf
*.doc

# Complex patterns
/blog/*/comments
/shop/product-*/reviews

Whitelist Essentials

# Always include
wp-login.php
wp-admin
admin-ajax.php

# Often needed
/wp-json/*      # REST API
xmlrpc.php      # XML-RPC
/feed          # RSS feeds

Protection Hierarchy

  1. Logged-in users → Full access
  2. Full Protection whitelist → Public access
  3. Full Protection → Protected
  4. Partial Protection URLs → Protected
  5. Everything else → Public

Getting Help

Support Resources

Before Contacting Support

  1. Check this guide
  2. Review FAQ section
  3. Test in default theme
  4. Disable other plugins
  5. Check error logs

Information to Provide

  • WordPress version
  • Plugin version
  • Active theme
  • Other active plugins
  • Steps to reproduce issue
  • Error messages (if any)

Glossary

Whitelist: URLs that remain publicly accessible

Wildcard: Pattern matching using * character

Protection Method: How locked content is handled

BuddyPress Components: Social features like members, groups, activity

URL Pattern: Rules for matching multiple URLs

Incognito/Private Mode: Browser mode for testing as logged-out user

Last updated: September 19, 2025