salman/igny8
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v 1.7.0

Browse Source
This commit is contained in:
IGNY8 VPS (Salman)
2026-01-10 08:47:36 +00:00
parent b0c941dba5
commit 60f981cafd
7 changed files with 747 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

210
CHANGELOG.md
View File

@@ -1,7 +1,7 @@
# IGNY8 Change Log # IGNY8 Change Log
**Current Version:** 1.6.2 **Current Version:** 1.7.0
**Last Updated:** January 8, 2026 **Last Updated:** January 10, 2026
--- ---
@@ -9,6 +9,7 @@
| Version | Date | Summary | | 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.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.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 | | 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 ## v1.6.2 - January 8, 2026
### Marketing Site Design Refinements ### Marketing Site Design Refinements

239
docs/50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md
View File

@@ -1,7 +1,7 @@
# WordPress Integration & Publishing Flow - Complete Technical Documentation # WordPress Integration & Publishing Flow - Complete Technical Documentation
**Last Updated:** January 1, 2026 **Last Updated:** January 10, 2026
**Version:** 1.3.0 **Version:** 1.7.0
**Status:** Production Active **Status:** Production Active
--- ---
@@ -15,8 +15,9 @@
5. [Webhook Sync Flow (WordPress → IGNY8)](#5-webhook-sync-flow-wordpress--igny8) 5. [Webhook Sync Flow (WordPress → IGNY8)](#5-webhook-sync-flow-wordpress--igny8)
6. [Metadata Sync Flow](#6-metadata-sync-flow) 6. [Metadata Sync Flow](#6-metadata-sync-flow)
7. [Data Models & Storage](#7-data-models--storage) 7. [Data Models & Storage](#7-data-models--storage)
8. [Current Implementation Gaps](#8-current-implementation-gaps) 8. [Plugin Distribution System](#8-plugin-distribution-system)
9. [Flow Diagrams](#9-flow-diagrams) 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`) - Receives content from IGNY8 via a custom REST endpoint (`/wp-json/igny8/v1/publish`)
- Sends status updates back to IGNY8 via webhooks - Sends status updates back to IGNY8 via webhooks
- Authenticates using API keys stored in both systems - 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 ### Communication Pattern
@@ -40,6 +43,9 @@ IGNY8 App ←→ WordPress Site
│ HTTP POST │ │ HTTP POST │
│←─────────────┤ Webhook status updates via /api/v1/integration/webhooks/wordpress/status/ │←─────────────┤ Webhook status updates via /api/v1/integration/webhooks/wordpress/status/
│ │ │ │
│ HTTP GET │
├─────────────→│ Check plugin updates via /wp-json/igny8/v1/check-update
│ │
``` ```
### Key Components ### Key Components
@@ -48,10 +54,20 @@ IGNY8 App ←→ WordPress Site
|-----------|----------|---------| |-----------|----------|---------|
| SiteIntegration Model | `business/integration/models.py` | Stores WordPress credentials & config | | SiteIntegration Model | `business/integration/models.py` | Stores WordPress credentials & config |
| SyncEvent Model | `business/integration/models.py` | Logs all sync operations | | 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 | | Celery Task | `tasks/wordpress_publishing.py` | Background publishing worker |
| Webhook Handler | `modules/integration/webhooks.py` | Receives WordPress status updates | | Webhook Handler | `modules/integration/webhooks.py` | Receives WordPress status updates |
| Frontend Form | `components/sites/WordPressIntegrationForm.tsx` | User setup UI | | 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 ## 2. Integration Setup Flow
@@ -60,10 +76,30 @@ IGNY8 App ←→ WordPress Site
1. WordPress 5.6+ with REST API enabled 1. WordPress 5.6+ with REST API enabled
2. Pretty permalinks enabled (Settings → Permalinks) 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 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** **Step 1: User navigates to Site Settings**
- Frontend: `/sites/{id}/settings` → WordPress Integration section - Frontend: `/sites/{id}/settings` → WordPress Integration section
@@ -74,11 +110,9 @@ IGNY8 App ←→ WordPress Site
- Body: `{ "site_id": 123 }` - Body: `{ "site_id": 123 }`
- Backend creates/updates `SiteIntegration` record with new API key - Backend creates/updates `SiteIntegration` record with new API key
**Step 3: User copies API key and configures WordPress plugin** **Step 3: User configures WordPress plugin**
- User downloads plugin from GitHub releases
- Installs in WordPress: Plugins → Add New → Upload
- Configures plugin with: - Configures plugin with:
- IGNY8 API URL: `https://app.igny8.com` - IGNY8 API URL: `https://api.igny8.com`
- Site API Key: (copied from IGNY8) - Site API Key: (copied from IGNY8)
- Site ID: (shown in IGNY8) - Site ID: (shown in IGNY8)
@@ -86,10 +120,10 @@ IGNY8 App ←→ WordPress Site
- User clicks "Test Connection" in either app - User clicks "Test Connection" in either app
- IGNY8 calls: `GET {wordpress_url}/wp-json/wp/v2/users/me` - IGNY8 calls: `GET {wordpress_url}/wp-json/wp/v2/users/me`
- Uses API key in `X-IGNY8-API-KEY` header - 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 - Failure: Error message displayed
### 2.3 Data Created During Setup ### 2.4 Data Created During Setup
**SiteIntegration Record:** **SiteIntegration Record:**
```json ```json
@@ -463,18 +497,124 @@ Refreshes understanding of WordPress site:
- WordPress plugin must download and create attachment - WordPress plugin must download and create attachment
- If plugin doesn't handle this, no featured image - 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:** ### 8.1 Architecture (v1.7.0)
- Last write wins
- No version tracking **Plugin Distribution Components:**
- No conflict detection - `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 ### 9.1 Integration Setup
@@ -486,26 +626,33 @@ Refreshes understanding of WordPress site:
│ 1. Open Site Settings │ │ 1. Open Site Settings │
├─────────────────>│ │ ├─────────────────>│ │
│ │ │ │ │ │
│ 2. Generate API Key │ │ 2. Download Plugin │
├─────────────────>│ │ ├─────────────────>│ │
│ │ │ │ │ │
│<─────────────────┤ │ │<─────────────────┤ │
│ 3. Display API Key │ │ 3. Plugin ZIP │ │
│ │ │ │ │ │
│ 4. Install Plugin──────────────────────┼──────────> │ 4. Install Plugin──────────────────────┼──────────>
│ │ │ │ │ │
│ 5. Enter API Key in Plugin─────────────┼──────────> │ 5. Generate API Key │
│ │ │
│ 6. Test Connection │
├─────────────────>│ │ ├─────────────────>│ │
│ │ 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
``` ```
┌───────────────┐ ┌──────────────┐ ┌───────────────┐ ┌──────────────┐

113
docs/60-PLUGINS/INDEX.md
View File

@@ -1,5 +1,9 @@
# Plugin Management Documentation # 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. This section covers plugin distribution, management, and integration from the IGNY8 app perspective.
## Contents ## 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 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 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 ## Quick Reference
### API Endpoints (Production) ### API Endpoints (Production)
| Endpoint | Purpose | | Endpoint | Purpose | Method |
|----------|---------| |----------|---------|--------|
| `https://api.igny8.com/api/plugins/igny8-wp-bridge/download/` | Download latest plugin ZIP | | `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) | | `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 | | `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 ### Key Directories
| Path | Purpose | | 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/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 | | `/data/app/igny8/backend/igny8_core/plugins/` | Django plugin management app |
### Database Models ### Database Models
- `Plugin` - Plugin registry (name, slug, platform) - `Plugin` - Plugin registry (name, slug, platform, status)
- `PluginVersion` - Version tracking with file info - `PluginVersion` - Version tracking with file info, checksums, changelog
- `PluginInstallation` - Track installations per site - `PluginInstallation` - Track installations per site with version info
- `PluginDownload` - Download analytics - `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
--- ---

101
docs/60-PLUGINS/PLUGIN-UPDATE-WORKFLOW.md
View File

@@ -1,6 +1,7 @@
# Plugin Update Workflow # Plugin Update Workflow
**Last Updated:** January 9, 2026 **Last Updated:** January 10, 2026
**Version:** 1.7.0
**Status:** Production **Status:** Production
**Scope:** How to release plugin updates and what happens automatically vs manually **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: 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) 2. **Changelog** (what's new)
3. **Status** (draft → released) 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 ## Table of Contents
1. [Update Workflow Overview](#1-update-workflow-overview) 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) 6. [Version Numbering](#6-version-numbering)
7. [Rollback Procedure](#7-rollback-procedure) 7. [Rollback Procedure](#7-rollback-procedure)
8. [Emergency Updates](#8-emergency-updates) 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 ## Quick Reference Card
### Release New Version (Simplified) ### 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) 2. Update version in igny8-bridge.php (header + constant)
3. Django Admin → Add Plugin Version: 3. Django Admin → Add Plugin Version:
- Plugin: IGNY8 WordPress Bridge - Plugin: IGNY8 WordPress Bridge
- Version: 1.2.0 - Version: 1.3.3 (or next version)
- Changelog: Describe changes - Changelog: Describe changes
- Status: draft - Status: draft
- (All other fields auto-fill) - (All other fields auto-fill)

126
docs/60-PLUGINS/WORDPRESS-INTEGRATION.md
View File

@@ -1,6 +1,7 @@
# WordPress Integration Management # WordPress Integration Management
**Last Updated:** January 9, 2026 **Last Updated:** January 10, 2026
**Version:** 1.7.0
**Status:** Production **Status:** Production
**Scope:** App-side management of WordPress plugin distribution and site integrations **Scope:** App-side management of WordPress plugin distribution and site integrations
@@ -16,7 +17,8 @@
6. [Django Admin Management](#6-django-admin-management) 6. [Django Admin Management](#6-django-admin-management)
7. [Frontend Integration](#7-frontend-integration) 7. [Frontend Integration](#7-frontend-integration)
8. [Site Integration Flow](#8-site-integration-flow) 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 - API endpoints that WordPress plugins call
- Admin interface for managing plugins and versions - Admin interface for managing plugins and versions
- Frontend components for plugin download - Frontend components for plugin download
- Plugin distribution infrastructure (v1.7.0)
- Automated versioning and packaging system
### What This Document Does NOT Cover ### 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 - WordPress-side setup and configuration
- Plugin installation on WordPress sites - 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 ## 2. Architecture
@@ -594,6 +607,115 @@ unzip -p /data/app/igny8/plugins/wordpress/dist/igny8-wp-bridge-v1.1.1.zip \
| Log | Location | | 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` | | Django logs | `/data/app/logs/django.log` |
| Plugin build logs | Check Django log for `"Created plugin ZIP"` messages | | Plugin build logs | Check Django log for `"Created plugin ZIP"` messages |
| Download tracking | `PluginDownload` model in database | | Download tracking | `PluginDownload` model in database |

4
docs/INDEX.md
View File

@@ -1,7 +1,7 @@
# IGNY8 Technical Documentation # IGNY8 Technical Documentation
**Version:** 1.6.2 **Version:** 1.7.0
**Last Updated:** January 8, 2026 **Last Updated:** January 10, 2026
**Purpose:** Complete technical reference for the IGNY8 AI content platform **Purpose:** Complete technical reference for the IGNY8 AI content platform
--- ---

2
frontend/package.json
View File

@@ -1,7 +1,7 @@
{ {
"name": "tailadmin-react", "name": "tailadmin-react",
"private": true, "private": true,
"version": "2.0.2", "version": "1.7.0",
"type": "module", "type": "module",
"scripts": { "scripts": {
"dev": "vite", "dev": "vite",