v3.16.1: Custom GTM Server Domain with Health Checks

🏥 Custom GTM Server Domain with Health Checks

This release introduces Custom GTM Server Domain with Health Checks, enabling first-party server-side GTM tracking with automatic health monitoring and intelligent fallback capabilities.

✨ New Features

Custom Server Support

• Configure Custom Domains: Set up first-party GTM server domains for enhanced privacy and control
• Automatic Health Monitoring: Periodic health checks (every 6-12 hours) validate server availability
• Intelligent Fallback: Automatically switches to Google's default GTM endpoints if custom server fails
• Auto-Recovery: Returns to custom server after 3 consecutive successful health checks

Real-time Monitoring

• Status Dashboard: Admin UI shows server status, health check results, and next check time
• Manual Health Checks: On-demand health check button for immediate validation
• Background Monitoring: Frontend health checks (throttled to 1 per hour) for proactive monitoring
• Admin Notifications: Automatic notices when server status changes (recovery/failure)

Developer Features

• LocalNet Development Support: Automatic SSL verification bypass for .localnet domains
• Debug Data Attributes: Frontend GTM scripts include data-cuft-gtm-source and data-cuft-gtm-server
• Cron Job Automation: Scheduled health checks via WordPress Cron system
• AJAX API: New endpoints for server configuration, health checks, and status retrieval

🔧 Technical Details

• Health Check Timeout: 5-second timeout for endpoint validation
• Consecutive Counter Logic: 3 successes to activate custom, 1 failure to fallback
• Endpoints Tested: Both gtm.js and ns.html validated for each check
• Response Validation: Checks HTTP 200 status and content validity
• No Database Migrations: Uses existing WordPress infrastructure (wp_options)

📦 Installation

1. From WordPress Admin:

   • Navigate to Plugins → Add New
   • Upload choice-uft-v3.16.1.zip
   • Activate the plugin

2. Manual Installation:

   • Download choice-uft-v3.16.1.zip
   • Extract to /wp-content/plugins/choice-uft/
   • Activate via WordPress admin

3. Auto-Update (if you have v3.16.0+):

   • Go to Dashboard → Updates
   • Click "Update Now" next to Choice Universal Form Tracker

⚙️ Configuration

1. Navigate to Settings → Universal Form Tracker
2. Find the Server-side GTM section
3. Check "Enable Custom GTM Server"
4. Enter your custom server URL (e.g., https://gtm.yourdomain.com)
5. Click Test Server to validate
6. Click Save Changes

🧪 Testing

The admin dashboard displays:

• ✅ Active server status (Custom/Fallback)
• 📅 Last check time and result
• 🔄 Consecutive success/failure counters
• ⏰ Next scheduled check time
• 🔘 Manual "Run Health Check Now" button

📋 What's Changed

Full Changelog: v3.16.0...v3.16.1

Files Changed: 17 files (+3,362 / -40 lines)

🔗 Resources

• Documentation: See README.md for full feature documentation
• Support: https://github.com/ChoiceOMG/choice-uft/issues
• Changelog: See CHANGELOG.md for detailed release notes

---

Note: WordPress ZIP Naming Convention

• ZIP Filename: choice-uft-v3.16.1.zip (includes version)
• Folder Inside: choice-uft/ (no version - required for WordPress auto-updater)