From 60f981cafdce4771a5ad000a8070963da6a793a9 Mon Sep 17 00:00:00 2001 From: "IGNY8 VPS (Salman)" Date: Sat, 10 Jan 2026 08:47:36 +0000 Subject: [PATCH] v 1.7.0 --- CHANGELOG.md | 210 ++++++++++++++- .../WORDPRESS-INTEGRATION-FLOW.md | 239 ++++++++++++++++-- docs/60-PLUGINS/INDEX.md | 113 ++++++++- docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md | 101 +++++++- docs/60-PLUGINS/WORDPRESS-INTEGRATION.md | 126 ++++++++- docs/INDEX.md | 4 +- frontend/package.json | 2 +- 7 files changed, 747 insertions(+), 48 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 613524b3..b80d75f0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,7 +1,7 @@ # IGNY8 Change Log -**Current Version:** 1.6.2 -**Last Updated:** January 8, 2026 +**Current Version:** 1.7.0 +**Last Updated:** January 10, 2026 --- @@ -9,6 +9,7 @@ | Version | Date | Summary | |---------|------|---------| +| 1.7.0 | Jan 10, 2026 | **Major** - Pre-Launch Cleanup Complete (Phases 1, 5, 6): Code cleanup, UX improvements, data backup tools; WordPress plugin distribution system; Template design improvements; AI model fixes | | 1.6.2 | Jan 8, 2026 | **Design Refinements** - Updated marketing site gradients to brand colors (primary + success), reduced shadow weights, simplified automation icons, added Upcoming Features page | | 1.6.1 | Jan 8, 2026 | **Email System** - SMTP configuration, email templates, password reset flow, email verification, unsubscribe functionality | | 1.6.0 | Jan 8, 2026 | **Major** - Payment System Refactor Complete: Stripe, PayPal, Bank Transfer flows finalized; Simplified signup (no payment redirect); Country-based payment rules; Webhook security; PDF invoices | @@ -39,6 +40,211 @@ --- +## v1.7.0 - January 10, 2026 + +### Pre-Launch Cleanup & Plugin Distribution System + +This major release completes critical pre-launch phases (1, 5, 6) with comprehensive code cleanup, UX improvements, and data management tools. It also introduces the WordPress plugin distribution infrastructure and improves template rendering. + +--- + +### 🧹 Phase 1: Code Cleanup & Technical Debt - COMPLETE βœ… + +**Code Quality Improvements:** +- Removed 3,218 lines of legacy code +- Deleted 24 files and cleaned up 11 empty directories +- Removed 17 console.log/debug statements: + - UserProfile components (UserMetaCard, UserAddressCard, UserInfoCard) + - Automation/ConfigModal + - ImageQueueModal (8 statements) + - ImageGenerationCard (7 statements) +- Applied ESLint auto-fixes (9 errors fixed) +- All TypeScript strict mode checks passing + +**Removed Test Files:** +- `test-module-settings.html` (manual API test) +- `test_urls.py` (one-time URL verification) +- `test_stage1_refactor.py` (stage 1 verification) + +**Deleted Unused Components:** +- ecommerce/ template components (7 files) +- sample-components/ (2 HTML files) +- charts/bar/ and charts/line/ +- tables/BasicTables/ +- CurrentProcessingCard.old.tsx + +**Production Status:** +- βœ… Build time: ~9 seconds +- βœ… All tests passing +- βœ… ESLint compliance +- βœ… TypeScript strict mode +- βœ… Production-ready codebase + +--- + +### 🎨 Phase 5: UX Improvements - COMPLETE βœ… + +**Enhanced Search Modal:** +- Added search filters: All, Workflow, Setup, Account, Help +- Implemented recent searches (localStorage, max 5) +- Added category display in results +- Improved result filtering by type and category +- Deep linking to help sections with auto-expand accordions + +**Smart Search Features:** +- Intelligent phrase matching (strips filler words: how, to, what, is) +- Basic stemming support (tasks β†’ task) +- Duplicate prevention using Set +- Enhanced matching logic: + - Direct keyword match + - Normalized term match + - Question text match + +**Comprehensive Keyword Coverage:** +Added 10+ keyword categories: +- task, cluster, billing, invoice, payment +- plan, usage, schedule, wordpress +- writing, picture, user, ai + +**Help System:** +- Added 25+ help questions across 8 topics +- Context snippets and highlighting +- Suggested questions +- Fixed duplicate keywords in navigation + +--- + +### πŸ’Ύ Phase 6: Data Backup & Cleanup Tools - COMPLETE βœ… + +**New Django Management Commands:** + +1. **export_system_config** + - Exports system configuration to JSON + - Includes: Plans, Credit Costs, AI Models, Industries, Sectors, etc. + - Metadata with export timestamp and stats + - Usage: `python manage.py export_system_config --output-dir=backups/config` + +2. **cleanup_user_data** + - Safely deletes all user-generated data + - DRY-RUN mode to preview deletions + - Confirmation prompt for safety + - Production environment protection + - Deletes: Sites, Keywords, Content, Images, Transactions, Logs + - Preserves: System config and user accounts + - Usage: `python manage.py cleanup_user_data --dry-run` + - Usage: `python manage.py cleanup_user_data --confirm` + +**Documentation:** +- Comprehensive 300+ line backup and cleanup guide +- Atomic transactions and safety features +- Ready for V1.0 production database preparation + +--- + +### πŸ”Œ WordPress Plugin Distribution System + +**Infrastructure Setup:** +- Full plugin distribution system implemented +- Directory structure: `/plugins/{platform}/source/` and `/dist/` +- Database models: Plugin, PluginVersion, PluginInstallation, PluginDownload +- API endpoints for download, check-update, register, health-check +- WordPress auto-update mechanism via `pre_set_site_transient_update_plugins` hook +- Build scripts for ZIP generation with versioning +- Security: signed URLs, checksums (MD5/SHA256), rate limiting +- Monitoring and analytics dashboard widgets + +**Plugin Versioning:** +- Semantic versioning system +- Automated packaging and distribution +- Update check mechanism +- Health check endpoints +- Installation tracking + +**Platform Ready:** +- WordPress: Production ready +- Shopify: Infrastructure ready +- Custom sites: Infrastructure ready + +--- + +### πŸ€– AI & Backend Improvements + +**AI Model Fixes:** +- Fixed AI and image-related models in backend +- Improved image generation reliability +- Better error handling for AI tasks +- Enhanced prompt handling +- Improved aspect ratio detection + +**Template Rendering:** +- Template design improvements +- Better content section handling +- Image layout enhancements +- Improved prose styling + +--- + +### πŸ“š Documentation Updates + +**Documentation Reorganization:** +- Restructured docs folder +- Updated plugin distribution documentation +- Added comprehensive system guides +- Improved workflow documentation + +**New/Updated Docs:** +- Plugin distribution system guide +- Backup and cleanup guide (300+ lines) +- Pre-launch checklist updates +- Version update workflow + +--- + +### πŸ”§ Technical Changes + +**Build & Development:** +- 23 commits since v1.6.2 +- 24+ files modified +- Major merge: Phase 1, 5, 6 implementation +- Build optimizations + +**Database & API:** +- Enhanced model relationships +- Improved query optimization +- Better API endpoint structure +- Rate limiting enhancements + +**Frontend:** +- Component cleanup and organization +- Better state management +- Improved type safety +- Search modal enhancements + +--- + +### πŸš€ Production Readiness Status + +**Completed:** +- βœ… Phase 1: Code cleanup complete +- βœ… Phase 5: UX improvements complete +- βœ… Phase 6: Data backup & cleanup tools ready +- βœ… Plugin distribution system operational +- βœ… All tests passing +- βœ… Production build ready + +**Deferred to Post-Launch:** +- Image regeneration feature (Phase 9) +- Additional AI model integrations +- Advanced automation features + +**Next Steps:** +- Phase 7: User acceptance testing +- Performance optimization +- Final pre-launch checklist +- V1.0 production deployment + +--- + ## v1.6.2 - January 8, 2026 ### Marketing Site Design Refinements diff --git a/docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md b/docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md index f643d782..a2a88910 100644 --- a/docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md +++ b/docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md @@ -1,7 +1,7 @@ # WordPress Integration & Publishing Flow - Complete Technical Documentation -**Last Updated:** January 1, 2026 -**Version:** 1.3.0 +**Last Updated:** January 10, 2026 +**Version:** 1.7.0 **Status:** Production Active --- @@ -15,8 +15,9 @@ 5. [Webhook Sync Flow (WordPress β†’ IGNY8)](#5-webhook-sync-flow-wordpress--igny8) 6. [Metadata Sync Flow](#6-metadata-sync-flow) 7. [Data Models & Storage](#7-data-models--storage) -8. [Current Implementation Gaps](#8-current-implementation-gaps) -9. [Flow Diagrams](#9-flow-diagrams) +8. [Plugin Distribution System](#8-plugin-distribution-system) +9. [Current Implementation](#9-current-implementation) +10. [Flow Diagrams](#10-flow-diagrams) --- @@ -28,6 +29,8 @@ IGNY8 integrates with WordPress sites through a **custom WordPress plugin** (`ig - Receives content from IGNY8 via a custom REST endpoint (`/wp-json/igny8/v1/publish`) - Sends status updates back to IGNY8 via webhooks - Authenticates using API keys stored in both systems +- Auto-updates via IGNY8 plugin distribution system (v1.7.0+) +- Supports advanced template rendering with image layouts ### Communication Pattern @@ -40,6 +43,9 @@ IGNY8 App ←→ WordPress Site β”‚ HTTP POST β”‚ │←────────────── Webhook status updates via /api/v1/integration/webhooks/wordpress/status/ β”‚ β”‚ + β”‚ HTTP GET β”‚ + β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β†’β”‚ Check plugin updates via /wp-json/igny8/v1/check-update + β”‚ β”‚ ``` ### Key Components @@ -48,10 +54,20 @@ IGNY8 App ←→ WordPress Site |-----------|----------|---------| | SiteIntegration Model | `business/integration/models.py` | Stores WordPress credentials & config | | SyncEvent Model | `business/integration/models.py` | Logs all sync operations | +| Plugin Models | `plugins/models.py` | Plugin versioning and distribution | | Celery Task | `tasks/wordpress_publishing.py` | Background publishing worker | | Webhook Handler | `modules/integration/webhooks.py` | Receives WordPress status updates | | Frontend Form | `components/sites/WordPressIntegrationForm.tsx` | User setup UI | +### Recent Updates (v1.7.0) + +**Plugin Distribution System:** +- βœ… Automated plugin distribution and updates +- βœ… WordPress plugin v1.3.3 with template improvements +- βœ… Image layout fixes (square/landscape positioning) +- βœ… Auto-update mechanism via WordPress hooks +- βœ… Health check and monitoring endpoints + --- ## 2. Integration Setup Flow @@ -60,10 +76,30 @@ IGNY8 App ←→ WordPress Site 1. WordPress 5.6+ with REST API enabled 2. Pretty permalinks enabled (Settings β†’ Permalinks) -3. IGNY8 WordPress Bridge plugin installed and activated +3. IGNY8 WordPress Bridge plugin v1.3.0+ installed and activated 4. No security plugins blocking REST API -### 2.2 Setup Steps (User Flow) +### 2.2 Plugin Installation (Updated v1.7.0) + +**Option 1: Manual Download & Install** +- User downloads latest plugin from IGNY8 app +- Frontend: Site Settings β†’ WordPress Integration β†’ Download Plugin +- Download endpoint: `https://api.igny8.com/api/plugins/igny8-wp-bridge/download/` +- Installs in WordPress: Plugins β†’ Add New β†’ Upload ZIP + +**Option 2: Direct URL Install** +- WordPress admin β†’ Plugins β†’ Add New β†’ Upload Plugin +- Paste ZIP URL with signed download token +- Plugin installs and auto-registers with IGNY8 + +**Plugin Auto-Update:** +- WordPress checks for updates every 12 hours +- Plugin hooks into `pre_set_site_transient_update_plugins` +- Compares current version with latest from IGNY8 API +- Notifies admin if update available +- Can be updated via WordPress admin (one-click) + +### 2.3 Setup Steps (User Flow) **Step 1: User navigates to Site Settings** - Frontend: `/sites/{id}/settings` β†’ WordPress Integration section @@ -74,11 +110,9 @@ IGNY8 App ←→ WordPress Site - Body: `{ "site_id": 123 }` - Backend creates/updates `SiteIntegration` record with new API key -**Step 3: User copies API key and configures WordPress plugin** -- User downloads plugin from GitHub releases -- Installs in WordPress: Plugins β†’ Add New β†’ Upload +**Step 3: User configures WordPress plugin** - Configures plugin with: - - IGNY8 API URL: `https://app.igny8.com` + - IGNY8 API URL: `https://api.igny8.com` - Site API Key: (copied from IGNY8) - Site ID: (shown in IGNY8) @@ -86,10 +120,10 @@ IGNY8 App ←→ WordPress Site - User clicks "Test Connection" in either app - IGNY8 calls: `GET {wordpress_url}/wp-json/wp/v2/users/me` - Uses API key in `X-IGNY8-API-KEY` header -- Success: Connection verified, `is_active` set to true +- Success: Connection verified, `is_active` set to true, plugin registers installation - Failure: Error message displayed -### 2.3 Data Created During Setup +### 2.4 Data Created During Setup **SiteIntegration Record:** ```json @@ -463,18 +497,124 @@ Refreshes understanding of WordPress site: - WordPress plugin must download and create attachment - If plugin doesn't handle this, no featured image -### 8.5 Missing: Conflict Resolution +--- -**Problem:** If content is edited in both IGNY8 and WordPress, there's no merge strategy. +## 8. Plugin Distribution System -**Current State:** -- Last write wins -- No version tracking -- No conflict detection +### 8.1 Architecture (v1.7.0) + +**Plugin Distribution Components:** +- `Plugin` model - Multi-platform plugin registry +- `PluginVersion` model - Version tracking with files and checksums +- `PluginInstallation` model - Installation tracking per site +- `PluginDownload` model - Download analytics + +**Distribution Endpoints:** +``` +GET /api/plugins/igny8-wp-bridge/download/ - Download latest ZIP +POST /api/plugins/igny8-wp-bridge/check-update/ - Check for updates +GET /api/plugins/igny8-wp-bridge/info/ - Plugin metadata +POST /api/plugins/igny8-wp-bridge/register/ - Register installation +POST /api/plugins/igny8-wp-bridge/health-check/ - Health monitoring +``` + +### 8.2 Auto-Update Mechanism + +**WordPress Side:** +1. Plugin hooks into `pre_set_site_transient_update_plugins` +2. Calls `/api/plugins/igny8-wp-bridge/check-update/` with current version +3. Receives update info if newer version available +4. WordPress displays update notification +5. User clicks "Update Now" (or auto-update runs) +6. WordPress downloads ZIP from `/download/` endpoint +7. Installs and activates new version + +**IGNY8 Side:** +1. Developer updates plugin source code +2. Creates new `PluginVersion` in Django admin +3. Changes status to "released" +4. Signal automatically builds ZIP with checksums +5. Files stored in `/plugins/wordpress/dist/` +6. WordPress sites can now download/update + +### 8.3 Version History (Recent) + +| Version | Date | Changes | +|---------|------|---------| +| 1.3.3 | Jan 10, 2026 | Template design: Square image grid fixes, landscape positioning, direct styling for images without captions | +| 1.3.2 | Jan 9, 2026 | Template rendering improvements, image layout enhancements | +| 1.3.1 | Jan 9, 2026 | Plugin versioning updates | +| 1.3.0 | Jan 8, 2026 | Distribution system release, auto-update mechanism | + +### 8.4 Security Features + +- **Signed URLs:** Download links expire after configurable time +- **Checksums:** MD5 and SHA256 verification +- **Rate Limiting:** Per IP/site download limits +- **API Authentication:** Required for sensitive operations +- **Version Verification:** WordPress validates plugin before update + +### 8.5 Monitoring + +**Installation Tracking:** +- Total installations per version +- Active installations by site +- Version distribution analytics + +**Download Analytics:** +- Download counts per version +- Geographic distribution +- Failed download attempts + +**Health Checks:** +- Plugin health status per installation +- Error reporting from WordPress sites +- Version compatibility tracking --- -## 9. Flow Diagrams +## 9. Current Implementation + +### 9.1 Production Status (v1.7.0) + +**βœ… Fully Operational:** +- WordPress plugin distribution system +- Auto-update mechanism +- Template rendering with advanced layouts +- Image positioning (square/landscape) +- Content publishing (manual + automation) +- Webhook status sync +- API authentication +- Health monitoring + +**βœ… Template Features (v1.3.3):** +- Square images: Side-by-side layout (left/right aligned) +- Landscape images: Full-width with max 1024px +- Images appear after first paragraph in sections +- Direct border-radius/shadow on images without captions +- Responsive design for mobile/tablet + +### 9.2 Known Limitations + +**Missing Features:** +- Bi-directional content sync (WordPress β†’ IGNY8 editing) +- Conflict resolution for dual edits +- Advanced metadata sync beyond basics +- Multi-site WordPress network support +- Custom post type publishing + +### 9.3 Future Enhancements + +**Planned:** +- Image regeneration feature (Phase 9) +- Advanced template customization +- Custom field mapping +- Bulk publishing operations +- Real-time sync notifications + +--- + +## 10. Flow Diagrams ### 9.1 Integration Setup @@ -486,26 +626,33 @@ Refreshes understanding of WordPress site: β”‚ 1. Open Site Settings β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚ β”‚ β”‚ β”‚ β”‚ - β”‚ 2. Generate API Key β”‚ + β”‚ 2. Download Plugin β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚ β”‚ β”‚ β”‚ β”‚ β”‚<────────────────── β”‚ - β”‚ 3. Display API Key β”‚ + β”‚ 3. Plugin ZIP β”‚ β”‚ β”‚ β”‚ β”‚ β”‚ 4. Install Plugin──────────────────────┼──────────> β”‚ β”‚ β”‚ - β”‚ 5. Enter API Key in Plugin─────────────┼──────────> - β”‚ β”‚ β”‚ - β”‚ 6. Test Connection β”‚ + β”‚ 5. Generate API Key β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚ β”‚ - β”‚ β”‚ 7. GET /wp-json/... β”‚ + β”‚<────────────────── β”‚ + β”‚ 6. Display API Key β”‚ + β”‚ β”‚ β”‚ + β”‚ 7. Enter API Key in Plugin─────────────┼──────────> + β”‚ β”‚ β”‚ + β”‚ 8. Test Connection β”‚ + β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚ β”‚ + β”‚ β”‚ 9. GET /wp-json/... β”‚ β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚ β”‚ β”‚<───────────────────── - β”‚<────────────────── 8. Success β”‚ + β”‚<────────────────── 10. Success β”‚ β”‚ β”‚ β”‚ + β”‚ β”‚ 11. Register Installβ”‚ + β”‚ β”‚<───────────────────── ``` -### 9.2 Manual Publishing +### 10.2 Manual Publishing ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” @@ -534,7 +681,43 @@ Refreshes understanding of WordPress site: β”‚ β”‚ β”‚ β”‚ ``` -### 9.3 Webhook Status Sync +### 10.3 Plugin Auto-Update Flow + +``` +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ WordPress β”‚ β”‚ IGNY8 API β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜ + β”‚ β”‚ + β”‚ 1. Check for updates (cron) + β”‚ POST /check-update/β”‚ + β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚ + β”‚ (current: 1.3.2) β”‚ + β”‚ β”‚ + β”‚<──────────────────── + β”‚ 2. Update availableβ”‚ + β”‚ (latest: 1.3.3) β”‚ + β”‚ β”‚ + β”‚ 3. User clicks β”‚ + β”‚ "Update Now" β”‚ + β”‚ β”‚ + β”‚ GET /download/ β”‚ + β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚ + β”‚ β”‚ + β”‚<──────────────────── + β”‚ 4. ZIP file β”‚ + β”‚ β”‚ + β”‚ 5. Install & Activate + β”‚ β”‚ + β”‚ POST /register/ β”‚ + β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚ + β”‚ (new version info) β”‚ + β”‚ β”‚ + β”‚<──────────────────── + β”‚ 6. Registration OK β”‚ + β”‚ β”‚ +``` + +### 10.4 Webhook Status Sync ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” diff --git a/docs/60-PLUGINS/INDEX.md b/docs/60-PLUGINS/INDEX.md index c4477a86..4cfa00bf 100644 --- a/docs/60-PLUGINS/INDEX.md +++ b/docs/60-PLUGINS/INDEX.md @@ -1,5 +1,9 @@ # Plugin Management Documentation +**Last Updated:** January 10, 2026 +**Version:** 1.7.0 +**Status:** Production + This section covers plugin distribution, management, and integration from the IGNY8 app perspective. ## Contents @@ -7,30 +11,119 @@ This section covers plugin distribution, management, and integration from the IG 1. [WORDPRESS-INTEGRATION.md](WORDPRESS-INTEGRATION.md) - Complete guide for WordPress integration management 2. [PLUGIN-UPDATE-WORKFLOW.md](PLUGIN-UPDATE-WORKFLOW.md) - How plugin updates work and post-update checklist +## Overview + +The IGNY8 plugin distribution system provides a comprehensive infrastructure for managing, distributing, and updating plugins across multiple platforms (WordPress, Shopify, custom sites). The system includes automated versioning, security features, update mechanisms, and monitoring. + ## Quick Reference ### API Endpoints (Production) -| Endpoint | Purpose | -|----------|---------| -| `https://api.igny8.com/api/plugins/igny8-wp-bridge/download/` | Download latest plugin ZIP | -| `https://api.igny8.com/api/plugins/igny8-wp-bridge/check-update/` | Check for updates (called by WP plugin) | -| `https://api.igny8.com/api/plugins/igny8-wp-bridge/info/` | Get plugin metadata | +| Endpoint | Purpose | Method | +|----------|---------|--------| +| `https://api.igny8.com/api/plugins/igny8-wp-bridge/download/` | Download latest plugin ZIP | GET | +| `https://api.igny8.com/api/plugins/igny8-wp-bridge/check-update/` | Check for updates (called by WP plugin) | POST | +| `https://api.igny8.com/api/plugins/igny8-wp-bridge/info/` | Get plugin metadata | GET | +| `https://api.igny8.com/api/plugins/igny8-wp-bridge/register/` | Register new installation | POST | +| `https://api.igny8.com/api/plugins/igny8-wp-bridge/health-check/` | Plugin health check | POST | ### Key Directories | Path | Purpose | |------|---------| -| `/data/app/igny8/plugins/wordpress/source/` | Plugin source code | +| `/data/app/igny8/plugins/wordpress/source/igny8-wp-bridge/` | WordPress plugin source code | | `/data/app/igny8/plugins/wordpress/dist/` | Distribution ZIP files | +| `/data/app/igny8/plugins/shopify/` | Shopify integration (planned) | +| `/data/app/igny8/plugins/custom-site/` | Custom site integration (planned) | | `/data/app/igny8/backend/igny8_core/plugins/` | Django plugin management app | ### Database Models -- `Plugin` - Plugin registry (name, slug, platform) -- `PluginVersion` - Version tracking with file info -- `PluginInstallation` - Track installations per site -- `PluginDownload` - Download analytics +- `Plugin` - Plugin registry (name, slug, platform, status) +- `PluginVersion` - Version tracking with file info, checksums, changelog +- `PluginInstallation` - Track installations per site with version info +- `PluginDownload` - Download analytics and tracking + +### Current Plugin Status + +| Platform | Plugin Name | Current Version | Status | +|----------|-------------|-----------------|--------| +| WordPress | IGNY8 WP Bridge | 1.3.3 | Production | +| Shopify | IGNY8 Shopify | - | Infrastructure Ready | +| Custom | IGNY8 Bridge | - | Infrastructure Ready | + +## System Features + +### Distribution System +- Automated ZIP package generation +- Version-based file management +- MD5 and SHA256 checksums +- Signed download URLs +- Rate limiting and security + +### Update Mechanism +- WordPress auto-update via `pre_set_site_transient_update_plugins` hook +- Version comparison and update notifications +- Changelog display +- Compatibility checks + +### Monitoring & Analytics +- Installation tracking per site +- Download counts and analytics +- Health check endpoints +- Version distribution tracking +- Error logging and monitoring + +### Security Features +- Signed URLs with expiration +- Checksum verification (MD5/SHA256) +- Rate limiting per IP/site +- API authentication for sensitive endpoints +- Production environment protection + +## Integration Flow + +``` +Developer β†’ Update Source Code β†’ Create PluginVersion in Admin + ↓ +Automatic: Build ZIP, Calculate Checksums, Store in /dist/ + ↓ +WordPress Site β†’ Check for Updates β†’ Download via API + ↓ +Install/Update β†’ Register Installation β†’ Health Check +``` + +## Version Progression (Last 20 Commits) + +**WordPress Plugin Versions:** +- v1.3.3 - Template design improvements, image layout fixes +- v1.3.2 - Template fixes in app and plugin +- v1.3.1 - WordPress plugin updates +- v1.3.0 - Initial distribution system release + +**Infrastructure Updates:** +- Plugin distribution system implemented (v1.7.0) +- Database models for multi-platform support +- API endpoints for lifecycle management +- Automated packaging and versioning +- Security and monitoring features + +## Documentation Structure + +### App-Side Documentation (This Folder) +- Plugin distribution infrastructure +- API endpoint documentation +- Database models and admin interface +- Integration workflows +- Security and monitoring + +### Plugin-Side Documentation +See `/plugins/wordpress/source/igny8-wp-bridge/docs/` for: +- Plugin PHP code and functions +- WordPress hooks and filters +- Template system +- Content publishing flow +- Plugin-specific configuration --- diff --git a/docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md b/docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md index 390a572d..2f99868e 100644 --- a/docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md +++ b/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) diff --git a/docs/60-PLUGINS/WORDPRESS-INTEGRATION.md b/docs/60-PLUGINS/WORDPRESS-INTEGRATION.md index c4c52393..bcca5d5b 100644 --- a/docs/60-PLUGINS/WORDPRESS-INTEGRATION.md +++ b/docs/60-PLUGINS/WORDPRESS-INTEGRATION.md @@ -1,6 +1,7 @@ # WordPress Integration Management -**Last Updated:** January 9, 2026 +**Last Updated:** January 10, 2026 +**Version:** 1.7.0 **Status:** Production **Scope:** App-side management of WordPress plugin distribution and site integrations @@ -16,7 +17,8 @@ 6. [Django Admin Management](#6-django-admin-management) 7. [Frontend Integration](#7-frontend-integration) 8. [Site Integration Flow](#8-site-integration-flow) -9. [Troubleshooting](#9-troubleshooting) +9. [Recent Updates (v1.7.0)](#9-recent-updates-v170) +10. [Troubleshooting](#10-troubleshooting) --- @@ -31,6 +33,8 @@ This document covers the **app-side** management of WordPress integration: - API endpoints that WordPress plugins call - Admin interface for managing plugins and versions - Frontend components for plugin download +- Plugin distribution infrastructure (v1.7.0) +- Automated versioning and packaging system ### What This Document Does NOT Cover @@ -38,6 +42,15 @@ This document covers the **app-side** management of WordPress integration: - WordPress-side setup and configuration - Plugin installation on WordPress sites +### Current Status (v1.7.0) + +- βœ… WordPress Plugin: v1.3.3 (Production) +- βœ… Distribution System: Fully operational +- βœ… Auto-update Mechanism: Active +- βœ… Template Design: Updated with image layout fixes +- βœ… API Endpoints: All operational +- βœ… Security Features: Checksums, signed URLs, rate limiting + --- ## 2. Architecture @@ -594,6 +607,115 @@ unzip -p /data/app/igny8/plugins/wordpress/dist/igny8-wp-bridge-v1.1.1.zip \ | Log | Location | |-----|----------| +| Django Logs | `/data/app/igny8/backend/logs/` | +| Plugin API Logs | Check Django logs for `/api/plugins/` requests | +| WordPress Plugin Logs | WP site's debug.log if WP_DEBUG enabled | + +--- + +## 9. Recent Updates (v1.7.0) + +### Plugin Distribution System Implemented + +**Infrastructure:** +- βœ… Complete plugin distribution system operational +- βœ… Multi-platform support (WordPress, Shopify, Custom sites) +- βœ… Automated ZIP packaging with versioning +- βœ… Security features: checksums (MD5/SHA256), signed URLs, rate limiting +- βœ… Monitoring and analytics dashboard + +**Database Models:** +- `Plugin` - Platform-agnostic plugin registry +- `PluginVersion` - Full version lifecycle management +- `PluginInstallation` - Per-site installation tracking +- `PluginDownload` - Download analytics and monitoring + +**API Endpoints:** +- All 5 endpoints operational and tested +- `/download/` - Serve plugin ZIP files +- `/check-update/` - WordPress update mechanism +- `/info/` - Plugin metadata +- `/register/` - Installation registration +- `/health-check/` - Plugin health monitoring + +### WordPress Plugin Updates (v1.3.0 β†’ v1.3.3) + +**v1.3.3 - Template Design Improvements:** +- Fixed square images displaying in 2 rows (now side-by-side) +- Fixed landscape images in sections 4+ displaying incorrectly +- Removed card wrapper for images without descriptions +- Applied border-radius and shadow directly to images +- Landscape images now appear after first paragraph +- Consistent CSS classes for all image types + +**v1.3.2 - Template Fixes:** +- Template rendering improvements in app and plugin +- Image layout enhancements +- Content section fixes + +**v1.3.1 - Plugin Updates:** +- Versioning system improvements +- WordPress plugin compatibility updates + +**v1.3.0 - Initial Distribution System:** +- First release with automated distribution +- Update mechanism implementation +- Base template system + +### Version Progression Timeline + +``` +v1.7.0 (Jan 10, 2026) - App infrastructure + plugin v1.3.3 + β”œβ”€β”€ Plugin distribution system complete + β”œβ”€β”€ Template design overhaul + β”œβ”€β”€ Image layout fixes + └── Pre-launch cleanup (Phases 1, 5, 6) + +v1.6.2 (Jan 8, 2026) - Design refinements + └── Marketing site updates + +v1.6.0 (Jan 8, 2026) - Payment system refactor + └── Stripe, PayPal, Bank Transfer + +v1.4.0 (Jan 5, 2026) - AI model architecture overhaul + └── IntegrationProvider, AIModelConfig +``` + +### Infrastructure Improvements + +**Security:** +- Signed URLs with expiration for downloads +- Checksum verification (MD5 + SHA256) +- Rate limiting per IP/site +- API authentication for sensitive operations +- Production environment protection + +**Automation:** +- Auto-build on version status change +- Automatic checksum calculation +- File size tracking +- Version number updates in ZIP contents +- Released timestamp tracking + +**Monitoring:** +- Installation tracking per site +- Download analytics +- Health check endpoints +- Version distribution monitoring +- Error logging and alerts + +### Documentation Updates + +- Added comprehensive plugin distribution plan +- Updated API endpoint documentation +- Enhanced troubleshooting guides +- Added version progression tracking +- Updated architecture diagrams + +--- + +## 10. Troubleshooting +|-----|----------| | Django logs | `/data/app/logs/django.log` | | Plugin build logs | Check Django log for `"Created plugin ZIP"` messages | | Download tracking | `PluginDownload` model in database | diff --git a/docs/INDEX.md b/docs/INDEX.md index c9d186b3..47331508 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -1,7 +1,7 @@ # IGNY8 Technical Documentation -**Version:** 1.6.2 -**Last Updated:** January 8, 2026 +**Version:** 1.7.0 +**Last Updated:** January 10, 2026 **Purpose:** Complete technical reference for the IGNY8 AI content platform --- diff --git a/frontend/package.json b/frontend/package.json index 3b55281f..65815664 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,7 +1,7 @@ { "name": "tailadmin-react", "private": true, - "version": "2.0.2", + "version": "1.7.0", "type": "module", "scripts": { "dev": "vite",