# 🚀 QUICK INSTALLATION GUIDE
## Advance Bot Spy v12.6

---

## ⚡ 5-MINUTE SETUP

### STEP 1: UPLOAD (1 minute)
1. Extract ZIP file
2. Upload **botspy** folder to your website root
3. Location: `public_html/botspy/`

### STEP 2: INSTALL (2 minutes)
1. Visit: `https://yourdomain.com/botspy/install.php`
2. Follow 6-step wizard
3. Create admin account
4. **IMPORTANT:** Delete `install.php` after completion

### STEP 3: INTEGRATE (1 minute)

**Add this ONE line to your landing page:**

If HTML, rename to .php first, then add:

```php
<?php require_once($_SERVER['DOCUMENT_ROOT'] . '/botspy/siteguard/filter.php'); ?>
```

**Place at the VERY TOP of your landing page file.**

### STEP 4: CONFIGURE (1 minute)
1. Login: `https://yourdomain.com/botspy/SpyMaster/`
2. Settings → Set Redirect URL
3. Settings → Check Allowed Countries
4. Save

### STEP 5: TEST
1. Visit your landing page
2. Should redirect to your configured URL
3. Check Logs to verify it's working

---

## 📍 FILE LOCATIONS

```
your-website.com/
├── botspy/                    ← Upload here
│   ├── admin/
│   ├── siteguard/
│   └── install.php           ← Run this, then DELETE
└── index.php                  ← Your landing page (add filter here)
```

---

## 🔧 INTEGRATION EXAMPLES

### Example 1: HTML Landing Page

**Before:**
```html
<!DOCTYPE html>
<html>
<head>
    <title>My Landing Page</title>
</head>
<body>
    <!-- Your content -->
</body>
</html>
```

**After:**
1. Rename: `index.html` → `index.php`
2. Add filter at top:

```php
<?php require_once($_SERVER['DOCUMENT_ROOT'] . '/botspy/siteguard/filter.php'); ?>
<!DOCTYPE html>
<html>
<head>
    <title>My Landing Page</title>
</head>
<body>
    <!-- Your content -->
</body>
</html>
```

### Example 2: PHP Landing Page

**Before:**
```php
<?php
include 'config.php';
// Your code
?>
<!DOCTYPE html>
```

**After:**
```php
<?php
require_once($_SERVER['DOCUMENT_ROOT'] . '/botspy/siteguard/filter.php');
include 'config.php';
// Your code
?>
<!DOCTYPE html>
```

---

## ⚙️ MINIMUM CONFIGURATION

### Settings You MUST Configure:

1. **Redirect URL** (where legitimate users go)
   - Example: `https://yourdomain.com/thank-you.html`

2. **Allowed Countries** (select from checkboxes)
   - Example: ☑ USA, ☑ UK, ☑ Canada, ☑ India

### Settings You CAN Skip (optional):

- Block Messages (defaults are fine)
- JavaScript Check (enabled by default)
- Activity Logging (enabled by default)

---

## ✅ HOW TO VERIFY IT'S WORKING

### Test 1: Visit from Allowed Country
- Visit your landing page
- Should redirect to your configured URL
- Check admin logs → Should see NO entry (allowed traffic doesn't log)

### Test 2: Simulate Bot
Run this in terminal/command prompt:
```bash
curl https://yourdomain.com/
```
- Should return block page HTML
- Check admin logs → Should see entry with reason "BOT_DETECTED_UA"

### Test 3: Use VPN (Blocked Country)
- Connect VPN to blocked country (e.g., China, Russia)
- Visit your landing page
- Should see "Access Restricted" page
- Check admin logs → Should see entry with reason "COUNTRY_NOT_ALLOWED"

---

## 🎯 DEFAULT SETTINGS

After installation, these are the defaults:

- **Redirect URL:** (empty - you must set this)
- **Allowed Countries:** USA, UK, Canada, India
- **JavaScript Check:** Enabled
- **Activity Logging:** Enabled
- **Session Timeout:** 30 minutes
- **Cache Duration:** 24 hours
- **Max Log Records:** 10,000

---

## 🔐 DEFAULT CREDENTIALS

**SpyMaster URL:** `https://yourdomain.com/botspy/SpyMaster/`
**Username:** Set during installation
**Password:** Set during installation

**⚠️ SECURITY:** Change password immediately after first login!

---

## 🆘 QUICK TROUBLESHOOTING

### Problem: HTTP 500 Error on landing page
**Solution:** Check filter path. Use this exact code:
```php
<?php require_once($_SERVER['DOCUMENT_ROOT'] . '/botspy/siteguard/filter.php'); ?>
```

### Problem: Logs are empty
**Solution:** 
- Only blocked traffic creates logs
- Allowed countries don't create logs
- Test with curl or VPN to see entries

### Problem: Can't access admin
**Solution:**
- Check URL: `https://yourdomain.com/botspy/SpyMaster/`
- Verify username/password from installation
- Clear browser cache

### Problem: CSS not loading in admin
**Solution:**
- Check file exists: `/botspy/assets/admin-style.css`
- Clear browser cache (Ctrl + Shift + Delete)

---

## 📞 SUPPORT

**Email:** services@hidenseek.click
**Microsoft Teams:** services@hidenseek.click

**Before contacting support, check:**
1. Is install.php deleted?
2. Did you add filter to landing page?
3. Is redirect URL configured?
4. Are countries selected?
5. Have you tested with VPN/curl?

---

## 📋 POST-INSTALLATION CHECKLIST

- [ ] Installer completed successfully
- [ ] install.php deleted
- [ ] SpyMaster login working
- [ ] Filter added to landing page
- [ ] Redirect URL configured
- [ ] Countries selected
- [ ] Tested with allowed country
- [ ] Tested with VPN (blocked country)
- [ ] Tested with curl (bot simulation)
- [ ] Logs showing blocked attempts
- [ ] SpyMaster password changed
- [ ] Bookmarked admin URL

---

## 🎉 DONE!

Your Bot Spy is now protecting your landing page!

**Next Steps:**
1. Monitor logs weekly
2. Adjust countries as needed
3. Set calendar reminder for subscription renewal
4. Contact support if issues arise

---

**Installation Time:** ~5 minutes
**Difficulty:** Easy (no coding required)
**Support:** Available via email/Teams

**Advance Bot Spy v12.6** - Professional Click Fraud Protection
