# Support

Bot Blocker is developed and maintained by [Botcrawl](https://botcrawl.com/).

## Getting Help

- **Documentation and FAQ:** See the readme.txt included with the plugin, or visit [botcrawl.com](https://botcrawl.com/).
- **Bug reports and feature requests:** Please open an issue or contact support via [botcrawl.com](https://botcrawl.com/).

## Before Reporting a Bug

1. Ensure you are running the latest version of the plugin.
2. Check that your WordPress installation meets the minimum requirements: WordPress 6.0+ and PHP 7.4+.
3. Deactivate other plugins temporarily to rule out conflicts.
4. Check the Logs page in Bot Blocker to see if the issue is reflected in the event log.
5. If geolocation data is missing from the map, note that geolocation is asynchronous and events may appear unmapped for a short period while the background job runs.

## Common Issues

| Symptom | Likely Cause | Resolution |
|---|---|---|
| Map shows no points | Geolocation disabled or WP-Cron not running | Enable geolocation in Settings; ensure WP-Cron is active |
| Real visitors being blocked | Allow-list not configured | Add your IP or user agent to the Allow lists |
| Logs not growing | Logging disabled | Enable logging in Settings |
| High Unmapped count | Geo lookup pending or failed | Normal for first few minutes; check ipwho.is availability |
| Cloudflare IPs in logs | Trusted proxy not configured | Add Cloudflare IP ranges to Trusted proxy IPs in Settings |
