# JA Square | Admin & Visitor Analytics System

A lightweight, secure, and visually modern **Material Design 3 (M3)** dashboard for tracking visitor analytics and managing global site settings (like Google AdSense).

## 🚀 Features

* **Secure Authentication**: DB-driven login using PHP `password_hash()` and `password_verify()`.
* **IP Intelligence**: Tracks visitor IP, City, Country, Organization, and Timezone.
* **AdSense Control**: Centralized management for Google AdSense Publisher IDs.
* **M3 Dashboard**: A clean, responsive UI built with Google's Material Design 3 principles.
* **Data Management**: Search, filter, and delete visitor logs directly from the UI.

---

## 🛠️ Installation & Setup

1. **Configure Database**:
Open `db_connect.php` and update your MySQL credentials:
```php
$host = "localhost";
$user = "your_username";
$pass = "your_password";
$db = "your_database";
```

2. **Initialize Tables**:
Run `db_setup.php` in your browser. This will:
* Drop old tables (if any).
* Create `visitor_logs` and `settings` tables.
* Insert default credentials:
* **User**: `admin`
* **Pass**: `admin123`

3. **Access Dashboard**:
Navigate to `admin.php` and sign in to access the Control Center.

---

## 📂 File Structure

| File | Description |
| :--- | :--- |
| `db_connect.php` | Global database connection and table prefix settings. |
| `db_setup.php` | Auto-installer script to prepare the database. |
| `admin.php` | Secure login gateway and main dashboard interface. |
| `dashboard.php` | The core analytics and configuration module. |
| `logout.php` | Clears sessions and securely ends the admin visit. |
| `header.php` | Contains M3 CSS, Google Fonts, and Navigation. |
| `footer.php` | Page closing tags and layout scripts. |

---

## 🔒 Security Best Practices

* **Delete Setup File**: Once your database is ready, it is recommended to delete or rename `db_setup.php` to prevent unauthorized resets.
* **SSL**: Ensure your site runs on HTTPS to protect the session cookies.
* **Password Change**: Update the default password immediately via the database or by modifying the hash in `db_setup.php`.

---

## 📝 Author
**Salim Nazir / JA Square** *Project Version: 1.2.0 (2026)*