╔══════════════════════════════════════════════════════════════════════╗ ║ BaseCloud UTM Tracker ║ ║ 🚀 Quick Deployment Reference Card ║ ╚══════════════════════════════════════════════════════════════════════╝ ┌──────────────────────────────────────────────────────────────────────┐ │ ✅ CURRENT STATUS (February 12, 2026) │ ├──────────────────────────────────────────────────────────────────────┤ │ Plugin Version: 3.0.1 │ │ Stable Tag: 3.0.1 │ │ Package Version: 3.0.1 │ │ SVN Tags: 2 tags (1.1.0, 3.0.1) │ │ Available Slots: 3 more tags │ │ Status: 🟢 READY FOR DEPLOYMENT │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ 🚀 DEPLOY NEW VERSION (3 Commands) │ ├──────────────────────────────────────────────────────────────────────┤ │ │ │ Bug Fixes / Small Updates (3.0.1 → 3.0.2) │ │ ➜ .\deploy.ps1 patch │ │ │ │ New Features (3.0.1 → 3.1.0) │ │ ➜ .\deploy.ps1 minor │ │ │ │ Major Changes (3.0.1 → 4.0.0) │ │ ➜ .\deploy.ps1 major │ │ │ │ Specific Version (3.0.1 → 3.0.5) │ │ ➜ .\deploy.ps1 3.0.5 │ │ │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ 📝 WHAT HAPPENS WHEN YOU DEPLOY │ ├──────────────────────────────────────────────────────────────────────┤ │ 1. ✓ Updates version in basecloud-utm-tracker.php │ │ 2. ✓ Updates stable tag in readme.txt │ │ 3. ✓ Creates changelog entry template │ │ 4. ⏸ PAUSES - Edit changelog with your changes │ │ 5. ✓ Commits all changes to Git │ │ 6. ✓ Creates version tag (e.g., v3.0.2) │ │ 7. ✓ Pushes to GitHub │ │ 8. 🤖 GitHub Actions deploys to WordPress.org │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ ✅ FIXES COMPLETED TODAY │ ├──────────────────────────────────────────────────────────────────────┤ │ ✓ Removed old SVN tags (5→2, freed 3 slots) │ │ ✓ Synchronized all version numbers to 3.0.1 │ │ ✓ Fixed CHANGELOG.md date formatting │ │ ✓ Secured GitHub workflow (removed hard-coded credentials) │ │ ✓ Created comprehensive deployment documentation │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ 📋 BEFORE NEXT DEPLOYMENT - CHECKLIST │ ├──────────────────────────────────────────────────────────────────────┤ │ □ Make code changes │ │ □ Test thoroughly in local environment │ │ □ Prepare changelog notes │ │ □ Run deployment script │ │ □ Edit changelog when prompted │ │ □ Monitor GitHub Actions │ │ □ Verify on WordPress.org │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ 🔍 QUICK VERIFICATION COMMANDS │ ├──────────────────────────────────────────────────────────────────────┤ │ Check current version: │ │ php -r "require 'version-helper.php'; echo │ │ basecloud_utm_get_plugin_version();" │ │ │ │ View Git status: │ │ git status │ │ │ │ List available tags: │ │ git tag -l │ │ │ │ Check SVN tags: │ │ dir svn-repo\tags │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ 📚 DOCUMENTATION FILES │ ├──────────────────────────────────────────────────────────────────────┤ │ DEPLOYMENT_GUIDE.md → Complete deployment instructions │ │ FIXES_SUMMARY.md → All fixes applied today │ │ DEPLOYMENT.md → Original deployment guide │ │ CHANGELOG.md → Full version history │ │ README.md → Plugin information │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ ⚠️ IMPORTANT REMINDERS │ ├──────────────────────────────────────────────────────────────────────┤ │ • Update BOTH readme.txt AND CHANGELOG.md │ │ • Use date format: YYYY-MM-DD (e.g., 2026-02-12) │ │ • You have 3 tag slots left before cleanup needed │ │ • GitHub secrets must be set: WP_ORG_USERNAME, WP_ORG_PASSWORD │ │ • Deployment triggers on git tag push (automatic) │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ 🌐 USEFUL LINKS │ ├──────────────────────────────────────────────────────────────────────┤ │ GitHub Repo: │ │ https://github.com/BaseCloudGlobal/BaseCloudUTMTracker │ │ │ │ GitHub Actions: │ │ https://github.com/BaseCloudGlobal/BaseCloudUTMTracker/actions │ │ │ │ WordPress.org Plugin: │ │ https://wordpress.org/plugins/basecloud-utm-tracker/ │ │ │ │ Readme Validator: │ │ https://wordpress.org/plugins/developers/readme-validator/ │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────┐ │ 🆘 TROUBLESHOOTING │ ├──────────────────────────────────────────────────────────────────────┤ │ "Version not found" → Check plugin file header format │ │ "Git push failed" → Verify GitHub authentication │ │ "Workflow failed" → Check GitHub secrets configuration │ │ "WP.org deploy failed" → Validate readme.txt format │ │ │ │ See DEPLOYMENT_GUIDE.md for detailed troubleshooting │ └──────────────────────────────────────────────────────────────────────┘ ╔══════════════════════════════════════════════════════════════════════╗ ║ 🎯 DEPLOYMENT SYSTEM STATUS: 🟢 FULLY OPERATIONAL ║ ║ ║ ║ All issues resolved. Ready for deployment! ║ ║ ║ ║ Last Updated: February 12, 2026 ║ ╚══════════════════════════════════════════════════════════════════════╝