# Getting Started with BuddyPress Check-ins

Welcome to BuddyPress Check-ins! This plugin lets your community members share their location when posting activities. It's perfect for travel communities, local meetup groups, or any BuddyPress site where location matters.

---

## What You'll Need

Before you begin, make sure you have:

- WordPress 5.0 or higher
- BuddyPress or BuddyBoss Platform installed and activated
- A Google Maps API Key (we'll show you how to get one)

---

## Installation

### Step 1: Install the Plugin

1. Go to your WordPress dashboard
2. Navigate to **Plugins > Add New**
3. Search for "BuddyPress Check-ins"
4. Click **Install Now**
5. Once installed, click **Activate**

### Step 2: Access Plugin Settings

After activation, you'll find the settings at:

**Dashboard > Wbcom > BuddyPress Check-ins**

---

## Setting Up Your Google Maps API Key

The plugin needs a Google Maps API key to work. Don't worry - it's free for most sites!

### How to Get Your API Key

1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Sign in with your Google account
3. Create a new project or select an existing one
4. Enable these APIs:
   - Maps JavaScript API
   - Places API
   - Geocoding API
5. Go to **Credentials** and click **Create Credentials > API Key**
6. Copy your new API key

### Adding Your API Key to the Plugin

1. Go to **Dashboard > Wbcom > BuddyPress Check-ins**
2. Paste your API key in the **API Key** field
3. Click **Verify** to test the key
4. Click **Save Changes**

**Tip:** If you see a green checkmark, your API key is working!

---

## Quick Configuration

Here are the basic settings you might want to adjust:

| Setting | What It Does |
|---------|--------------|
| Enable Check-ins Tab | Shows a "Check-ins" tab on user profiles |
| Rename Check-ins Tab | Change the tab name to something like "My Places" |
| Manage Location Profile Field | Adds a location field to user profiles |

---

## You're Ready!

That's it! Your members can now:

- Add locations to their activity posts
- See their check-ins on their profile
- View check-ins on a map

**Next Steps:**
- [Learn how to post a check-in](./how-to-checkin.md)
- [View and manage your check-ins](./managing-checkins.md)
- [Customize the plugin settings](./settings-guide.md)

---

## Need Help?

- Visit our [Support Page](https://wbcomdesigns.com/contact)
- Check the [FAQ section](./faq.md)
- Browse the [Troubleshooting Guide](./troubleshooting.md)
