# Admin Settings Guide

This guide explains all the settings available in the BuddyPress Check-ins plugin. As a site administrator, you can customize how check-ins work on your site.

---

## Accessing the Settings

1. Log in to your WordPress dashboard
2. Go to **Wbcom > BuddyPress Check-ins**
3. You'll see the settings tabs

---

## General Settings

### Enable Check-ins Tab

**What it does:** Shows or hides the "Check-ins" tab on user profiles.

| Option | Result |
|--------|--------|
| Enabled | Users see a Check-ins tab on their profile showing all their location history |
| Disabled | The Check-ins tab is hidden from user profiles |

**When to enable:**
- Travel or location-based communities
- Event-focused sites
- Communities where sharing locations adds value

**When to disable:**
- Sites where location sharing isn't relevant
- Privacy-focused communities

---

### Rename Check-ins Tab

**What it does:** Changes the name of the Check-ins tab to something else.

**Default name:** Check-ins

**Example alternatives:**
- "My Places"
- "Locations"
- "Where I've Been"
- "Travel Log"

**How to use:**
1. Enter your preferred tab name in the text field
2. Click **Save Changes**

---

### Manage Location Profile Field Visibility

**What it does:** Controls whether the Location field appears on user profile edit screens.

| Option | Result |
|--------|--------|
| Enabled | The Location field is hidden from the profile editing area |
| Disabled | Users can see and edit their Location profile field |

**Note:** This setting hides the field from the profile edit page, not from displaying saved locations.

---

## Google Maps API Key

### Why You Need an API Key

The plugin uses Google Maps services to:
- Search for locations
- Display maps
- Show location suggestions
- Geocode addresses

Without a valid API key, the check-in feature won't work properly.

### Setting Up Your API Key

#### Step 1: Get Your API Key

**Option A: Use the Generate Button**
1. Click the **Generate API Key** button in the settings
2. Sign in to your Google account if prompted
3. Copy the generated key

**Option B: Manual Setup**
1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Create a new project or select an existing one
3. Enable these APIs:
   - Maps JavaScript API
   - Places API
   - Geocoding API
4. Create credentials (API key)
5. Copy your API key

#### Step 2: Add the API Key

1. Paste your API key in the **API Key** field
2. Click **Verify** to test the key
3. If successful, you'll see a green checkmark
4. Click **Save Changes**

### API Key Verification

After entering your API key:
- Click the **Verify** button
- Wait for the verification result
- Green checkmark = API key is valid
- Error message = Check your API key or API settings

### Troubleshooting API Key Issues

| Problem | Solution |
|---------|----------|
| Verification fails | Make sure all required APIs are enabled in Google Cloud Console |
| "API key not valid" | Check for typos or extra spaces in the key |
| "This API project is not authorized" | Enable the required APIs (Maps, Places, Geocoding) |
| Billing error | Google requires billing info even for free tier usage |

### API Key Security

**Important tips:**
- Restrict your API key to your domain in Google Cloud Console
- Don't share your API key publicly
- Monitor your API usage in Google Cloud Console
- Set up billing alerts to avoid unexpected charges

---

## Group Location Settings (Pro Feature)

**Note:** These settings are available in the Pro version of the plugin.

### Location/Address Tab Label

Changes the name of the location tab in groups.

**Default:** Location

### Location/Address Tab Slug

Sets the URL slug for the group location tab.

**Default:** location

### Group Location Fields

Configure which address fields appear for groups:

| Field | Description |
|-------|-------------|
| Street | Street address line |
| City | City name |
| State | State or province |
| Postal Code | ZIP or postal code |
| Country | Country name |

Each field can be:
- Enabled or disabled
- Renamed to fit your needs

---

## Saving Your Settings

After making changes:

1. Click the **Save Changes** button
2. Wait for the confirmation message
3. Your changes take effect immediately

---

## Recommended Settings

### For Travel Communities

| Setting | Recommendation |
|---------|----------------|
| Enable Check-ins Tab | Yes |
| Tab Name | "Travel Log" or "Adventures" |
| Location Profile Field | Show |

### For Local Business Directories

| Setting | Recommendation |
|---------|----------------|
| Enable Check-ins Tab | Yes |
| Tab Name | "Visited Places" |
| Location Profile Field | Show |

### For Privacy-Conscious Sites

| Setting | Recommendation |
|---------|----------------|
| Enable Check-ins Tab | Optional |
| Tab Name | Default or custom |
| Location Profile Field | Hide |

---

## Need Help?

- [Getting Started Guide](./getting-started.md)
- [FAQ](./faq.md)
- [Troubleshooting Guide](./troubleshooting.md)
- [Contact Support](https://wbcomdesigns.com/contact)
