User Guide

Navigate to: WP Admin → WB Plugins → Check-ins Pro → Map Settings

Choose between:

• Google Maps – Requires free API key, offers satellite view and advanced features
• OpenStreetMap – No API key needed, completely free

Navigate to: General Settings tab

Turn on: “Enable Check-in functionality” toggle

Customize:

• Tab label (what members see in their profile menu)
• Tab slug (URL-friendly version)
• Who can see check-ins (by user role)

Navigate to: Member Location tab

Choose:

• Single Address Field – One field for full address (simple)
• Multiple Address Fields – Separate fields for Street, City, State, etc. (detailed)

Map to your BuddyPress profile fields – Select which xProfile fields store location data

Navigate to: Group Location tab

Same options as member locations – Groups can have addresses too!

What members see:

• Location button in activity update box
• Search for nearby places
• Select location to attach to their post

Result:

• Activity update shows location with map marker
• Other members can see where they checked in
• Location appears in activity feed

Perfect for:

• Event check-ins
• Travel updates
• Meeting locations
• Business visits

What it does:

• Adds location/address fields to member profiles
• Displays map on member profile showing their location
• Allows members to update their address anytime

Use cases:

• Local community directories
• Alumni networks
• Regional groups
• Service provider listings

Setup:

• Create xProfile fields for address components
• Map them in Member Location settings
• Members fill out during registration or profile edit

What it does:

• Groups can have a physical address
• Location tab appears in group navigation
• Map displays on group page

Use cases:

• Local chapters
• Business locations
• Event venues
• Community centers

How groups set it up:

• Group admin visits “Location” tab in group
• Enters address information
• Map automatically displays on group page

Member Directory Map:

• Shows all members on one interactive map
• Click markers to see member info
• Find members in specific areas

Group Directory Map:

• Shows all groups on one map
• See which groups are near you
• Filter by public/private groups

Enable in: Members Directory / Groups Directory settings tabs

What it does:

• Search for members within X miles/kilometers of a location
• Enter address or use “Near Me” button
• Results show distance from search location

Setup: Navigate to: Members Directory → Enable proximity search

Configure:

• Distance units (Miles or Kilometers)
• Search radius options (10, 25, 50 miles, etc.)
• “Near Me” tab for quick location-based search

Where members find it: Profile → Check-ins tab

What’s shown:

• List of all locations they’ve checked in
• Map showing all check-in locations
• Date and details of each check-in
• Saved favorite places

Privacy control:

• Choose who can view check-in history (by role)
• Set in General Settings → “Who can see Check-ins tab”

What it does:

• Displays closest members based on their profile location
• Perfect for sidebars, footers, or any widgetized area
• Helps members discover nearby community members

Where to add it: WP Admin → Appearance → Widgets → “Members Near Me”

Configuration options:

• Widget Title – Custom heading (e.g., “Members Nearby”)
• Search Radius – Distance in kilometers (5-50 km)
• Number of Members – How many to display (5-10)
• Show Avatars – Toggle member profile pictures
• Show Distance – Display how far away each member is

Perfect for:

• Community discovery
• Regional networking
• Local meetups
• Finding nearby services

Fallback behavior:

• If logged-in user has no location → Shows message to add location
• If no nearby members found → Displays friendly “no results” message

What it shows: Real-time location statistics on your WordPress dashboard

Metrics included:

📊 Geographic Distribution

• Top 10 cities with member counts
• Visual breakdown of where your community is located

📈 Check-in Activity

• Weekly check-in count
• Monthly check-in count
• Activity trends over time

👥 New Member Locations

• Members who added locations in last 30 days
• Growth tracking for location adoption

Where to find it: WP Admin Dashboard → “BuddyPress Check-ins Analytics” widget

Use cases:

• Identify strongest geographic communities
• Track location feature adoption
• Plan regional events based on member density
• Monitor check-in engagement

What it does: Creates sample members with realistic locations for testing

Perfect for:

• Testing before you have real members
• Demonstrating features to stakeholders
• Quality assurance and bug testing
• Training administrators

How to use:

1. Navigate to: Demo Data tab in plugin settings
2. Choose member count: 10-100 members
3. Click “Generate Demo Data”
4. Wait for progress bar to complete

