v 1.7.0

docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md

@@ -1,6 +1,7 @@
 # Plugin Update Workflow
 
-**Last Updated:** January 9, 2026  
+**Last Updated:** January 10, 2026  
+**Version:** 1.7.0  
 **Status:** Production  
 **Scope:** How to release plugin updates and what happens automatically vs manually
 
@@ -10,7 +11,7 @@
 
 The plugin release process has been **simplified** to require only 3 fields:
 
-1. **Version** (e.g., 1.2.0)
+1. **Version** (e.g., 1.3.3)
 2. **Changelog** (what's new)
 3. **Status** (draft → released)
 
@@ -26,6 +27,27 @@ Django Admin → Add Plugin Version → Enter 3 fields → Save → Change statu
 
 ---
 
+## Recent Release History (v1.7.0)
+
+### WordPress Plugin Progression
+
+| Version | Date | Type | Key Changes |
+|---------|------|------|-------------|
+| 1.3.3 | Jan 10, 2026 | Patch | Template design: Square image grid fixes, landscape image positioning, direct border-radius/shadow on images without captions |
+| 1.3.2 | Jan 9, 2026 | Patch | Template fixes in app and plugin, image layout improvements |
+| 1.3.1 | Jan 9, 2026 | Patch | WordPress plugin versioning updates |
+| 1.3.0 | Jan 8, 2026 | Minor | Initial distribution system release, automated updates |
+
+### Distribution System Status
+
+- ✅ Automated ZIP generation: Operational
+- ✅ Checksum calculation: MD5 + SHA256
+- ✅ WordPress auto-update: Active
+- ✅ Health checks: Implemented
+- ✅ Installation tracking: Complete
+
+---
+
 ## Table of Contents
 
 1. [Update Workflow Overview](#1-update-workflow-overview)
@@ -36,6 +58,7 @@ Django Admin → Add Plugin Version → Enter 3 fields → Save → Change statu
 6. [Version Numbering](#6-version-numbering)
 7. [Rollback Procedure](#7-rollback-procedure)
 8. [Emergency Updates](#8-emergency-updates)
+9. [Recent Updates & Lessons Learned](#9-recent-updates--lessons-learned)
 
 ---
 
@@ -541,6 +564,78 @@ curl https://api.igny8.com/api/plugins/igny8-wp-bridge/check-update/?current_ver
 
 ---
 
+## 9. Recent Updates & Lessons Learned
+
+### v1.3.3 Release (Jan 10, 2026)
+
+**Changes:**
+- Fixed square image grid layout (side-by-side display)
+- Fixed landscape image positioning in sections 4+
+- Removed card wrapper for images without captions
+- Applied border-radius/shadow directly to images
+- Landscape images now appear after first paragraph
+
+**Process:**
+- Source code updated in plugin templates and CSS
+- Version bumped in `igny8-bridge.php` (header + constant)
+- Django admin: Created v1.3.3 with changelog
+- Status changed to "released" → ZIP auto-generated
+- Verified download endpoint and file contents
+- Template changes tested on staging WordPress site
+
+**Lessons:**
+- CSS changes require thorough cross-browser testing
+- Image layout fixes need responsive design verification
+- Template changes should be tested with multiple content types
+
+### v1.3.2 Release (Jan 9, 2026)
+
+**Changes:**
+- Template rendering improvements
+- Image layout enhancements
+- Content section fixes
+
+**Process:**
+- Standard release workflow
+- Auto-build successful
+- No rollback needed
+
+### v1.3.0 Release (Jan 8, 2026)
+
+**Changes:**
+- Initial distribution system implementation
+- WordPress auto-update mechanism
+- Base template system
+
+**Process:**
+- Major release with new infrastructure
+- Extensive testing required
+- First use of automated packaging
+
+### Distribution System Milestones
+
+**v1.7.0 Infrastructure:**
+- ✅ Complete plugin distribution system
+- ✅ Multi-platform support architecture
+- ✅ Automated versioning and packaging
+- ✅ Security features (checksums, signed URLs)
+- ✅ Monitoring and analytics
+
+**Best Practices Established:**
+1. Always test download endpoint after release
+2. Verify ZIP contents match source
+3. Check version number in extracted files
+4. Test update notification in WordPress
+5. Monitor download analytics
+
+**Common Issues Resolved:**
+- ZIP generation timing → Now synchronous in signals
+- Checksum mismatches → Auto-calculated reliably
+- Version comparison → Semantic versioning logic fixed
+- File size tracking → Automatic and accurate
+
+---
+
 ## Quick Reference Card
 
 ### Release New Version (Simplified)
@@ -550,7 +645,7 @@ curl https://api.igny8.com/api/plugins/igny8-wp-bridge/check-update/?current_ver
 2. Update version in igny8-bridge.php (header + constant)
 3. Django Admin → Add Plugin Version:
    - Plugin: IGNY8 WordPress Bridge
-   - Version: 1.2.0
+   - Version: 1.3.3 (or next version)
    - Changelog: Describe changes
    - Status: draft
    - (All other fields auto-fill)