AdBlock Usergroup Swap & Tracker v3.1.2

• NEW: CLI command to clear tracker data by scope (guests, users, all) with batch-size control
• ADD: Updated Admin “Clear log” overlay to include a CLI usage note
• ADD: Completion notice on the tracker page shows what scope was cleared and how many records were cleared
• FIX: Admin clear-log job redirect to return to the tracker page instead of ACP home
• FIX: Added stale guest auto-pruning to the existing hourly XenForo cron, using the guest age option

Code:

php cmd.php wutime-adblock-tracker:clear-data --help

• Fix: Admin homepage statistics load efficient preparsed stats_daily data (thanks @duderuud).
• New: Expanded Charts filtering with preset windows plus custom start/end date pickers and a one-click Reset flow.
• New: Data availability notices added to Charts, including tracker-data start date and device-data status/date context.
• New: Hero analytics redesigned with dual donut charts for AdBlock hit % and AdBlocking users %.
• New: Layout overhaul for chart hero area with improved desktop balance and clean mobile stacking behavior.

• OPTIMIZATION: Admin charting UI has been redesigned with a cleaner layout and improved across desktop/mobile
• ADD: New admin homepage block: Adblock statistics past 30 days with trend chart + two summary pie charts with quick link buttons
• ADD: New advanced chart views for adblock analysis (daily adblock %, adblock vs clear volume, by device type, by operating system, top OS/browser adblock share)
• FIX: Admin route links normalized to /index so ACP URLs no longer render with trailing //
• FIX: Responsive log table improvements: tablet hides Last Status, Previous Status, Last Detect; mobile keeps only first 5 columns

• UPDATE: Crawler Detection from (v1.3.6 => v1.3.7)

• ADD: Crawler detection performance improvement
• UPDATE: Crawler Detection from (v1.3.5 => v1.3.6)

• Fix: Downgrade MobileDetect to be compliant wtih XF PSR (kept custom caching)
• Fix: Tested with PHP 8.4.11

• Fix: Replace UTF8MB4 emojis from option descriptions and replace with HTML Entities so customers running old collations have zero install issues

• Add: Detection for uBlock Origin Lite
• Add: Remote Loading Detection (RLD) improvement
  • Note: RLD is required to detect newer v3 Chrome extensions such as "uBlock Origin Lite"
• Fix: ErrorException: Fatal Error: Declaration of Detection\Cache\CacheItem::expiresAt($expiration) (thanks @ratix_gunz)
• Fix: Adaptive CacheItem so it’s compatible regardless of which PSR version another add-on (or a global vendor) introduced (thanks @ratix_gunz)
• Fix: Administration option tabs are now responsive on small screens
• Fix: Remove checkbox option that was accidentally appearing in PWA options

• FIX: Front-end member display page was showing XF phrase key instead of the actual phrase for Device Type
  • Resulted in broken display and/or column shifting
• PHP 8.0+ is now required (massive improvements for speed/efficiency)
  • Upgrades mobile detection from v3.7.4 to v4.8.09
  • 4.8.x is the primary branch, receiving frequent updates for new devices and security fixes, unlike 3.74.x
  • Adds optimized regex patterns and caching capabilities to reduce server load for high-traffic forums
  • Vastly more accurate device/os_type definitions
  • Substantially improves device/os_type look up speed and efficiency (improved regex matching with PHP 8.1)+
• Ensures full support for PHP 8.0 to 8.4

Running PHP < 8.0 is possible but not recommended. If you need help downgrading this version to work with PHP 7.x please inquire.

Feature recap from v2.x

• NEW + OPTIMIZATION: Option "Cache JavaScript TTL (minutes)" is now working (default=15m) (large performance boost)
• NEW + OPTIMIZATION: Ajax Routes now use XF.config to allow caching the entire JavaScript (also supports full page caching for user's as well as guests)
• NEW + OPTIMIZATION: Option "Enable Mobile + Browser Detection Cache" (on by default)
• NEW + OPTIMIZATION: Dynamically remove detection methods from JavaScript detection scripts when disabled
• NEW: Punish AdBlock Extension Togglers - Replaces previous "Should a single AdBlock detection reset current non-detects back to zero?", now allows you to set the number of detections that should reset non-detections to zero (default=2)
• NEW: Automatically [Reset and Delete] Users with >= X Swaps (Monthly Cron)
• NEW: Logging options tab - logging options and actions for the user change log
• NEW: Added 1-hour cache to save expensive calculations on successive duplicate user-agent requests
• OPTIMIZATION: Number of random bait classes are now also randomized by amount
• OPTIMIZATION: Overhauled Ajax Routes to prevent tampering
• OPTIMIZATION: Properly restyle user alerts
• OPTIMIZATION: Avoid detection skips in tools like AdGuard that might ignore fully off-screen elements.
• OPTIMIZATION: Displays updated with more thoughtful instructions and descriptions
• OPTIMIZATION: Lightly revised AdBlock Tracker Log to be a touch less cluttered
• UPDATE: Crawler Detection updated from v1.3.4 to v1.3.5
• UPDATE: Minification updated from v1.3.73 to v1.3.75
• FIX: Added proper validation to ensure enough detection methods are selected on options save
• FIX: Bust JavaScript cache on options save so JavaScript reflects settings
• FIX: Disallow negative settings for "Flood check on clear status"
• FIX: Make number boxes properly stepped in increments of 5 or 15 where applicable
• FIX: Delete xf_wutime_adblock_tracker_javascript DB table (no longer in use)
• FIX: Error delete_entities case, removed the $tracker->save() call after $tracker->delete() (entity is already deleted and saving is not needed)
• FIX: Drop no longer used database table xf_wutime_adblock_tracker_javascript on upgrade()
• FIX: EasyList now contains full class selectors, we need to ignore them when collecting Bait (creates a bad element and breaks the javascript detection resulting in false clear!)
• FIX: UglifyJS() added to build.json to provide updated min.js on compile to replace EOL XenForo compiler
• OPTIMIZATION: AdBlock Tracker Log now remembers display settings and persists them between sessions
• ADD: AdBlock Tracker Log, add historical adblocking % vs recent last 100 page views %
• FIX: AdBlock Tracker Log "Results" dropdown works and is remembered
• FIX: AdBlock Tracker Log filtering tools would disappear if no results found
• FIX: ClearLogUsers() and ClearLog() from AdBlock Tracker Logs now a Job that properly runs a routine to delete all entities and restore user accounts (remove AdBlock group)
• FIX: Uninstall runs job to delete entities safely prior to dropping database tables
• INSTALL: Updates cache_js to 15 minutes on upgrade() for all customers
• INSTALL: Drops xf_wutime_adblock_tracker_javascript db table on upgrade() for all customers
• FIX: Swap multipilier can be set to 0 to disable, and allows steps of 0.25
• FIX: Daily device stats have been stored every day ever since you enabled device history, but were not displaying
• Daily device stats are now properly keyed and can be reviewed: admin.php?stats/
• OPTIMIZATION: AdBlock Tracker Log now remembers display settings and persists them between sessions
• ADD: AdBlock Tracker Log, add historical adblocking % vs recent last 100 page views %
• FIX: AdBlock Tracker Log "Results" dropdown works and is remembered
• FIX: AdBlock Tracker Log filtering tools would disappear if no results found
• FIX: ClearLogUsers() and ClearLog() from AdBlock Tracker Logs now a Job that properly runs a routine to delete all entities and restore user accounts (remove AdBlock group)
• FIX: Uninstall runs job to delete entities safely prior to dropping database tables