๐ก๏ธ PS Bot Defender (PrestaShop 8.2.x)
๐ Overview
PS Bot Defender protects your PrestaShop store from unwanted bots, scrapers, and automated abuse by integrating Cloudflare Turnstile directly into your shop.
Instead of relying on outdated CAPTCHA systems, this module uses modern, frictionless verification to:
- challenge suspicious visitors
- allow real customers through
- log and monitor activity
- automatically clean up historical data
Designed for performance, simplicity, and real-world usability, this module is ideal for store owners who want strong protection without impacting legitimate traffic.
๐ Key Features
๐ค Smart Bot Detection & Protection
- Detects suspicious visitors using configurable scoring
- Integrates with Cloudflare Turnstile for modern verification
- Blocks failed challenges automatically
- Optional testing mode for safe setup
๐งช Flexible Testing Modes
- Off โ No protection applied
- Force Challenge โ Challenge all visitors (testing)
- Force Challenge (No Cookie) โ Advanced debugging mode
๐ Detailed Event Logging
Track everything happening on your site:
- Visitor IP address
- User agent
- Reverse DNS (if enabled)
- Detection method
- Challenge result (passed / failed / blocked)
- Timestamp
๐ Clean & Organized Logs (NEW)
- Logs and blocked IPs are now paginated (10 per page)
- Clean UI separation between:
- Event logs
- Blocked IPs / failed challenges
- Export logs to CSV for analysis
๐งน Automated Log Cleanup System (NEW)
Keep your database optimized automatically:
- Set retention period (e.g. 30 days)
- Manual cleanup button
- Automatic cleanup runs weekly (first visit after Sunday midnight)
Includes full visibility:
- Last cleanup time (server + shop time)
- Number of entries deleted
- Clear UI messaging
๐ Blocked IP Management (Enhanced)
- View blocked IPs with expiration tracking
- Manually remove or clear expired entries
- Cleanup tied to block duration setting
- Export blocked IPs to CSV
๐ Multi-Language Support (NEW)
Fully translatable and includes:
- English
- French
- Spanish
- German
- Italian
- Dutch
All:
- UI elements
- log reasons
- configuration text
are fully translatable
โ๏ธ Easy Configuration
Simple setup with:
- Cloudflare Site Key & Secret Key
- Challenge score threshold
- Cookie duration
- Block duration
- Log retention settings
Includes recommended values directly in the interface.
๐ง Built for Performance
- No cron required
- Lightweight database usage
- Cleanup runs only when needed
- Designed for high-traffic stores
๐งพ Setup Guide Included
Step-by-step instructions built directly into the module:
- Create Turnstile widget
- Configure hostnames correctly
- Avoid common Cloudflare errors
- Copy/paste keys into PrestaShop
โ
Compatibility
- PrestaShop 8.2.x
- Classic theme and most standard themes
- No core overrides required
๐ก Use Cases
- Block scraping bots
- Prevent fake traffic
- Protect forms and site access
- Reduce server load from automated abuse
- Improve data quality in analytics
๐ Important Notes
- Uses Cloudflare Turnstile (free with Cloudflare account)
- Designed to minimize impact on real users
- Recommended to test using Test Mode before enabling full protection
๐ Changelog
v1.5.4 (Current)
- Added pagination to Event Logs and Blocked IPs (10 per page)
- Added recommended value guidance to key settings
- Added cleanup summary to Blocked IPs section
- Improved UI consistency across Logs tab
- Improved wording for first-time cleanup display (โNot yet runโ)
- Fully synchronized translation system across all supported languages
v1.5.3
- Improved cleanup messaging display
- Added clearer handling for first-time cleanup state
v1.5.2
- UI improvements for cleanup controls
- Moved cleanup controls to Logs tab
- Improved user guidance for cleanup settings
v1.5.1
- Added automatic weekly event log cleanup
- Added manual cleanup button
- Added cleanup tracking (timestamp + entries deleted)
v1.5.0
- Initial event log cleanup system introduced
- Added retention settings
v1.4.x
- Improved translation system
- Fixed translation mapping for log reasons
- Ensured all log messages are translatable
- Added multi-language support foundation
v1.3.x and earlier
- Initial release
- Cloudflare Turnstile integration
- Bot detection system
- Logging and blocking framework