Description
The Festival ID Tracker plugin provides secure, in-dashboard analytics for websites using unique identifiers in their URLs (e.g., NFC tags, QR codes, or campaign links). It logs and analyzes visits with a ?id=XXXXXX pattern and offers optional automatic redirection while maintaining comprehensive statistics.
Version 1.5.0 introduces enhanced security features including rate limiting, bot detection, and WordPress compliance improvements for a more robust and secure tracking experience.
Key Features
Tracking & Analytics:
* Tracks ?id=XXXXXX query parameters (6-character alphanumeric)
* Secure database logging with proper indexing
* Privacy-focused with daily-rotating user hashes
* Real-time statistics display
Security Features (New in 1.5.0):
* Rate limiting (10 requests/minute per IP)
* Automatic bot detection and filtering
* Nonce verification for all admin operations
* SQL injection protection with prepared statements
* XSS prevention with proper output escaping
Dashboard Widgets:
* Daily Statistics: 7-day rolling view with navigation
– Total calls per day
– Unique festival IDs per day
– Historical data browsing
* Global Statistics: All-time performance metrics
– Total accesses per ID
– Active days per ID
– Top 5/Show All toggle
Redirect Functionality:
* Optional automatic redirection
* ID parameter preservation in redirects
* Works with any internal or external URL
* Simple enable/disable toggle
Administration:
* Comprehensive settings page under Settings > Festival ID Tracker
* Quick statistics overview
* Testing tools and instructions
* Direct settings access from plugins page
Perfect For
- Events & Festivals: Track NFC wristbands, badges, or tags
- QR Code Campaigns: Monitor scan rates and engagement
- Marketing Campaigns: Track campaign-specific URLs
- Multi-Venue Events: Analyze venue popularity
- Tourism & Hospitality: Monitor information point usage
- Retail Promotions: Track in-store engagement
Privacy & Compliance
- No personally identifiable information stored
- Daily-rotating hashes for user identification
- GDPR-ready design
- Compliant with WordPress coding standards
Additional Information
Requirements
- WordPress 5.0 or higher
- PHP 7.4 or higher
- MySQL 5.6 or higher
Support
For support, feature requests, or bug reports, please visit:
GitHub Issues
Contributing
We welcome contributions! Visit our GitHub repository to contribute.
Privacy Policy
This plugin:
* Stores hashed visitor data (IP + User Agent + Daily Salt)
* Does not store personally identifiable information
* Does not make external API calls
* Does not set cookies
* All data is stored locally in your WordPress database
For GDPR compliance, please mention the tracking functionality in your site’s privacy policy.
Screenshots
Festival ID Daily Statistics widget showing 7-day view 
Festival ID Global Statistics widget with top performers 
Settings page with redirect configuration
Installation
Automatic Installation (Recommended)
- Go to Plugins > Add New in your WordPress admin
- Search for “Festival ID Tracker”
- Click “Install Now” and then “Activate”
- Configure settings under Settings > Festival ID Tracker
Manual Installation
- Download the plugin ZIP file
- Upload the
festival-id-trackerfolder to/wp-content/plugins/ - Activate through the ‘Plugins’ menu in WordPress
- Configure under Settings > Festival ID Tracker
Configuration
- Navigate to Settings > Festival ID Tracker
- (Optional) Enable redirect functionality
- (Optional) Enter destination URL for redirects
- Save Settings
- Test with
yoursite.com?id=TEST01
FAQ
-
How do I view statistics?
-
Statistics are displayed in three locations:
1. Dashboard Widgets: Two widgets on your main dashboard
2. Settings Page: Current statistics section
3. Daily/Global Views: Detailed breakdowns in widgets -
What does each statistic mean?
-
- Total Calls Tracked: All-time visits with any festival ID
- Unique Festival IDs: Count of different IDs used
- Calls Today: Today’s visits with any ID
- Total Accesses: Times a specific ID was used
- Unique Days Used: Different days an ID was active
-
How does the redirect work?
-
When enabled, visitors accessing
yoursite.com?id=ABC123are automatically redirected to your configured URL with the ID preserved:destination.com?id=ABC123 -
Can I disable tracking for bots?
-
Yes! Version 1.5.0 automatically detects and filters out bot traffic from your statistics.
-
Is there a rate limit?
-
Yes, the plugin limits each IP address to 10 requests per minute to prevent abuse.
-
Can I export the data?
-
Currently, data export must be done via database tools. A future version may include built-in export functionality.
-
Is this plugin GDPR compliant?
-
The plugin is designed with privacy in mind:
– Uses daily-rotating hashes instead of storing raw user data
– No personally identifiable information is stored long-term
– You should still mention tracking in your privacy policy -
What happens to my data if I deactivate the plugin?
-
Data is preserved when you deactivate the plugin. To completely remove data, you must manually delete the
wp_festidtrack_logtable from your database. -
Can I customize the ID format?
-
Currently, the plugin tracks exactly 6-character alphanumeric IDs. Custom formats may be added in future versions.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Festival ID Tracker” is open source software. The following people have contributed to this plugin.
Contributors
“Festival ID Tracker” has been translated into 2 locales. Thank you to the translators for their contributions.
Translate “Festival ID Tracker” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.5.0 (2024)
- Security: Added comprehensive security improvements
- Rate limiting (10 requests/minute per IP)
- Bot detection and filtering
- Nonce verification for all admin operationsq
- Enhanced input sanitization
- Compliance: Changed prefix to
festidtrack_for WordPress standards - Performance: Improved SQL queries and caching
- Fixes: Resolved statistics display issues
- Code: Complete refactoring following WordPress coding standards
1.4.0
- Added redirect functionality with optional URL configuration
- New comprehensive settings page under Settings > Festival ID Tracker
- Enhanced settings with testing instructions
- Added enable/disable toggle for redirects
- Settings link in plugins page for quick access
1.3.0
- Dashboard widgets for daily and global statistics
- 7-day rolling navigation for historical data
- Top 5 / Show All toggle for global statistics
- Enhanced database logging with improved indexing
1.2.0
- ID preservation in redirect URLs
- Improved redirect handling
1.1.0
- Basic tracking functionality
- Database logging implementation
1.0.0
- Initial release