What gets created:

• Members with usernames like “demo_user_1”
• Random locations across 50+ major cities worldwide
• Realistic addresses with coordinates
• Profile data for testing proximity search

Features:

• One-click generation
• Progress tracking
• Easy cleanup with “Clear Demo Data” button
• Safe to use on test/staging sites

⚠️ Important:

• Only use on test/development sites
• Demo users have password: “demo123”
• Can be removed completely with one click

💡 Privacy Use Cases:

• Real Estate Sites: Show city only to protect exact addresses
• Dating Communities: Show city & state for general area without exact location
• Business Directories: Show full address for visibility
• Alumni Networks: Show city & state to connect regional members

Tip: Click “Verify” button after entering Google Maps API key to test it works!

Note: You must create xProfile fields first, then map them here.

You can add interactive maps to any page or post using shortcodes.

What it does: Displays a map showing all members who have added their location

How to use:

1. Create or edit a page/post
2. Add this shortcode where you want the map:

   [bpchkpro_mashupMap]
   

3. Publish the page

Customize the map:

Show only 100 members:

[bpchkpro_mashupMap limit="100"]

Make map larger:

[bpchkpro_mashupMap map_height="600px"]

Show only subscribers:

[bpchkpro_mashupMap user_role="subscriber"]

Custom size members map:

[bpchkpro_mashupMap map_width="800px" map_height="500px"]

Filter by member type:

[bpchkpro_mashupMap member_type="premium"]

Mix options together:

[bpchkpro_mashupMap limit="50" user_role="subscriber" map_height="500px"]

What it does: Displays a map showing all groups that have added their location

How to use:

1. Create or edit a page/post
2. Add this shortcode:

   [bpchkpro_groupmashupMap]
   

3. Publish

Customize the map:

Show only public groups:

[bpchkpro_groupmashupMap status="public"]

Larger map:

[bpchkpro_groupmashupMap map_height="550px"]

Show only 25 groups:

[bpchkpro_groupmashupMap limit="25"]

Public and private groups only (exclude hidden):

[bpchkpro_groupmashupMap status="public,private"]

Filter by group type:

[bpchkpro_groupmashupMap group_type="community"]

All options:

Setup:

1. Enable member locations (single address field)
2. Create xProfile field: “Business Address”
3. Map to Member Location settings
4. Enable member directory map
5. Add member map shortcode to “Find a Business” page

Result: Interactive directory showing all member businesses on a map

Setup:

1. Multiple address fields (Street, City, State, ZIP, Country)
2. Enable proximity search
3. Set radius options: 10, 25, 50, 100 miles
4. Enable “Near Me” tab

Result: Alumni can find classmates living nearby

Setup:

1. Enable check-in functionality
2. Label as “Event Check-ins”
3. Restrict visibility to members only
4. Groups add event venue locations

Result: Members check in at events, see who else is there

Setup:

1. Enable group locations
2. Groups = regional chapters
3. Add group map shortcode to “Find a Chapter” page
4. Filter by public groups only

Result: Interactive map showing all chapter locations

Setup:

1. Member locations enabled
2. Member type: “Provider” vs “Client”
3. Member map with filter: member_type="provider"
4. Proximity search enabled

Result: Clients find providers in their area

If using Google Maps:

1. Go to Map Settings tab
2. Check API Key is entered
3. Click “Verify” button
4. Should see green checkmark if valid
5. If red X, get new API key from Google Cloud Console

If using OpenStreetMap:

1. Map Settings → Select “Open Street Map”
2. Save settings
3. Clear your browser cache
4. Refresh page

Both providers:

1. Check map width/height aren’t set to 0
2. Disable other map plugins temporarily
3. Clear WordPress cache
4. Try different browser/incognito mode

Check:

1. Shortcode name is exact (copy/paste from this guide)
2. No extra spaces inside brackets
3. Using WordPress block editor or classic editor (not plain text)

Correct:

[bpchkpro_mashupMap]

Wrong:

[ bpchkpro_mashupMap ]

For member maps:

• Members must fill out their location in profile
• Check member has location fields visible
• Ensure fields are mapped in Member Location settings

For group maps:

• Groups must have location set
• Group admin must fill out Location tab
• Check group is public or you’re filtering correctly

Check:

1. General Settings → “Enable Check-in functionality” is ON
2. Browser allows location access (will see prompt)
3. Using HTTPS site (required for geolocation)
4. Activity component is active in BuddyPress settings

Check:

1. Members Directory Settings → “Enable proximity search” is ON
2. Distance units selected (Miles or Kilometers)
3. Radius values entered (comma-separated)
4. Members have location data in profiles
5. xProfile component is active

Google Maps only:

1. API Key must have Places API enabled
2. Check API restrictions in Google Cloud Console
3. Click Verify button in Map Settings
4. May need to enable billing in Google Cloud (usually free tier is enough)

Members can:

• Choose whether to add location to profile (optional)
• Edit/remove their location anytime
• Control who sees their check-in history (via role settings)

Admins can:

• Control which roles see check-ins tab
• Exclude specific members from directory maps
• Disable check-ins completely

Group admins can:

• Add/edit group location
• Remove group location
• Only group admins see location editing fields

Privacy by group status:

• Public groups – Location visible to everyone
• Private groups – Location visible to members only
• Hidden groups – Location visible to members only

• Stored in WordPress database
• Not shared with third parties
• Google Maps/OSM only used for display
• Can be deleted by removing xProfile data

• Enhanced security
• Better input validation
• Improved admin interface
• Bug fixes

No! All your existing settings are preserved:

• Map provider stays the same
• All locations remain unchanged
• Shortcodes work identically
• No reconfiguration needed

1. Backup (recommended but optional)
2. Update via WordPress admin → Plugins
3. Done! – Everything works as before

1. Clear all caches – WordPress, browser, CDN
2. Test in different browser – Try Chrome, Firefox, Safari
3. Disable other plugins – Check for conflicts
4. Check BuddyPress is active – Plugin requires BuddyPress
5. Review this guide – Common issues covered above

Official Support: https://wbcomdesigns.com/support/

Include in your message:

• Plugin version (shown at top of settings page)
• WordPress & BuddyPress versions
• What you’re trying to do
• What’s happening instead
• Screenshots if possible
• Browser console errors (F12 → Console tab)

Documentation: https://docs.wbcomdesigns.com

Facebook Community: Join for tips and discussions

1. Use HTTPS – Required for geolocation features
2. Optimize images – Member avatars load on maps
3. Set reasonable limits – Don’t show 1000+ markers (performance)
4. Test before launch – Try all features with test accounts
5. Mobile responsive – Maps work on phones/tablets
6. Cache-friendly – Plugin works with caching plugins

Small community (<100 members):

• Show all members on directory map
• Enable proximity search
• Single address field is fine

Medium community (100-1000 members):

• Limit directory map to 500 markers
• Enable proximity search with multiple radius options
• Consider multiple address fields for accuracy

Large community (1000+ members):

• Don’t show map on main directory (too slow)
• Use shortcode maps with filters instead
• Enable proximity search (works well at scale)
• Encourage member type/role usage for filtering

Q: Is Google Maps API free?

A: Google offers $200/month free credit – enough for most small-medium sites. OpenStreetMap is completely free.

Q: Can I use both Google Maps and OpenStreetMap?

A: Choose one as your primary provider. Switching is easy (just change setting).

Q: Do members need to allow location access?

A: Only for “use my current location” features. Manual address entry works without permission.

Q: Can I customize map appearance?

A: Yes – map type (roadmap, satellite, etc.), zoom level, and size are all customizable.

Q: Does this work with BuddyBoss?

A: Yes! Fully compatible with both BuddyPress and BuddyBoss.

Q: Can I import member locations from CSV?

A: Yes – import to xProfile fields, plugin will geocode addresses automatically.

Q: Is member location required?

A: No – completely optional for members.

Q: Can I track member movements?

A: No – only stores location when member manually checks in or updates profile.

Q: Does it work offline?

A: No – requires internet for map display and geocoding.

Q: Can I use custom map markers?

A: Advanced feature – requires custom CSS/code (see developer guide).