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

Initial commit: igny8 project

Browse Source
This commit is contained in:
igny8
2025-11-09 10:27:02 +00:00
commit 60b8188111
27265 changed files with 4360521 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

348
igny8-wp-plugin-for-reference-olny/docs/COMPLETE_FEATURES_LIST.md Normal file
View File

@@ -0,0 +1,348 @@
# Igny8 AI SEO Plugin - Complete Features List
## Summary Table
| Module | Core Features | Functions Involved | Dependencies | Files Involved |
|--------|---------------|-------------------|--------------|----------------|
| **Planner** | Keyword Research, AI Clustering, Content Ideas | `igny8_research_keywords()`, `igny8_ai_cluster_keywords()`, `igny8_ai_generate_ideas()` | OpenAI API, Database, WordPress | `modules/modules-pages/planner.php`, `ai/modules-ai.php`, `flows/sync-functions.php` |
| **Writer** | Content Generation, Draft Management, Publishing | `igny8_generate_content()`, `igny8_create_draft()`, `igny8_publish_content()` | AI APIs, WordPress, Database | `modules/modules-pages/writer.php`, `ai/modules-ai.php`, `flows/sync-functions.php` |
| **Optimizer** | SEO Analysis, Content Audits, Optimization | `igny8_analyze_content()`, `igny8_generate_suggestions()`, `igny8_optimize_content()` | SEO APIs, Database | `modules/modules-pages/optimizer.php`, `ai/modules-ai.php` |
| **Linker** | Backlink Management, Campaign Tracking | `igny8_track_backlinks()`, `igny8_manage_campaigns()`, `igny8_analyze_authority()` | External APIs, Database | `modules/modules-pages/linker.php`, `flows/sync-functions.php` |
| **Personalize** | AI Content Personalization, User Targeting | `igny8_detect_fields()`, `igny8_rewrite_content()`, `igny8_personalize_content()` | OpenAI API, Frontend | `modules/modules-pages/personalize/`, `ai/integration.php` |
| **Thinker** | AI Strategy, Prompt Management, Content Planning | `igny8_manage_prompts()`, `igny8_generate_strategies()`, `igny8_plan_content()` | AI APIs, Database | `core/pages/thinker/`, `ai/prompts-library.php` |
| **Analytics** | Performance Tracking, KPI Monitoring | `igny8_track_metrics()`, `igny8_generate_reports()`, `igny8_analyze_performance()` | Database, WordPress | `core/admin/`, `modules/config/kpi-config.php` |
| **Schedules** | Automation Management, CRON Jobs | `igny8_manage_cron()`, `igny8_schedule_tasks()`, `igny8_automate_workflows()` | WordPress CRON, Database | `core/cron/`, `core/pages/settings/schedules.php` |
---
## 1. PLANNER MODULE FEATURES
### 1.1 Keyword Research & Analysis
- **Manual Keyword Import**: CSV import with template support
- **Keyword Validation**: Duplicate detection and data validation
- **Keyword Metrics**: Volume, difficulty, competition analysis
- **Keyword Categorization**: Primary, secondary, long-tail classification
- **Keyword Mapping**: Cluster assignment and relationship mapping
### 1.2 AI-Powered Clustering
- **Automatic Clustering**: AI-driven keyword grouping based on semantic similarity
- **Cluster Management**: Create, edit, delete, and merge clusters
- **Cluster Metrics**: Volume aggregation, keyword count, performance tracking
- **Cluster Optimization**: AI suggestions for cluster improvement
- **Sector-Based Clustering**: Industry-specific keyword organization
### 1.3 Content Idea Generation
- **AI Idea Creation**: Automated content idea generation based on clusters
- **Idea Categorization**: Content type classification and tagging
- **Idea Prioritization**: AI-driven priority scoring and ranking
- **Idea Expansion**: Related topic and angle suggestions
- **Idea Validation**: Quality assessment and feasibility analysis
### 1.4 Planning Workflow Management
- **Step-by-Step Guidance**: Interactive planning workflow
- **Progress Tracking**: Visual progress indicators and completion status
- **Task Management**: Planning task assignment and tracking
- **Workflow Automation**: Automated progression through planning steps
- **Planning Analytics**: Performance metrics and optimization insights
---
## 2. WRITER MODULE FEATURES
### 2.1 Content Generation
- **AI Content Creation**: Automated article generation using OpenAI
- **Content Templates**: Predefined content structures and formats
- **Content Variation**: Multiple content versions and angles
- **Content Optimization**: SEO-optimized content generation
- **Content Personalization**: User-specific content adaptation
### 2.2 Draft Management
- **Draft Creation**: Automated draft generation from content ideas
- **Draft Review**: Content quality assessment and editing interface
- **Draft Versioning**: Version control and change tracking
- **Draft Collaboration**: Multi-user editing and approval workflows
- **Draft Optimization**: AI-powered content improvement suggestions
### 2.3 Publishing Workflow
- **Automated Publishing**: Scheduled content publication
- **Publishing Validation**: Pre-publication quality checks
- **Publishing Analytics**: Post-publication performance tracking
- **Bulk Publishing**: Mass content publication with batch processing
- **Publishing Optimization**: Performance-based publishing adjustments
### 2.4 Content Quality Assurance
- **Readability Analysis**: Content readability scoring and improvement
- **SEO Optimization**: Automated SEO factor optimization
- **Content Validation**: Grammar, spelling, and quality checks
- **Content Scoring**: Overall content quality assessment
- **Content Improvement**: AI-powered content enhancement suggestions
---
## 3. OPTIMIZER MODULE FEATURES
### 3.1 SEO Analysis
- **Content Audits**: Comprehensive SEO analysis of existing content
- **Keyword Optimization**: Keyword density and placement analysis
- **Meta Tag Analysis**: Title, description, and header optimization
- **Technical SEO**: Site structure and performance analysis
- **Competitor Analysis**: Competitive SEO benchmarking
### 3.2 Optimization Suggestions
- **AI-Powered Recommendations**: Intelligent optimization suggestions
- **Content Improvement**: Specific content enhancement recommendations
- **SEO Factor Optimization**: Technical SEO improvement suggestions
- **Performance Optimization**: Speed and user experience improvements
- **Conversion Optimization**: User engagement and conversion improvements
### 3.3 Performance Monitoring
- **Ranking Tracking**: Keyword ranking monitoring and analysis
- **Traffic Analysis**: Organic traffic growth and source analysis
- **Engagement Metrics**: User engagement and interaction tracking
- **Conversion Tracking**: Goal completion and conversion rate monitoring
- **Performance Reporting**: Comprehensive performance analytics and reporting
---
## 4. LINKER MODULE FEATURES
### 4.1 Backlink Management
- **Backlink Discovery**: Automated backlink detection and tracking
- **Backlink Analysis**: Quality assessment and authority analysis
- **Backlink Monitoring**: Continuous backlink tracking and updates
- **Backlink Reporting**: Comprehensive backlink performance reports
- **Backlink Optimization**: Link building strategy recommendations
### 4.2 Campaign Management
- **Campaign Planning**: Strategic link building campaign development
- **Outreach Management**: Automated outreach and follow-up systems
- **Campaign Tracking**: Progress monitoring and performance analysis
- **Campaign Optimization**: Performance-based campaign adjustments
- **Campaign Reporting**: Detailed campaign analytics and insights
### 4.3 Authority Building
- **Domain Authority Tracking**: DA monitoring and improvement strategies
- **Link Quality Assessment**: High-quality link identification and targeting
- **Relationship Building**: Influencer and industry relationship management
- **Content Promotion**: Strategic content promotion and link acquisition
- **Authority Optimization**: Long-term authority building strategies
---
## 5. PERSONALIZE MODULE FEATURES
### 5.1 AI Content Personalization
- **Field Detection**: Automated user characteristic identification
- **Content Rewriting**: AI-powered content personalization
- **User Targeting**: Demographic and behavioral targeting
- **Content Variation**: Multiple personalized content versions
- **Personalization Analytics**: User engagement and conversion tracking
### 5.2 Frontend Integration
- **Shortcode Implementation**: Easy content personalization integration
- **Display Modes**: Button, inline, and automatic personalization modes
- **User Interface**: Customizable personalization forms and interfaces
- **Responsive Design**: Mobile-optimized personalization experience
- **Performance Optimization**: Fast-loading personalization features
### 5.3 Personalization Management
- **Prompt Configuration**: AI prompt customization and optimization
- **Field Management**: Custom field creation and management
- **Content Scope**: Configurable content personalization scope
- **Context Management**: Advanced context and targeting options
- **Performance Monitoring**: Personalization effectiveness tracking
---
## 6. THINKER MODULE FEATURES
### 6.1 AI Strategy Management
- **Prompt Library**: Comprehensive AI prompt collection and management
- **Strategy Development**: AI-powered content strategy creation
- **Content Planning**: Intelligent content planning and scheduling
- **Performance Analysis**: Strategy effectiveness analysis and optimization
- **Strategic Recommendations**: AI-driven strategic insights and suggestions
### 6.2 Prompt Management
- **Prompt Creation**: Custom AI prompt development and testing
- **Prompt Optimization**: Performance-based prompt improvement
- **Prompt Library**: Organized prompt collection and categorization
- **Prompt Testing**: A/B testing for prompt effectiveness
- **Prompt Analytics**: Prompt performance tracking and analysis
### 6.3 Content Strategy
- **Strategic Planning**: Long-term content strategy development
- **Content Calendar**: Automated content scheduling and planning
- **Strategy Optimization**: Performance-based strategy adjustments
- **Competitive Analysis**: Competitor strategy analysis and benchmarking
- **Strategic Reporting**: Comprehensive strategy performance reports
---
## 7. ANALYTICS MODULE FEATURES
### 7.1 Performance Tracking
- **KPI Monitoring**: Key performance indicator tracking and analysis
- **Metric Dashboards**: Real-time performance dashboards
- **Performance Alerts**: Automated performance threshold alerts
- **Trend Analysis**: Performance trend identification and analysis
- **Comparative Analysis**: Period-over-period performance comparison
### 7.2 Reporting System
- **Automated Reports**: Scheduled performance reports
- **Custom Reports**: User-defined report creation and customization
- **Export Functionality**: Multiple export formats (PDF, CSV, Excel)
- **Report Scheduling**: Automated report delivery and distribution
- **Report Analytics**: Report usage and effectiveness tracking
### 7.3 Data Visualization
- **Interactive Charts**: Dynamic performance charts and graphs
- **Dashboard Customization**: Personalized dashboard configuration
- **Real-time Updates**: Live performance data updates
- **Visual Analytics**: Advanced data visualization and analysis
- **Performance Insights**: AI-powered performance insights and recommendations
---
## 8. SCHEDULES MODULE FEATURES
### 8.1 Automation Management
- **CRON Job Management**: Automated task scheduling and execution
- **Workflow Automation**: End-to-end process automation
- **Task Scheduling**: Flexible task scheduling and management
- **Automation Monitoring**: Automation performance tracking and optimization
- **Error Handling**: Robust error handling and recovery systems
### 8.2 Schedule Configuration
- **Custom Schedules**: User-defined automation schedules
- **Schedule Optimization**: Performance-based schedule adjustments
- **Schedule Validation**: Schedule conflict detection and resolution
- **Schedule Reporting**: Automation performance and effectiveness reports
- **Schedule Management**: Centralized schedule administration and control
### 8.3 Process Automation
- **Content Automation**: Automated content creation and publishing
- **SEO Automation**: Automated SEO optimization and monitoring
- **Link Building Automation**: Automated link building and outreach
- **Analytics Automation**: Automated reporting and analysis
- **Maintenance Automation**: Automated system maintenance and optimization
---
## 9. CORE SYSTEM FEATURES
### 9.1 Database Management
- **Custom Tables**: 15+ specialized database tables
- **Data Migration**: Seamless data migration and version management
- **Data Validation**: Comprehensive data integrity and validation
- **Performance Optimization**: Database performance tuning and optimization
- **Backup & Recovery**: Automated backup and disaster recovery systems
### 9.2 WordPress Integration
- **Post Meta Management**: Advanced post metadata handling
- **Taxonomy Integration**: Custom taxonomy creation and management
- **User Management**: User role and permission management
- **Plugin Compatibility**: WordPress plugin ecosystem integration
- **Theme Integration**: Seamless theme integration and customization
### 9.3 AI Integration
- **OpenAI Integration**: Advanced AI content generation
- **Runware Integration**: AI-powered image generation
- **Model Management**: AI model selection and optimization
- **Cost Tracking**: AI usage cost monitoring and optimization
- **Performance Monitoring**: AI service performance tracking
### 9.4 Security & Performance
- **Security Hardening**: Comprehensive security measures and protection
- **Performance Optimization**: System performance tuning and optimization
- **Error Handling**: Robust error handling and logging
- **Monitoring**: System health monitoring and alerting
- **Scalability**: High-performance, scalable architecture
---
## 10. ADVANCED FEATURES
### 10.1 Machine Learning
- **Predictive Analytics**: AI-powered performance prediction
- **Pattern Recognition**: Content and user behavior pattern analysis
- **Recommendation Engine**: Intelligent content and strategy recommendations
- **Anomaly Detection**: Unusual performance pattern identification
- **Continuous Learning**: Self-improving AI systems
### 10.2 Integration Capabilities
- **API Integration**: Third-party service integration
- **Webhook Support**: Real-time data synchronization
- **Export/Import**: Comprehensive data portability
- **Custom Integrations**: Flexible integration development
- **Data Synchronization**: Multi-platform data consistency
### 10.3 Enterprise Features
- **Multi-user Support**: Team collaboration and management
- **Role-based Access**: Granular permission and access control
- **Audit Logging**: Comprehensive activity tracking and logging
- **Compliance**: Industry standard compliance and security
- **Support**: Enterprise-level support and maintenance
---
## Technical Dependencies
### Core Dependencies
- **WordPress**: 5.0+ (Core platform)
- **PHP**: 7.4+ (Server-side language)
- **MySQL**: 5.7+ (Database system)
- **JavaScript**: ES6+ (Client-side functionality)
### AI Dependencies
- **OpenAI API**: GPT-4, GPT-3.5-turbo (Content generation)
- **Runware API**: Image generation and processing
- **cURL**: HTTP client for API communication
- **JSON**: Data format for AI communication
### WordPress Dependencies
- **WordPress Hooks**: Actions and filters
- **WordPress Database**: Custom tables and queries
- **WordPress Admin**: Admin interface integration
- **WordPress CRON**: Scheduled task management
### External Dependencies
- **cURL**: HTTP requests and API communication
- **JSON**: Data serialization and communication
- **CSV**: Data import/export functionality
- **REST API**: WordPress REST API integration
---
## File Structure Summary
### Core Files
- `igny8.php` - Main plugin file
- `install.php` - Installation script
- `uninstall.php` - Uninstallation script
- `igny8-wp-load-handler.php` - WordPress load handler
### Module Files
- `modules/modules-pages/` - Module interfaces
- `modules/components/` - Reusable components
- `modules/config/` - Configuration files
### AI Integration
- `ai/integration.php` - AI service integration
- `ai/openai-api.php` - OpenAI API client
- `ai/runware-api.php` - Runware API client
- `ai/modules-ai.php` - AI module functions
### Core System
- `core/admin/` - Admin interface
- `core/db/` - Database management
- `core/cron/` - Automation system
- `core/pages/` - Page templates
### Workflows
- `flows/` - Workflow automation
- `assets/` - Frontend assets
- `docs/` - Documentation
This comprehensive features list covers all aspects of the Igny8 AI SEO Plugin, providing a complete overview of its capabilities, dependencies, and technical architecture.

726
igny8-wp-plugin-for-reference-olny/docs/COMPLETE_FUNCTION_REFERENCE.md Normal file
View File

@@ -0,0 +1,726 @@
# Igny8 AI SEO Plugin - Complete Function Reference
## Summary Table
| Function Category | Function Count | Core Functions | Dependencies | Files Involved |
|------------------|----------------|----------------|--------------|----------------|
| **Core System** | 45+ | `igny8_init()`, `igny8_register_settings()`, `igny8_create_all_tables()` | WordPress, Database | `igny8.php`, `core/admin/init.php`, `core/db/db.php` |
| **AI Integration** | 25+ | `igny8_openai_request()`, `igny8_runware_request()`, `igny8_generate_content()` | OpenAI API, Runware API | `ai/integration.php`, `ai/openai-api.php`, `ai/runware-api.php` |
| **Database Management** | 30+ | `igny8_create_all_tables()`, `igny8_migrate_data()`, `igny8_cleanup_legacy_structures()` | MySQL, WordPress | `core/db/db.php`, `core/db/db-migration.php` |
| **Workflow Automation** | 40+ | `igny8_sync_post_meta_data()`, `igny8_inject_responsive_images_separate()`, `igny8_ajax_bulk_publish_drafts()` | WordPress, Database | `flows/sync-functions.php`, `flows/sync-ajax.php`, `flows/image-injection-responsive.php` |
| **Module Management** | 20+ | `igny8_is_module_enabled()`, `igny8_get_enabled_modules()`, `igny8_register_module()` | WordPress, Database | `core/admin/module-manager-class.php`, `core/admin/init.php` |
| **CRON Automation** | 15+ | `igny8_master_dispatcher_run()`, `igny8_process_ai_queue_cron_handler()`, `igny8_auto_cluster_cron_handler()` | WordPress CRON, Database | `core/cron/igny8-cron-master-dispatcher.php`, `core/cron/igny8-cron-handlers.php` |
| **Admin Interface** | 35+ | `igny8_render_table()`, `igny8_render_filters()`, `igny8_render_pagination()` | WordPress Admin, JavaScript | `core/admin/`, `modules/components/` |
| **Analytics & KPI** | 25+ | `igny8_get_kpi_data_safe()`, `igny8_track_metrics()`, `igny8_generate_reports()` | Database, WordPress | `core/admin/global-helpers.php`, `modules/config/kpi-config.php` |
---
## 1. CORE SYSTEM FUNCTIONS
### 1.1 Plugin Initialization Functions
#### `igny8_init()`
- **Purpose**: Main plugin initialization function
- **Dependencies**: WordPress hooks, database setup
- **Files**: `igny8.php`
- **Functionality**: Plugin setup, hook registration, module initialization
- **Returns**: Boolean success status
#### `igny8_register_settings()`
- **Purpose**: WordPress settings registration
- **Dependencies**: WordPress settings API
- **Files**: `core/admin/init.php`
- **Functionality**: Settings group and field registration
- **Returns**: Boolean registration status
#### `igny8_init_wordpress_features()`
- **Purpose**: WordPress feature initialization
- **Dependencies**: WordPress core, taxonomies, post meta
- **Files**: `core/admin/init.php`
- **Functionality**: Taxonomy registration, post meta setup
- **Returns**: Boolean initialization status
### 1.2 Database Management Functions
#### `igny8_create_all_tables()`
- **Purpose**: Create all custom database tables
- **Dependencies**: WordPress database, table schemas
- **Files**: `core/db/db.php`
- **Functionality**: Table creation, schema setup
- **Returns**: Boolean creation status
#### `igny8_register_taxonomies()`
- **Purpose**: Register custom taxonomies
- **Dependencies**: WordPress taxonomy system
- **Files**: `core/db/db.php`
- **Functionality**: Taxonomy registration, term setup
- **Returns**: Boolean registration status
#### `igny8_register_post_meta()`
- **Purpose**: Register post meta fields
- **Dependencies**: WordPress post meta system
- **Files**: `core/db/db.php`
- **Functionality**: Meta field registration, validation setup
- **Returns**: Boolean registration status
#### `igny8_set_default_options()`
- **Purpose**: Set default plugin options
- **Dependencies**: WordPress options API
- **Files**: `core/db/db.php`
- **Functionality**: Default option values setup
- **Returns**: Boolean setup status
### 1.3 Migration Functions
#### `igny8_migrate_logs_table()`
- **Purpose**: Migrate logs table structure
- **Dependencies**: Database system, migration scripts
- **Files**: `core/db/db-migration.php`
- **Functionality**: Table structure migration
- **Returns**: Boolean migration status
#### `igny8_add_word_count_to_tasks()`
- **Purpose**: Add word count column to tasks table
- **Dependencies**: Database system, table structure
- **Files**: `core/db/db-migration.php`
- **Functionality**: Column addition, data migration
- **Returns**: Boolean addition status
#### `igny8_add_tasks_count_to_content_ideas()`
- **Purpose**: Add tasks count to content ideas
- **Dependencies**: Database system, content ideas table
- **Files**: `core/db/db-migration.php`
- **Functionality**: Column addition, count calculation
- **Returns**: Boolean addition status
#### `igny8_add_image_prompts_to_content_ideas()`
- **Purpose**: Add image prompts to content ideas
- **Dependencies**: Database system, content ideas table
- **Files**: `core/db/db-migration.php`
- **Functionality**: Column addition, prompt setup
- **Returns**: Boolean addition status
#### `igny8_update_idea_description_to_longtext()`
- **Purpose**: Update idea description to longtext
- **Dependencies**: Database system, content ideas table
- **Files**: `core/db/db-migration.php`
- **Functionality**: Column type update, data preservation
- **Returns**: Boolean update status
#### `igny8_cleanup_legacy_structures()`
- **Purpose**: Clean up legacy database structures
- **Dependencies**: Database system, legacy data
- **Files**: `core/db/db-migration.php`
- **Functionality**: Legacy cleanup, data migration
- **Returns**: Boolean cleanup status
---
## 2. AI INTEGRATION FUNCTIONS
### 2.1 OpenAI API Functions
#### `igny8_openai_request()`
- **Purpose**: Make OpenAI API requests
- **Dependencies**: OpenAI API, authentication
- **Files**: `ai/openai-api.php`
- **Functionality**: API communication, response handling
- **Returns**: API response data
#### `igny8_generate_content()`
- **Purpose**: Generate AI content using OpenAI
- **Dependencies**: OpenAI API, content data
- **Files**: `ai/modules-ai.php`
- **Functionality**: Content generation, prompt processing
- **Returns**: Generated content
#### `igny8_ai_cluster_keywords()`
- **Purpose**: AI-powered keyword clustering
- **Dependencies**: OpenAI API, keyword data
- **Files**: `ai/modules-ai.php`
- **Functionality**: Semantic clustering, keyword grouping
- **Returns**: Clustered keywords
#### `igny8_ai_generate_ideas()`
- **Purpose**: Generate content ideas using AI
- **Dependencies**: OpenAI API, cluster data
- **Files**: `ai/modules-ai.php`
- **Functionality**: Idea generation, content planning
- **Returns**: Generated content ideas
### 2.2 Runware API Functions
#### `igny8_runware_request()`
- **Purpose**: Make Runware API requests
- **Dependencies**: Runware API, authentication
- **Files**: `ai/runware-api.php`
- **Functionality**: API communication, image generation
- **Returns**: API response data
#### `igny8_generate_images_for_post()`
- **Purpose**: Generate images for WordPress posts
- **Dependencies**: Runware API, post data
- **Files**: `ai/modules-ai.php`
- **Functionality**: Image generation, post integration
- **Returns**: Generated images
#### `igny8_generate_images_for_content_idea()`
- **Purpose**: Generate images for content ideas
- **Dependencies**: Runware API, content idea data
- **Files**: `ai/modules-ai.php`
- **Functionality**: Image generation, idea integration
- **Returns**: Generated images
### 2.3 AI Integration Functions
#### `igny8_get_ai_setting()`
- **Purpose**: Get AI-related settings
- **Dependencies**: WordPress options, AI configuration
- **Files**: `ai/integration.php`
- **Functionality**: Setting retrieval, configuration access
- **Returns**: AI setting value
#### `igny8_set_ai_setting()`
- **Purpose**: Set AI-related settings
- **Dependencies**: WordPress options, AI configuration
- **Files**: `ai/integration.php`
- **Functionality**: Setting storage, configuration update
- **Returns**: Boolean setting status
#### `igny8_validate_ai_response()`
- **Purpose**: Validate AI API responses
- **Dependencies**: AI APIs, response data
- **Files**: `ai/integration.php`
- **Functionality**: Response validation, error handling
- **Returns**: Boolean validation status
---
## 3. WORKFLOW AUTOMATION FUNCTIONS
### 3.1 Sync Functions
#### `igny8_sync_post_meta_data()`
- **Purpose**: Synchronize post metadata
- **Dependencies**: WordPress post meta, database
- **Files**: `flows/sync-functions.php`
- **Functionality**: Meta synchronization, data consistency
- **Returns**: Boolean sync status
#### `igny8_sync_post_meta_ajax()`
- **Purpose**: AJAX post meta synchronization
- **Dependencies**: WordPress AJAX, post meta
- **Files**: `flows/sync-ajax.php`
- **Functionality**: AJAX sync, real-time updates
- **Returns**: JSON response
#### `igny8_handle_keyword_cluster_update()`
- **Purpose**: Handle keyword cluster updates
- **Dependencies**: Database, cluster data
- **Files**: `flows/sync-functions.php`
- **Functionality**: Cluster update processing
- **Returns**: Boolean update status
### 3.2 Image Injection Functions
#### `igny8_inject_responsive_images_separate()`
- **Purpose**: Inject responsive images into posts
- **Dependencies**: WordPress posts, image data
- **Files**: `flows/image-injection-responsive.php`
- **Functionality**: Image injection, responsive setup
- **Returns**: Boolean injection status
#### `igny8_process_image_injection()`
- **Purpose**: Process image injection workflow
- **Dependencies**: Post data, image data
- **Files**: `flows/image-injection-responsive.php`
- **Functionality**: Injection processing, workflow management
- **Returns**: Boolean processing status
### 3.3 AJAX Functions
#### `igny8_ajax_bulk_publish_drafts()`
- **Purpose**: Bulk publish drafts via AJAX
- **Dependencies**: WordPress AJAX, post data
- **Files**: `core/admin/ajax.php`
- **Functionality**: Bulk publishing, progress tracking
- **Returns**: JSON response
#### `igny8_ajax_sync_post_meta()`
- **Purpose**: AJAX post meta synchronization
- **Dependencies**: WordPress AJAX, post meta
- **Files**: `flows/sync-ajax.php`
- **Functionality**: Real-time sync, data updates
- **Returns**: JSON response
---
## 4. MODULE MANAGEMENT FUNCTIONS
### 4.1 Module Manager Functions
#### `igny8_is_module_enabled()`
- **Purpose**: Check if module is enabled
- **Dependencies**: Module manager, module data
- **Files**: `core/admin/module-manager-class.php`
- **Functionality**: Module status checking
- **Returns**: Boolean enabled status
#### `igny8_get_enabled_modules()`
- **Purpose**: Get all enabled modules
- **Dependencies**: Module manager, module data
- **Files**: `core/admin/module-manager-class.php`
- **Functionality**: Module listing, status filtering
- **Returns**: Array of enabled modules
#### `igny8_register_module()`
- **Purpose**: Register new module
- **Dependencies**: Module manager, module data
- **Files**: `core/admin/module-manager-class.php`
- **Functionality**: Module registration, configuration
- **Returns**: Boolean registration status
#### `igny8_get_module_config()`
- **Purpose**: Get module configuration
- **Dependencies**: Module manager, module data
- **Files**: `core/admin/module-manager-class.php`
- **Functionality**: Configuration retrieval
- **Returns**: Module configuration array
### 4.2 Module Initialization Functions
#### `igny8_init_modules()`
- **Purpose**: Initialize all modules
- **Dependencies**: Module manager, module data
- **Files**: `core/admin/module-manager-class.php`
- **Functionality**: Module initialization, setup
- **Returns**: Boolean initialization status
#### `igny8_load_module()`
- **Purpose**: Load specific module
- **Dependencies**: Module manager, module files
- **Files**: `core/admin/module-manager-class.php`
- **Functionality**: Module loading, file inclusion
- **Returns**: Boolean load status
---
## 5. CRON AUTOMATION FUNCTIONS
### 5.1 Master Dispatcher Functions
#### `igny8_master_dispatcher_run()`
- **Purpose**: Run master CRON dispatcher
- **Dependencies**: WordPress CRON, automation data
- **Files**: `core/cron/igny8-cron-master-dispatcher.php`
- **Functionality**: CRON orchestration, task management
- **Returns**: Boolean execution status
#### `igny8_get_defined_cron_jobs()`
- **Purpose**: Get all defined CRON jobs
- **Dependencies**: CRON configuration, job data
- **Files**: `core/cron/igny8-cron-master-dispatcher.php`
- **Functionality**: Job listing, configuration retrieval
- **Returns**: Array of CRON jobs
#### `igny8_check_cron_health()`
- **Purpose**: Check CRON system health
- **Dependencies**: CRON system, health data
- **Files**: `core/cron/igny8-cron-master-dispatcher.php`
- **Functionality**: Health monitoring, status checking
- **Returns**: Health status array
### 5.2 CRON Handler Functions
#### `igny8_process_ai_queue_cron_handler()`
- **Purpose**: Process AI queue via CRON
- **Dependencies**: AI queue, CRON system
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Queue processing, AI task execution
- **Returns**: Boolean processing status
#### `igny8_auto_cluster_cron_handler()`
- **Purpose**: Auto cluster keywords via CRON
- **Dependencies**: Keyword data, clustering system
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Automated clustering, keyword processing
- **Returns**: Boolean clustering status
#### `igny8_auto_generate_ideas_cron_handler()`
- **Purpose**: Auto generate ideas via CRON
- **Dependencies**: Cluster data, idea generation
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Automated idea generation
- **Returns**: Boolean generation status
#### `igny8_auto_queue_cron_handler()`
- **Purpose**: Auto queue tasks via CRON
- **Dependencies**: Task data, queue system
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Automated task queuing
- **Returns**: Boolean queuing status
#### `igny8_auto_generate_content_cron_handler()`
- **Purpose**: Auto generate content via CRON
- **Dependencies**: Content data, generation system
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Automated content generation
- **Returns**: Boolean generation status
#### `igny8_auto_publish_drafts_cron_handler()`
- **Purpose**: Auto publish drafts via CRON
- **Dependencies**: Draft data, publishing system
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Automated draft publishing
- **Returns**: Boolean publishing status
#### `igny8_auto_optimizer_cron_handler()`
- **Purpose**: Auto optimize content via CRON
- **Dependencies**: Content data, optimization system
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Automated content optimization
- **Returns**: Boolean optimization status
#### `igny8_auto_recalc_cron_handler()`
- **Purpose**: Auto recalculate metrics via CRON
- **Dependencies**: Metric data, calculation system
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Automated metric recalculation
- **Returns**: Boolean calculation status
#### `igny8_health_check_cron_handler()`
- **Purpose**: Health check via CRON
- **Dependencies**: System data, health monitoring
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: System health monitoring
- **Returns**: Boolean health status
#### `igny8_auto_generate_images_cron_handler()`
- **Purpose**: Auto generate images via CRON
- **Dependencies**: Image data, generation system
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Automated image generation
- **Returns**: Boolean generation status
### 5.3 CRON Utility Functions
#### `igny8_safe_create_term()`
- **Purpose**: Safely create taxonomy terms
- **Dependencies**: WordPress taxonomy, term data
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Term creation, error handling
- **Returns**: Term ID or false
#### `igny8_safe_create_cluster_term()`
- **Purpose**: Safely create cluster terms
- **Dependencies**: WordPress taxonomy, cluster data
- **Files**: `core/cron/igny8-cron-handlers.php`
- **Functionality**: Cluster term creation, error handling
- **Returns**: Term ID or false
---
## 6. ADMIN INTERFACE FUNCTIONS
### 6.1 Table Rendering Functions
#### `igny8_render_table()`
- **Purpose**: Render data tables
- **Dependencies**: Table data, configuration
- **Files**: `modules/components/table-tpl.php`
- **Functionality**: Table rendering, data display
- **Returns**: HTML table output
#### `igny8_render_filters()`
- **Purpose**: Render table filters
- **Dependencies**: Filter data, configuration
- **Files**: `modules/components/filters-tpl.php`
- **Functionality**: Filter rendering, user interface
- **Returns**: HTML filter output
#### `igny8_render_pagination()`
- **Purpose**: Render table pagination
- **Dependencies**: Pagination data, configuration
- **Files**: `modules/components/pagination-tpl.php`
- **Functionality**: Pagination rendering, navigation
- **Returns**: HTML pagination output
#### `igny8_render_table_actions()`
- **Purpose**: Render table actions
- **Dependencies**: Action data, configuration
- **Files**: `modules/components/actions-tpl.php`
- **Functionality**: Action rendering, user interface
- **Returns**: HTML action output
### 6.2 Form Rendering Functions
#### `igny8_render_forms()`
- **Purpose**: Render forms
- **Dependencies**: Form data, configuration
- **Files**: `modules/components/forms-tpl.php`
- **Functionality**: Form rendering, user interface
- **Returns**: HTML form output
#### `igny8_render_import_modal()`
- **Purpose**: Render import modal
- **Dependencies**: Import data, configuration
- **Files**: `modules/components/import-modal-tpl.php`
- **Functionality**: Import modal rendering
- **Returns**: HTML modal output
#### `igny8_render_export_modal()`
- **Purpose**: Render export modal
- **Dependencies**: Export data, configuration
- **Files**: `modules/components/export-modal-tpl.php`
- **Functionality**: Export modal rendering
- **Returns**: HTML modal output
### 6.3 KPI Rendering Functions
#### `igny8_render_kpi()`
- **Purpose**: Render KPI displays
- **Dependencies**: KPI data, configuration
- **Files**: `modules/components/kpi-tpl.php`
- **Functionality**: KPI rendering, metrics display
- **Returns**: HTML KPI output
---
## 7. ANALYTICS & KPI FUNCTIONS
### 7.1 KPI Data Functions
#### `igny8_get_kpi_data_safe()`
- **Purpose**: Safely get KPI data
- **Dependencies**: Database, KPI configuration
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: KPI data retrieval, error handling
- **Returns**: KPI data array
#### `igny8_calculate_kpi_metrics()`
- **Purpose**: Calculate KPI metrics
- **Dependencies**: Raw data, calculation algorithms
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Metric calculation, data processing
- **Returns**: Calculated metrics array
#### `igny8_track_metrics()`
- **Purpose**: Track performance metrics
- **Dependencies**: Performance data, tracking system
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Metric tracking, data storage
- **Returns**: Boolean tracking status
### 7.2 Analytics Functions
#### `igny8_analyze_performance()`
- **Purpose**: Analyze performance data
- **Dependencies**: Performance data, analysis algorithms
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Performance analysis, insights generation
- **Returns**: Analysis results array
#### `igny8_generate_reports()`
- **Purpose**: Generate analytics reports
- **Dependencies**: Analytics data, report templates
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Report generation, data visualization
- **Returns**: Generated reports
#### `igny8_visualize_data()`
- **Purpose**: Visualize analytics data
- **Dependencies**: Analytics data, visualization tools
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Data visualization, chart generation
- **Returns**: Visualized data
---
## 8. UTILITY FUNCTIONS
### 8.1 Helper Functions
#### `igny8_get_cluster_term_name()`
- **Purpose**: Get cluster term name
- **Dependencies**: WordPress taxonomy, term data
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Term name retrieval
- **Returns**: Term name string
#### `igny8_get_cluster_options()`
- **Purpose**: Get cluster options for dropdowns
- **Dependencies**: Cluster data, taxonomy
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Options generation, dropdown data
- **Returns**: Options array
#### `igny8_get_dynamic_table_config()`
- **Purpose**: Get dynamic table configuration
- **Dependencies**: Table data, configuration
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Configuration generation, table setup
- **Returns**: Table configuration array
#### `igny8_get_difficulty_range_name()`
- **Purpose**: Get difficulty range name
- **Dependencies**: Difficulty data, range configuration
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Range name retrieval
- **Returns**: Range name string
### 8.2 Logging Functions
#### `igny8_write_log()`
- **Purpose**: Write to log system
- **Dependencies**: Logging system, log data
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Log writing, error tracking
- **Returns**: Boolean log status
#### `igny8_log_error()`
- **Purpose**: Log errors
- **Dependencies**: Error data, logging system
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Error logging, debugging
- **Returns**: Boolean log status
#### `igny8_log_debug()`
- **Purpose**: Log debug information
- **Dependencies**: Debug data, logging system
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Debug logging, troubleshooting
- **Returns**: Boolean log status
### 8.3 Validation Functions
#### `igny8_validate_record()`
- **Purpose**: Validate database records
- **Dependencies**: Record data, validation rules
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Record validation, data integrity
- **Returns**: Boolean validation status
#### `igny8_validate_foreign_key()`
- **Purpose**: Validate foreign key relationships
- **Dependencies**: Key data, relationship rules
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Foreign key validation
- **Returns**: Boolean validation status
#### `igny8_sanitize_data()`
- **Purpose**: Sanitize input data
- **Dependencies**: Input data, sanitization rules
- **Files**: `core/admin/global-helpers.php`
- **Functionality**: Data sanitization, security
- **Returns**: Sanitized data
---
## 9. FRONTEND FUNCTIONS
### 9.1 JavaScript Functions
#### `igny8_init_table()`
- **Purpose**: Initialize data tables
- **Dependencies**: JavaScript, table data
- **Files**: `assets/js/core.js`
- **Functionality**: Table initialization, user interface
- **Returns**: Boolean initialization status
#### `igny8_handle_ajax()`
- **Purpose**: Handle AJAX requests
- **Dependencies**: JavaScript, AJAX data
- **Files**: `assets/js/core.js`
- **Functionality**: AJAX handling, data processing
- **Returns**: AJAX response
#### `igny8_process_image_queue()`
- **Purpose**: Process image generation queue
- **Dependencies**: JavaScript, image data
- **Files**: `assets/js/image-queue-processor.js`
- **Functionality**: Queue processing, progress tracking
- **Returns**: Boolean processing status
### 9.2 CSS Functions
#### `igny8_load_styles()`
- **Purpose**: Load CSS styles
- **Dependencies**: CSS files, styling data
- **Files**: `assets/css/core.css`
- **Functionality**: Style loading, visual presentation
- **Returns**: Boolean load status
#### `igny8_apply_responsive_design()`
- **Purpose**: Apply responsive design
- **Dependencies**: CSS, responsive data
- **Files**: `assets/css/core.css`
- **Functionality**: Responsive design application
- **Returns**: Boolean application status
---
## 10. INTEGRATION FUNCTIONS
### 10.1 WordPress Integration
#### `igny8_integrate_wordpress()`
- **Purpose**: Integrate with WordPress core
- **Dependencies**: WordPress hooks, core functions
- **Files**: `igny8.php`, `core/admin/init.php`
- **Functionality**: WordPress integration, hook registration
- **Returns**: Boolean integration status
#### `igny8_register_hooks()`
- **Purpose**: Register WordPress hooks
- **Dependencies**: WordPress hooks, action/filter system
- **Files**: `flows/sync-hooks.php`
- **Functionality**: Hook registration, event handling
- **Returns**: Boolean registration status
### 10.2 API Integration
#### `igny8_integrate_apis()`
- **Purpose**: Integrate with external APIs
- **Dependencies**: API credentials, HTTP client
- **Files**: `ai/integration.php`
- **Functionality**: API integration, data exchange
- **Returns**: Boolean integration status
#### `igny8_handle_api_errors()`
- **Purpose**: Handle API errors
- **Dependencies**: API responses, error handling
- **Files**: `ai/integration.php`
- **Functionality**: Error handling, recovery
- **Returns**: Boolean error handling status
---
## Function Dependencies Summary
### Core Dependencies
- **WordPress**: Hooks, actions, filters, database
- **PHP**: Core language functions, extensions
- **MySQL**: Database operations, queries
- **JavaScript**: Client-side functionality, AJAX
### External Dependencies
- **OpenAI API**: Content generation, AI processing
- **Runware API**: Image generation, visual content
- **cURL**: HTTP communication, API requests
- **JSON**: Data serialization, API communication
### Internal Dependencies
- **Database Layer**: Custom tables, queries, migrations
- **Module System**: Module management, configuration
- **CRON System**: Automation, scheduled tasks
- **Admin Interface**: User interface, data management
### File Structure Dependencies
- **Core Files**: Plugin initialization, system setup
- **Module Files**: Feature-specific implementations
- **AI Files**: AI service integrations
- **Workflow Files**: Process automation, data sync
- **Asset Files**: Frontend resources, styling
This comprehensive function reference covers all aspects of the Igny8 AI SEO Plugin's function library, providing detailed information about each function's purpose, dependencies, and implementation details.

476
igny8-wp-plugin-for-reference-olny/docs/COMPLETE_IMAGE_GENERATION_AUDIT.md Normal file
View File

@@ -0,0 +1,476 @@
# Complete Image Generation Process Audit
## Summary
This document provides a comprehensive audit of the current image generation process in the Igny8 AI SEO plugin. The system has been reorganized with image generation functions moved to a dedicated module and improved queue processing.
### Files Involved
- **`ai/writer/images/image-generation.php`** - Main image generation functions (featured & article images)
- **`core/admin/ajax.php`** - AJAX handlers for image generation requests
- **`assets/js/image-queue-processor.js`** - JavaScript queue processing and UI
- **`ai/modules-ai.php`** - Content generation response handler (saves image prompts)
- **`ai/openai-api.php`** - OpenAI DALL-E API integration
- **`ai/runware-api.php`** - Runware API integration
### Functions and Purposes
- **`igny8_generate_featured_image_for_post()`** - Generates featured images using AI prompts
- **`igny8_generate_single_article_image()`** - Generates in-article images for specific sections
- **`igny8_ajax_ai_generate_single_image()`** - AJAX handler for single image generation
- **`igny8_add_inarticle_image_meta()`** - Saves image metadata to post meta
- **`igny8_format_image_prompts_for_ai()`** - Formats image prompts for AI content generation
- **`igny8_create_post_from_ai_response()`** - Saves image prompts from AI response
## Overview
This document provides a comprehensive audit of the image generation process in the Igny8 AI SEO plugin, covering every function, hook, setting, and data flow from button click to final image save.
## 1. Entry Point - Generate Images Button
### Location
- **File**: `modules/components/actions-tpl.php`
- **Lines**: 42-45
- **Button ID**: `writer_drafts_generate_images_btn`
- **HTML**:
```html
<button id="writer_drafts_generate_images_btn" class="igny8-btn igny8-btn-accent" disabled>
<span class="dashicons dashicons-format-image"></span> Generate Images
</button>
```
### JavaScript Event Handler
- **File**: `assets/js/image-queue-processor.js`
- **Function**: `processAIImageGenerationDrafts(postIds)`
- **Lines**: 7-84
- **Validation**: Max 10 posts, requires selection
## 2. JavaScript Processing Flow
### Main Processing Function
- **File**: `assets/js/image-queue-processor.js`
- **Function**: `processAIImageGenerationDrafts(postIds)`
- **Lines**: 7-84
### Settings Retrieved
```javascript
const desktopEnabled = window.IGNY8_PAGE?.imageSettings?.desktop_enabled || false;
const mobileEnabled = window.IGNY8_PAGE?.imageSettings?.mobile_enabled || false;
const maxInArticleImages = window.IGNY8_PAGE?.imageSettings?.max_in_article_images || 1;
```
### Image Calculation
- **Featured Images**: Always 1 per post
- **Desktop Images**: `maxInArticleImages` per post (if enabled)
- **Mobile Images**: `maxInArticleImages` per post (if enabled)
- **Total**: `postIds.length * imagesPerPost`
### Queue Processing
- **Sequential Processing**: One image at a time to avoid API limits
- **Progress Tracking**: Real-time progress updates with individual progress bars
- **Error Handling**: Continue processing on individual failures
- **Modal Display**: Shows progress for each image being generated
## 3. AJAX Handlers
### Primary Handler
- **File**: `core/admin/ajax.php`
- **Function**: `igny8_ajax_ai_generate_images_drafts()`
- **Lines**: 2913-3150
- **Hook**: `wp_ajax_igny8_ai_generate_images_drafts`
### Single Image Handler
- **File**: `core/admin/ajax.php`
- **Function**: `igny8_ajax_ai_generate_single_image()`
- **Lines**: 3283-3350
- **Hook**: `wp_ajax_igny8_ai_generate_single_image`
- **Process**:
1. Validates task ID and retrieves WordPress post ID
2. Calls appropriate generation function based on type
3. Saves image metadata to post meta
4. Returns success/error response
### Supporting Handlers
- **Image Counts**: `igny8_ajax_get_image_counts()` (Lines 2645-2809)
- **Single Image Queue**: `igny8_ajax_generate_single_image_queue()` (Lines 2814-2908)
- **Settings Save**: `igny8_ajax_save_image_settings()` (Lines 4408-4457)
- **Template Save**: `igny8_ajax_save_image_prompt_template()` (Lines 4461-4505)
## 4. Settings and Configuration
### WordPress Options
| **Option** | **Default** | **Purpose** |
|------------|-------------|-------------|
| `igny8_desktop_enabled` | `'1'` | Enable desktop image generation |
| `igny8_mobile_enabled` | `'0'` | Enable mobile image generation |
| `igny8_max_in_article_images` | `1` | Maximum in-article images per post |
| `igny8_image_type` | `'realistic'` | Image style type |
| `igny8_image_provider` | `'runware'` | AI provider for image generation |
| `igny8_image_format` | `'jpg'` | Output image format |
| `igny8_negative_prompt` | `'text, watermark, logo, overlay, title, caption, writing on walls, writing on objects, UI, infographic elements, post title'` | Negative prompt for image generation |
| `igny8_image_prompt_template` | `'Create a high-quality {image_type} image to use as a featured photo for a blog post titled "{post_title}". The image should visually represent the theme, mood, and subject implied by the image prompt: {image_prompt}. Focus on a realistic, well-composed scene that naturally communicates the topic without text or logos. Use balanced lighting, pleasing composition, and photographic detail suitable for lifestyle or editorial web content. Avoid adding any visible or readable text, brand names, or illustrative effects. **And make sure image is not blurry.**'` | Image prompt template |
### Settings Page
- **File**: `modules/settings/general-settings.php`
- **Lines**: 309-462
- **Form Fields**: Desktop/Mobile toggles, Max images dropdown, Image type, Provider, Format, Negative prompt, Template
## 5. Image Generation Functions
### Core Generation Functions
- **File**: `ai/writer/images/image-generation.php`
#### Featured Image Generation
- **Function**: `igny8_generate_featured_image_for_post($post_id, $image_size_type = 'featured')`
- **Lines**: 24-200
- **Process**:
1. Get featured image prompt from `_igny8_featured_image_prompt`
2. Get image generation settings from WordPress options
3. Build final prompt using template with placeholders
4. Call AI provider (Runware/OpenAI) with appropriate dimensions
5. Download image from AI provider URL
6. Upload via `media_handle_sideload()`
7. Set as featured image with `set_post_thumbnail()`
8. Generate attachment metadata
#### In-Article Image Generation
- **Function**: `igny8_generate_single_article_image($post_id, $device_type = 'desktop', $index = 1)`
- **Lines**: 202-400
- **Process**:
1. Get article image prompts from `_igny8_article_images_data`
2. Extract prompt for specific index (`prompt-img-1`, `prompt-img-2`, etc.)
3. Get image generation settings from WordPress options
4. Build final prompt using template with placeholders
5. Call AI provider with device-specific dimensions
6. Download image from AI provider URL
7. Upload via `media_handle_sideload()`
8. Return attachment ID and metadata
### Supporting Functions
- **Image Dimensions**: `igny8_get_image_dimensions($size_preset, $provider)` (Lines 1526-1558 in ai/modules-ai.php)
- **Safe Quantity**: `igny8_calculate_safe_image_quantity($idea_data, $max_in_article_images)` (Lines 918-933 in ai/modules-ai.php)
- **Image Meta**: `igny8_add_inarticle_image_meta($post_id, $attachment_id, $label, $device, $section)` (Lines 933-963 in ai/modules-ai.php)
## 6. AI Provider Integration
### Runware API Integration
- **File**: `ai/runware-api.php`
- **Function**: `igny8_runway_generate_image($prompt, $negative_prompt, $width, $height, $steps, $cfg_scale, $number_results, $output_format)`
- **API Endpoint**: `https://api.runware.ai/v1`
- **Authentication**: API key via `igny8_runware_api_key` option
- **Model**: `runware:97@1` (HiDream-I1 Full)
- **Request Format**:
```json
[
{
"taskType": "authentication",
"apiKey": "api_key_here"
},
{
"taskType": "imageInference",
"taskUUID": "uuid_here",
"positivePrompt": "prompt_text",
"negativePrompt": "negative_prompt",
"model": "runware:97@1",
"width": 1024,
"height": 1024,
"steps": 30,
"CFGScale": 7.5,
"numberResults": 1,
"outputFormat": "jpg"
}
]
```
- **Response Handling**: Extract `data[0].imageURL` from response
- **Error Handling**: Log API errors, return error messages
### OpenAI DALL-E Integration
- **File**: `ai/openai-api.php`
- **Function**: `igny8_call_openai_images($prompt, $api_key, $model, $size, $quality, $style)`
- **API Endpoint**: `https://api.openai.com/v1/images/generations`
- **Authentication**: API key via `igny8_api_key` option
- **Model**: `dall-e-3`
- **Request Format**:
```json
{
"model": "dall-e-3",
"prompt": "prompt_text",
"n": 1,
"size": "1024x1024",
"quality": "standard",
"style": "natural"
}
```
- **Response Handling**: Extract `data[0].url` from response
- **Error Handling**: Log API errors, return error messages
### Provider Detection and Selection
- **Settings**: `igny8_image_provider` option (`runware` or `openai`)
- **API Key Validation**: Check `igny8_runware_api_key` or `igny8_api_key`
- **Dynamic Selection**: Based on user settings in prompts page
- **Fallback Handling**: Return error if required API key not configured
### Image Dimensions by Provider
- **Runware Dimensions**:
- Featured: 1280x832
- Desktop: 1024x1024
- Mobile: 960x1280
- **OpenAI Dimensions**:
- Featured: 1024x1024
- Desktop: 1024x1024
- Mobile: 1024x1024
## 7. Data Storage and Meta Keys
### Post Meta Keys
| **Meta Key** | **Purpose** | **Data Type** |
|--------------|-------------|---------------|
| `_igny8_featured_image_prompt` | Featured image AI prompt | Text |
| `_igny8_article_images_data` | In-article image prompts | JSON Array |
| `_igny8_inarticle_images` | Generated image metadata | JSON Object |
### Image Prompts Data Structure
```json
[
{
"prompt-img-1": "A close-up of a neatly made bed showcasing a well-fitted duvet cover that enhances the aesthetic of the room."
},
{
"prompt-img-2": "An image of tools laid out for measuring a duvet insert, including a measuring tape, notepad, and a flat surface."
},
{
"prompt-img-3": "A detailed size chart displaying different duvet cover sizes alongside their corresponding duvet insert dimensions."
},
{
"prompt-img-4": "An infographic illustrating common mistakes when choosing duvet covers, highlighting shrinkage risks and misreading labels."
}
]
```
### Image Metadata Structure
```json
{
"desktop-1": {
"label": "desktop-1",
"attachment_id": 1825,
"url": "https://example.com/image.jpg",
"device": "desktop",
"section": 1
},
"mobile-1": {
"label": "mobile-1",
"attachment_id": 1826,
"url": "https://example.com/image2.jpg",
"device": "mobile",
"section": 1
}
}
```
## 8. Image Processing Workflow
### Step-by-Step Process
1. **Button Click**: User selects posts and clicks "Generate Images"
2. **Validation**: Check selection count (max 10), get settings
3. **Queue Building**: Build image queue with featured and in-article images
4. **Progress Modal**: Show progress with individual progress bars
5. **Sequential Processing**: Process each image individually
6. **Image Generation**: For each image:
- Get prompt from appropriate meta field
- Call AI provider with settings
- Download image from provider URL
- Upload to WordPress Media Library
- Save metadata to post meta
7. **Progress Updates**: Update UI with success/failure status
8. **Completion**: Show final results
### Error Handling
- **Download Failures**: Log errors, continue with next image
- **Upload Failures**: Log errors, return failure status
- **API Failures**: Log errors, return failure status
- **Progress Tracking**: Update modal with success/failure counts
- **JSON Parsing**: Handle HTML content in prompts with `wp_strip_all_tags()`
## 9. Content Generation Integration
### Image Prompts in Content Generation
- **File**: `ai/modules-ai.php`
- **Function**: `igny8_create_post_from_ai_response($ai_response)`
- **Lines**: 1119-1462
- **Process**:
1. AI generates content with image prompts
2. Featured image prompt saved to `_igny8_featured_image_prompt`
3. In-article image prompts saved to `_igny8_article_images_data`
4. HTML tags stripped from prompts using `wp_strip_all_tags()`
5. JSON structure validated and saved
### Prompt Template Processing
- **Template**: Uses `{image_type}`, `{post_title}`, `{image_prompt}` placeholders
- **Replacement**: Dynamic replacement with actual values
- **Settings Integration**: Uses all settings from prompts page
## 10. Image Generation Queue Mechanism
### Queue Processing
- **File**: `assets/js/image-queue-processor.js`
- **Function**: `processAIImageGenerationDrafts(postIds)`
- **Lines**: 7-84
- **Process**: Sequential image generation with progress tracking
### Queue Features
- **Sequential Processing**: One image at a time to avoid API limits
- **Progress Tracking**: Real-time progress updates with individual bars
- **Error Handling**: Continue processing on individual failures
- **Batch Management**: Handle multiple posts with image counts
- **Modal Display**: Shows detailed progress for each image
### Queue Handler
- **File**: `core/admin/ajax.php`
- **Function**: `igny8_ajax_ai_generate_single_image()`
- **Lines**: 3283-3350
- **Hook**: `wp_ajax_igny8_ai_generate_single_image`
## 11. Debug and Logging
### Debug Functions
- **File**: `debug/module-debug.php`
- **Lines**: 1185-1221 (HTML), 1447-1613 (JavaScript)
- **Features**:
- Image generation logs interface
- Refresh/clear buttons (`refresh-image-gen`, `clear-image-gen`)
- Real-time event display (`image-gen-events`)
- Status messages (`image-gen-message`, `image-gen-details`)
- Global debug function (`window.addImageGenDebugLog`)
### Comprehensive Logging System
- **Event-Based Logging**: `IMAGE_GEN_EVENT_1` through `IMAGE_GEN_EVENT_9`
- **Debug Events Array**: `$debug_events[]` for detailed tracking
- **Error Logging**: `error_log()` with specific prefixes
- **AI Event Logging**: `igny8_log_ai_event()` for AI interactions
### Logging Points
- **AJAX Entry**: `error_log('Igny8: AJAX HANDLER CALLED - igny8_ajax_ai_generate_images_drafts')`
- **Task Validation**: `error_log('Igny8: IMAGE_GEN_EVENT_3 - Task IDs validated')`
- **Post Retrieval**: `error_log('Igny8: IMAGE_GEN_EVENT_4 - WordPress post IDs retrieved')`
- **Image Prompts**: `error_log('Igny8: IMAGE_GEN_EVENT_5 - Image prompts loaded')`
- **Featured Generation**: `error_log('Igny8: IMAGE_GEN_EVENT_6 - Featured image generation initiated')`
- **API Requests**: `error_log('Igny8: IMAGE_GEN_EVENT_7 - API request sent')`
- **Image URLs**: `error_log('Igny8: IMAGE_GEN_EVENT_8 - Image URL received')`
- **WordPress Save**: `error_log('Igny8: IMAGE_GEN_EVENT_9 - Saving image to WordPress')`
- **Success/Failure**: `error_log('Igny8: IMAGE_GEN_EVENT_9_SUCCESS/ERROR')`
## 12. File Dependencies
### Core Files
- `ai/writer/images/image-generation.php` - Main image generation functions
- `core/admin/ajax.php` - AJAX handlers
- `assets/js/image-queue-processor.js` - Queue processing JavaScript
- `ai/modules-ai.php` - Content generation response handler
- `ai/openai-api.php` - OpenAI DALL-E API integration
- `ai/runware-api.php` - Runware API integration
### Settings Files
- `modules/settings/general-settings.php` - Main image generation settings page
- `modules/thinker/prompts.php` - Image prompt templates only
- `modules/thinker/image-testing.php` - Image testing interface
- `modules/modules-pages/writer.php` - Settings localization
### Debug Files
- `debug/module-debug.php` - Debug interface
## 13. Hooks and Actions
### WordPress Hooks
- `wp_ajax_igny8_ai_generate_images_drafts` - Main generation handler
- `wp_ajax_igny8_ai_generate_single_image` - Single image handler
- `wp_ajax_igny8_generate_single_image_queue` - Queue handler
- `wp_ajax_igny8_get_image_counts` - Image count preview
- `wp_ajax_igny8_save_image_settings` - Settings save
- `wp_ajax_igny8_save_image_prompt_template` - Template save
- `wp_ajax_igny8_reset_image_prompt_template` - Template reset
### Internal Hooks
- `transition_post_status` - Post status changes
- `save_post` - Post save events
## 14. Security Considerations
### Nonce Verification
- All AJAX handlers verify nonces
- Settings forms use proper nonce fields
- User capability checks for admin functions
### Data Sanitization
- All input data sanitized with `sanitize_text_field()`
- File uploads handled via WordPress functions
- Image URLs validated before processing
- HTML tags stripped from prompts using `wp_strip_all_tags()`
## 15. Performance Considerations
### Sequential Processing
- Images generated one at a time to avoid API limits
- Progress tracking for user feedback
- Error handling to continue processing
### Media Library Integration
- Proper WordPress Media Library registration
- Automatic thumbnail generation
- Metadata attachment for SEO
## 16. Complete Function Reference
### AJAX Handlers
- `igny8_ajax_ai_generate_images_drafts()` - Main generation
- `igny8_ajax_ai_generate_single_image()` - Single image
- `igny8_ajax_generate_single_image_queue()` - Queue processing
- `igny8_ajax_get_image_counts()` - Count preview
- `igny8_ajax_save_image_settings()` - Settings save
- `igny8_ajax_save_image_prompt_template()` - Template save
- `igny8_ajax_reset_image_prompt_template()` - Template reset
### Generation Functions
- `igny8_generate_featured_image_for_post()` - Featured image
- `igny8_generate_single_article_image()` - In-article image
- `igny8_get_image_dimensions()` - Size calculation
- `igny8_calculate_safe_image_quantity()` - Quantity safety
### Content Functions
- `igny8_add_inarticle_image_meta()` - Image metadata saving
- `igny8_format_image_prompts_for_ai()` - Prompt formatting
- `igny8_create_post_from_ai_response()` - Content generation response handler
### Queue Processing Functions
- `processAIImageGenerationDrafts()` - Main queue processor
- `generateAllImagesForPost()` - Single post processing
- `updateProgressModal()` - Progress updates
### API Functions
- `igny8_runway_generate_image()` - Runware API integration
- `igny8_call_openai_images()` - OpenAI DALL-E API integration
### Settings Functions
- `igny8_ajax_save_image_settings()` - Settings save
- `igny8_ajax_save_image_prompt_template()` - Template save
- `igny8_ajax_reset_image_prompt_template()` - Template reset
## 17. Recent Changes and Improvements
### Code Reorganization
- **Image generation functions moved** from `ai/modules-ai.php` to `ai/writer/images/image-generation.php`
- **Dedicated module** for image generation functionality
- **Improved separation of concerns** between content generation and image generation
### Enhanced Error Handling
- **JSON parsing improvements** with HTML tag stripping
- **Better error messages** for debugging
- **Graceful fallbacks** for API failures
### Improved Queue Processing
- **Individual progress bars** for each image
- **Better error tracking** and reporting
- **Enhanced user feedback** during processing
### Settings Integration
- **Dynamic settings** from prompts page
- **Template-based prompts** with placeholder replacement
- **Provider selection** with appropriate API key validation
This audit covers every aspect of the current image generation process from initial button click to final image storage and metadata saving, including the complete queue mechanism, settings integration, and content generation workflow.

723
igny8-wp-plugin-for-reference-olny/docs/COMPLETE_WORKFLOWS_DOCUMENTATION.md Normal file
View File

@@ -0,0 +1,723 @@
# Igny8 AI SEO Plugin - Complete Workflows Documentation
## Summary Table
| Workflow | Process Steps | Functions Involved | Dependencies | Files Involved |
|----------|---------------|-------------------|--------------|----------------|
| **Content Planning** | Keyword Research → Clustering → Ideas → Queue | `igny8_research_keywords()`, `igny8_ai_cluster_keywords()`, `igny8_ai_generate_ideas()`, `igny8_queue_ideas_to_writer()` | OpenAI API, Database, WordPress | `modules/modules-pages/planner.php`, `ai/modules-ai.php`, `flows/sync-functions.php` |
| **Content Creation** | Task Creation → AI Generation → Draft Review → Publishing | `igny8_create_task()`, `igny8_generate_content()`, `igny8_review_draft()`, `igny8_publish_content()` | AI APIs, WordPress, Database | `modules/modules-pages/writer.php`, `ai/modules-ai.php`, `flows/sync-functions.php` |
| **SEO Optimization** | Content Analysis → Suggestions → Implementation → Monitoring | `igny8_analyze_content()`, `igny8_generate_suggestions()`, `igny8_implement_optimizations()`, `igny8_monitor_performance()` | SEO APIs, Database | `modules/modules-pages/optimizer.php`, `ai/modules-ai.php` |
| **Link Building** | Campaign Planning → Outreach → Tracking → Analysis | `igny8_plan_campaign()`, `igny8_manage_outreach()`, `igny8_track_backlinks()`, `igny8_analyze_results()` | External APIs, Database | `modules/modules-pages/linker.php`, `flows/sync-functions.php` |
| **Content Personalization** | Field Detection → Content Rewriting → Frontend Display → Analytics | `igny8_detect_fields()`, `igny8_rewrite_content()`, `igny8_display_personalized()`, `igny8_track_personalization()` | OpenAI API, Frontend | `modules/modules-pages/personalize/`, `ai/integration.php` |
| **Automation Workflows** | Schedule Setup → Task Execution → Monitoring → Optimization | `igny8_schedule_tasks()`, `igny8_execute_automation()`, `igny8_monitor_automation()`, `igny8_optimize_automation()` | WordPress CRON, Database | `core/cron/`, `core/pages/settings/schedules.php` |
| **Analytics & Reporting** | Data Collection → Analysis → Visualization → Reporting | `igny8_collect_metrics()`, `igny8_analyze_data()`, `igny8_visualize_results()`, `igny8_generate_reports()` | Database, WordPress | `core/admin/`, `modules/config/kpi-config.php` |
---
## 1. CONTENT PLANNING WORKFLOW
### 1.1 Keyword Research Process
#### Step 1: Keyword Import
- **Function**: `igny8_import_keywords()`
- **Process**: CSV file upload and validation
- **Dependencies**: File upload system, data validation
- **Files**: `modules/components/import-modal-tpl.php`, `flows/sync-functions.php`
- **Validation**: Duplicate detection, data format validation
- **Output**: Validated keyword data in database
#### Step 2: Keyword Analysis
- **Function**: `igny8_analyze_keywords()`
- **Process**: Keyword metrics calculation and categorization
- **Dependencies**: External SEO APIs, database queries
- **Files**: `ai/modules-ai.php`, `core/db/db.php`
- **Analysis**: Volume, difficulty, competition scoring
- **Output**: Analyzed keyword data with metrics
#### Step 3: Keyword Categorization
- **Function**: `igny8_categorize_keywords()`
- **Process**: Primary/secondary keyword classification
- **Dependencies**: AI analysis, keyword relationships
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Classification**: Primary, secondary, long-tail categorization
- **Output**: Categorized keyword data
### 1.2 AI Clustering Process
#### Step 1: Cluster Analysis
- **Function**: `igny8_ai_cluster_keywords()`
- **Process**: AI-powered semantic clustering
- **Dependencies**: OpenAI API, keyword data
- **Files**: `ai/modules-ai.php`, `ai/openai-api.php`
- **Analysis**: Semantic similarity analysis
- **Output**: Keyword cluster assignments
#### Step 2: Cluster Optimization
- **Function**: `igny8_optimize_clusters()`
- **Process**: Cluster refinement and optimization
- **Dependencies**: Cluster data, AI analysis
- **Files**: `flows/sync-functions.php`, `ai/modules-ai.php`
- **Optimization**: Cluster size, keyword distribution
- **Output**: Optimized cluster structure
#### Step 3: Cluster Metrics
- **Function**: `igny8_calculate_cluster_metrics()`
- **Process**: Cluster performance calculation
- **Dependencies**: Cluster data, keyword metrics
- **Files**: `core/admin/global-helpers.php`, `flows/sync-functions.php`
- **Metrics**: Volume aggregation, keyword count
- **Output**: Cluster performance metrics
### 1.3 Content Idea Generation
#### Step 1: Idea Generation
- **Function**: `igny8_ai_generate_ideas()`
- **Process**: AI-powered content idea creation
- **Dependencies**: OpenAI API, cluster data
- **Files**: `ai/modules-ai.php`, `ai/openai-api.php`
- **Generation**: Content ideas based on clusters
- **Output**: Generated content ideas
#### Step 2: Idea Categorization
- **Function**: `igny8_categorize_ideas()`
- **Process**: Content type and priority classification
- **Dependencies**: AI analysis, content templates
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Categorization**: Content type, priority scoring
- **Output**: Categorized content ideas
#### Step 3: Idea Queue Management
- **Function**: `igny8_queue_ideas_to_writer()`
- **Process**: Idea prioritization and queue management
- **Dependencies**: Idea data, writer module
- **Files**: `flows/sync-functions.php`, `modules/modules-pages/writer.php`
- **Queue**: Priority-based idea queuing
- **Output**: Queued content ideas for writer
---
## 2. CONTENT CREATION WORKFLOW
### 2.1 Task Creation Process
#### Step 1: Task Generation
- **Function**: `igny8_create_writing_task()`
- **Process**: Content task creation from ideas
- **Dependencies**: Content ideas, writer settings
- **Files**: `modules/modules-pages/writer.php`, `flows/sync-functions.php`
- **Creation**: Task assignment and configuration
- **Output**: Writing tasks in database
#### Step 2: Task Prioritization
- **Function**: `igny8_prioritize_tasks()`
- **Process**: Task priority calculation and ordering
- **Dependencies**: Task data, priority algorithms
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Prioritization**: Priority scoring and ordering
- **Output**: Prioritized task queue
#### Step 3: Task Assignment
- **Function**: `igny8_assign_tasks()`
- **Process**: Task assignment to writers or AI
- **Dependencies**: Task data, user preferences
- **Files**: `modules/modules-pages/writer.php`, `flows/sync-functions.php`
- **Assignment**: Writer or AI assignment
- **Output**: Assigned writing tasks
### 2.2 AI Content Generation
#### Step 1: Content Generation
- **Function**: `igny8_generate_content()`
- **Process**: AI-powered content creation
- **Dependencies**: OpenAI API, task data
- **Files**: `ai/modules-ai.php`, `ai/openai-api.php`
- **Generation**: AI content creation
- **Output**: Generated content drafts
#### Step 2: Content Optimization
- **Function**: `igny8_optimize_content()`
- **Process**: SEO and readability optimization
- **Dependencies**: AI analysis, SEO rules
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Optimization**: SEO, readability improvements
- **Output**: Optimized content
#### Step 3: Content Validation
- **Function**: `igny8_validate_content()`
- **Process**: Content quality and compliance checking
- **Dependencies**: Content data, quality rules
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Validation**: Quality, compliance checks
- **Output**: Validated content
### 2.3 Draft Management
#### Step 1: Draft Creation
- **Function**: `igny8_create_draft()`
- **Process**: WordPress draft post creation
- **Dependencies**: WordPress, content data
- **Files**: `flows/sync-functions.php`, `core/db/db.php`
- **Creation**: WordPress draft creation
- **Output**: Draft posts in WordPress
#### Step 2: Draft Review
- **Function**: `igny8_review_draft()`
- **Process**: Content review and editing interface
- **Dependencies**: WordPress admin, draft data
- **Files**: `modules/modules-pages/writer.php`, `core/admin/meta-boxes.php`
- **Review**: Content review interface
- **Output**: Reviewed draft content
#### Step 3: Draft Optimization
- **Function**: `igny8_optimize_draft()`
- **Process**: Draft content optimization
- **Dependencies**: AI analysis, optimization rules
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Optimization**: Content improvement
- **Output**: Optimized draft content
### 2.4 Publishing Process
#### Step 1: Publishing Preparation
- **Function**: `igny8_prepare_publishing()`
- **Process**: Pre-publication checks and preparation
- **Dependencies**: Draft data, publishing rules
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Preparation**: Pre-publication validation
- **Output**: Publishing-ready content
#### Step 2: Content Publishing
- **Function**: `igny8_publish_content()`
- **Process**: WordPress post publication
- **Dependencies**: WordPress, draft data
- **Files**: `flows/sync-functions.php`, `core/db/db.php`
- **Publishing**: WordPress post publication
- **Output**: Published content
#### Step 3: Post-Publishing
- **Function**: `igny8_post_publish_actions()`
- **Process**: Post-publication tasks and monitoring
- **Dependencies**: Published content, monitoring systems
- **Files**: `flows/sync-functions.php`, `flows/image-injection-responsive.php`
- **Actions**: Image injection, monitoring setup
- **Output**: Fully published and monitored content
---
## 3. SEO OPTIMIZATION WORKFLOW
### 3.1 Content Analysis Process
#### Step 1: SEO Audit
- **Function**: `igny8_audit_content()`
- **Process**: Comprehensive SEO analysis
- **Dependencies**: Content data, SEO rules
- **Files**: `modules/modules-pages/optimizer.php`, `ai/modules-ai.php`
- **Analysis**: SEO factor analysis
- **Output**: SEO audit results
#### Step 2: Keyword Analysis
- **Function**: `igny8_analyze_keywords()`
- **Process**: Keyword usage and optimization analysis
- **Dependencies**: Content data, keyword data
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Analysis**: Keyword density, placement analysis
- **Output**: Keyword optimization recommendations
#### Step 3: Technical SEO
- **Function**: `igny8_analyze_technical_seo()`
- **Process**: Technical SEO factor analysis
- **Dependencies**: Content data, technical rules
- **Files**: `modules/modules-pages/optimizer.php`, `core/admin/global-helpers.php`
- **Analysis**: Technical SEO factors
- **Output**: Technical SEO recommendations
### 3.2 Optimization Suggestions
#### Step 1: Suggestion Generation
- **Function**: `igny8_generate_suggestions()`
- **Process**: AI-powered optimization suggestions
- **Dependencies**: AI analysis, content data
- **Files**: `ai/modules-ai.php`, `ai/openai-api.php`
- **Generation**: AI optimization suggestions
- **Output**: Optimization recommendations
#### Step 2: Suggestion Prioritization
- **Function**: `igny8_prioritize_suggestions()`
- **Process**: Suggestion priority and impact analysis
- **Dependencies**: Suggestion data, impact algorithms
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Prioritization**: Impact-based prioritization
- **Output**: Prioritized suggestions
#### Step 3: Implementation Planning
- **Function**: `igny8_plan_implementation()`
- **Process**: Implementation strategy development
- **Dependencies**: Suggestions, content data
- **Files**: `modules/modules-pages/optimizer.php`, `flows/sync-functions.php`
- **Planning**: Implementation strategy
- **Output**: Implementation plan
### 3.3 Performance Monitoring
#### Step 1: Metrics Collection
- **Function**: `igny8_collect_metrics()`
- **Process**: Performance data collection
- **Dependencies**: Analytics APIs, content data
- **Files**: `core/admin/global-helpers.php`, `modules/config/kpi-config.php`
- **Collection**: Performance data gathering
- **Output**: Performance metrics
#### Step 2: Performance Analysis
- **Function**: `igny8_analyze_performance()`
- **Process**: Performance trend and pattern analysis
- **Dependencies**: Metrics data, analysis algorithms
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Analysis**: Performance trend analysis
- **Output**: Performance insights
#### Step 3: Optimization Adjustment
- **Function**: `igny8_adjust_optimization()`
- **Process**: Performance-based optimization adjustments
- **Dependencies**: Performance data, optimization rules
- **Files**: `flows/sync-functions.php`, `ai/modules-ai.php`
- **Adjustment**: Optimization fine-tuning
- **Output**: Adjusted optimization strategy
---
## 4. LINK BUILDING WORKFLOW
### 4.1 Campaign Planning
#### Step 1: Campaign Strategy
- **Function**: `igny8_plan_campaign()`
- **Process**: Link building campaign strategy development
- **Dependencies**: Content data, target analysis
- **Files**: `modules/modules-pages/linker.php`, `ai/modules-ai.php`
- **Planning**: Campaign strategy development
- **Output**: Campaign strategy
#### Step 2: Target Identification
- **Function**: `igny8_identify_targets()`
- **Process**: High-value link target identification
- **Dependencies**: Content data, authority analysis
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Identification**: Target site identification
- **Output**: Link building targets
#### Step 3: Outreach Planning
- **Function**: `igny8_plan_outreach()`
- **Process**: Outreach strategy and message development
- **Dependencies**: Target data, content data
- **Files**: `modules/modules-pages/linker.php`, `flows/sync-functions.php`
- **Planning**: Outreach strategy
- **Output**: Outreach plan
### 4.2 Outreach Management
#### Step 1: Outreach Execution
- **Function**: `igny8_execute_outreach()`
- **Process**: Automated outreach campaign execution
- **Dependencies**: Outreach data, communication systems
- **Files**: `flows/sync-functions.php`, `modules/modules-pages/linker.php`
- **Execution**: Outreach campaign execution
- **Output**: Outreach activities
#### Step 2: Follow-up Management
- **Function**: `igny8_manage_followups()`
- **Process**: Follow-up communication management
- **Dependencies**: Outreach data, follow-up rules
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Management**: Follow-up communication
- **Output**: Follow-up activities
#### Step 3: Relationship Building
- **Function**: `igny8_build_relationships()`
- **Process**: Long-term relationship development
- **Dependencies**: Contact data, relationship rules
- **Files**: `modules/modules-pages/linker.php`, `flows/sync-functions.php`
- **Building**: Relationship development
- **Output**: Established relationships
### 4.3 Backlink Tracking
#### Step 1: Backlink Discovery
- **Function**: `igny8_discover_backlinks()`
- **Process**: Automated backlink detection and tracking
- **Dependencies**: External APIs, monitoring systems
- **Files**: `flows/sync-functions.php`, `core/db/db.php`
- **Discovery**: Backlink detection
- **Output**: Discovered backlinks
#### Step 2: Backlink Analysis
- **Function**: `igny8_analyze_backlinks()`
- **Process**: Backlink quality and authority analysis
- **Dependencies**: Backlink data, authority metrics
- **Files**: `ai/modules-ai.php`, `core/admin/global-helpers.php`
- **Analysis**: Backlink quality analysis
- **Output**: Backlink analysis results
#### Step 3: Performance Tracking
- **Function**: `igny8_track_backlink_performance()`
- **Process**: Backlink impact and performance monitoring
- **Dependencies**: Backlink data, performance metrics
- **Files**: `flows/sync-functions.php`, `modules/config/kpi-config.php`
- **Tracking**: Performance monitoring
- **Output**: Performance tracking data
---
## 5. CONTENT PERSONALIZATION WORKFLOW
### 5.1 Field Detection Process
#### Step 1: Content Analysis
- **Function**: `igny8_analyze_content_for_fields()`
- **Process**: AI-powered field detection from content
- **Dependencies**: OpenAI API, content data
- **Files**: `modules/modules-pages/personalize/content-generation.php`, `ai/integration.php`
- **Analysis**: Content field analysis
- **Output**: Detected personalization fields
#### Step 2: Field Configuration
- **Function**: `igny8_configure_fields()`
- **Process**: Field configuration and customization
- **Dependencies**: Field data, user preferences
- **Files**: `modules/modules-pages/personalize/content-generation.php`, `flows/sync-functions.php`
- **Configuration**: Field setup and customization
- **Output**: Configured personalization fields
#### Step 3: Field Validation
- **Function**: `igny8_validate_fields()`
- **Process**: Field validation and testing
- **Dependencies**: Field data, validation rules
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Validation**: Field validation and testing
- **Output**: Validated personalization fields
### 5.2 Content Rewriting Process
#### Step 1: Content Rewriting
- **Function**: `igny8_rewrite_content()`
- **Process**: AI-powered content personalization
- **Dependencies**: OpenAI API, user data
- **Files**: `ai/integration.php`, `ai/openai-api.php`
- **Rewriting**: Content personalization
- **Output**: Personalized content
#### Step 2: Content Optimization
- **Function**: `igny8_optimize_personalized_content()`
- **Process**: Personalized content optimization
- **Dependencies**: Personalized content, optimization rules
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Optimization**: Content optimization
- **Output**: Optimized personalized content
#### Step 3: Content Validation
- **Function**: `igny8_validate_personalized_content()`
- **Process**: Personalized content quality validation
- **Dependencies**: Personalized content, quality rules
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Validation**: Content quality validation
- **Output**: Validated personalized content
### 5.3 Frontend Integration
#### Step 1: Frontend Setup
- **Function**: `igny8_setup_frontend()`
- **Process**: Frontend personalization setup
- **Dependencies**: Frontend configuration, personalization data
- **Files**: `modules/modules-pages/personalize/front-end.php`, `flows/sync-functions.php`
- **Setup**: Frontend configuration
- **Output**: Configured frontend personalization
#### Step 2: User Interface
- **Function**: `igny8_display_personalization_interface()`
- **Process**: Personalization interface display
- **Dependencies**: Frontend templates, user data
- **Files**: `assets/js/core.js`, `modules/components/forms-tpl.php`
- **Display**: Personalization interface
- **Output**: User personalization interface
#### Step 3: Content Delivery
- **Function**: `igny8_deliver_personalized_content()`
- **Process**: Personalized content delivery
- **Dependencies**: Personalized content, delivery systems
- **Files**: `flows/sync-functions.php`, `core/db/db.php`
- **Delivery**: Content delivery
- **Output**: Delivered personalized content
---
## 6. AUTOMATION WORKFLOWS
### 6.1 Schedule Management
#### Step 1: Schedule Configuration
- **Function**: `igny8_configure_schedules()`
- **Process**: Automation schedule setup and configuration
- **Dependencies**: Schedule data, automation rules
- **Files**: `core/pages/settings/schedules.php`, `flows/sync-functions.php`
- **Configuration**: Schedule setup
- **Output**: Configured automation schedules
#### Step 2: Task Scheduling
- **Function**: `igny8_schedule_tasks()`
- **Process**: Automated task scheduling
- **Dependencies**: WordPress CRON, task data
- **Files**: `core/cron/igny8-cron-master-dispatcher.php`, `core/cron/igny8-cron-handlers.php`
- **Scheduling**: Task scheduling
- **Output**: Scheduled automation tasks
#### Step 3: Schedule Monitoring
- **Function**: `igny8_monitor_schedules()`
- **Process**: Schedule performance monitoring
- **Dependencies**: Schedule data, monitoring systems
- **Files**: `core/cron/igny8-cron-master-dispatcher.php`, `core/admin/global-helpers.php`
- **Monitoring**: Schedule monitoring
- **Output**: Schedule monitoring data
### 6.2 Automation Execution
#### Step 1: Task Execution
- **Function**: `igny8_execute_automation()`
- **Process**: Automated task execution
- **Dependencies**: Task data, execution systems
- **Files**: `core/cron/igny8-cron-handlers.php`, `flows/sync-functions.php`
- **Execution**: Task execution
- **Output**: Executed automation tasks
#### Step 2: Process Monitoring
- **Function**: `igny8_monitor_automation()`
- **Process**: Automation process monitoring
- **Dependencies**: Automation data, monitoring systems
- **Files**: `core/cron/igny8-cron-master-dispatcher.php`, `core/admin/global-helpers.php`
- **Monitoring**: Process monitoring
- **Output**: Automation monitoring data
#### Step 3: Error Handling
- **Function**: `igny8_handle_automation_errors()`
- **Process**: Automation error handling and recovery
- **Dependencies**: Error data, recovery systems
- **Files**: `core/cron/igny8-cron-handlers.php`, `flows/sync-functions.php`
- **Handling**: Error handling and recovery
- **Output**: Error handling results
### 6.3 Performance Optimization
#### Step 1: Performance Analysis
- **Function**: `igny8_analyze_automation_performance()`
- **Process**: Automation performance analysis
- **Dependencies**: Performance data, analysis algorithms
- **Files**: `core/admin/global-helpers.php`, `modules/config/kpi-config.php`
- **Analysis**: Performance analysis
- **Output**: Performance insights
#### Step 2: Optimization Adjustment
- **Function**: `igny8_optimize_automation()`
- **Process**: Automation optimization
- **Dependencies**: Performance data, optimization rules
- **Files**: `flows/sync-functions.php`, `ai/modules-ai.php`
- **Optimization**: Automation optimization
- **Output**: Optimized automation
#### Step 3: Continuous Improvement
- **Function**: `igny8_improve_automation()`
- **Process**: Continuous automation improvement
- **Dependencies**: Performance data, improvement algorithms
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Improvement**: Continuous improvement
- **Output**: Improved automation
---
## 7. ANALYTICS & REPORTING WORKFLOW
### 7.1 Data Collection
#### Step 1: Metrics Collection
- **Function**: `igny8_collect_metrics()`
- **Process**: Performance metrics collection
- **Dependencies**: Analytics APIs, content data
- **Files**: `core/admin/global-helpers.php`, `modules/config/kpi-config.php`
- **Collection**: Metrics gathering
- **Output**: Collected performance metrics
#### Step 2: Data Processing
- **Function**: `igny8_process_analytics_data()`
- **Process**: Analytics data processing and preparation
- **Dependencies**: Raw data, processing algorithms
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Processing**: Data processing
- **Output**: Processed analytics data
#### Step 3: Data Storage
- **Function**: `igny8_store_analytics_data()`
- **Process**: Analytics data storage and organization
- **Dependencies**: Processed data, database systems
- **Files**: `core/db/db.php`, `flows/sync-functions.php`
- **Storage**: Data storage
- **Output**: Stored analytics data
### 7.2 Analysis & Insights
#### Step 1: Data Analysis
- **Function**: `igny8_analyze_analytics_data()`
- **Process**: Analytics data analysis and insights
- **Dependencies**: Stored data, analysis algorithms
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Analysis**: Data analysis
- **Output**: Analytics insights
#### Step 2: Trend Analysis
- **Function**: `igny8_analyze_trends()`
- **Process**: Performance trend analysis
- **Dependencies**: Historical data, trend algorithms
- **Files**: `ai/modules-ai.php`, `core/admin/global-helpers.php`
- **Analysis**: Trend analysis
- **Output**: Trend insights
#### Step 3: Predictive Analytics
- **Function**: `igny8_predict_performance()`
- **Process**: Performance prediction and forecasting
- **Dependencies**: Historical data, prediction algorithms
- **Files**: `ai/modules-ai.php`, `flows/sync-functions.php`
- **Prediction**: Performance prediction
- **Output**: Predictive insights
### 7.3 Reporting & Visualization
#### Step 1: Report Generation
- **Function**: `igny8_generate_reports()`
- **Process**: Automated report generation
- **Dependencies**: Analytics data, report templates
- **Files**: `modules/components/kpi-tpl.php`, `flows/sync-functions.php`
- **Generation**: Report generation
- **Output**: Generated reports
#### Step 2: Data Visualization
- **Function**: `igny8_visualize_data()`
- **Process**: Analytics data visualization
- **Dependencies**: Analytics data, visualization tools
- **Files**: `modules/components/kpi-tpl.php`, `assets/js/core.js`
- **Visualization**: Data visualization
- **Output**: Visualized analytics data
#### Step 3: Report Distribution
- **Function**: `igny8_distribute_reports()`
- **Process**: Report distribution and delivery
- **Dependencies**: Generated reports, distribution systems
- **Files**: `flows/sync-functions.php`, `core/admin/global-helpers.php`
- **Distribution**: Report distribution
- **Output**: Distributed reports
---
## 8. INTEGRATION WORKFLOWS
### 8.1 WordPress Integration
#### Step 1: WordPress Setup
- **Function**: `igny8_setup_wordpress_integration()`
- **Process**: WordPress integration setup
- **Dependencies**: WordPress hooks, plugin system
- **Files**: `igny8.php`, `core/admin/init.php`
- **Setup**: WordPress integration
- **Output**: Integrated WordPress functionality
#### Step 2: Post Meta Management
- **Function**: `igny8_manage_post_meta()`
- **Process**: WordPress post metadata management
- **Dependencies**: WordPress post system, metadata
- **Files**: `core/db/db.php`, `flows/sync-functions.php`
- **Management**: Post metadata management
- **Output**: Managed post metadata
#### Step 3: Taxonomy Integration
- **Function**: `igny8_integrate_taxonomies()`
- **Process**: Custom taxonomy integration
- **Dependencies**: WordPress taxonomy system
- **Files**: `core/db/db.php`, `core/admin/init.php`
- **Integration**: Taxonomy integration
- **Output**: Integrated taxonomies
### 8.2 AI Service Integration
#### Step 1: AI Service Setup
- **Function**: `igny8_setup_ai_services()`
- **Process**: AI service integration setup
- **Dependencies**: AI APIs, authentication
- **Files**: `ai/integration.php`, `ai/openai-api.php`
- **Setup**: AI service setup
- **Output**: Configured AI services
#### Step 2: API Management
- **Function**: `igny8_manage_ai_apis()`
- **Process**: AI API management and optimization
- **Dependencies**: API credentials, rate limiting
- **Files**: `ai/openai-api.php`, `ai/runware-api.php`
- **Management**: API management
- **Output**: Managed AI APIs
#### Step 3: Performance Monitoring
- **Function**: `igny8_monitor_ai_performance()`
- **Process**: AI service performance monitoring
- **Dependencies**: AI services, monitoring systems
- **Files**: `ai/integration.php`, `core/admin/global-helpers.php`
- **Monitoring**: AI performance monitoring
- **Output**: AI performance data
### 8.3 Database Integration
#### Step 1: Database Setup
- **Function**: `igny8_setup_database()`
- **Process**: Database table creation and setup
- **Dependencies**: Database system, table schemas
- **Files**: `core/db/db.php`, `install.php`
- **Setup**: Database setup
- **Output**: Configured database
#### Step 2: Data Migration
- **Function**: `igny8_migrate_data()`
- **Process**: Data migration and version management
- **Dependencies**: Database system, migration scripts
- **Files**: `core/db/db-migration.php`, `flows/sync-functions.php`
- **Migration**: Data migration
- **Output**: Migrated data
#### Step 3: Performance Optimization
- **Function**: `igny8_optimize_database()`
- **Process**: Database performance optimization
- **Dependencies**: Database system, optimization rules
- **Files**: `core/db/db.php`, `flows/sync-functions.php`
- **Optimization**: Database optimization
- **Output**: Optimized database
---
## Technical Implementation Details
### Workflow Dependencies
- **WordPress Core**: Hooks, actions, filters
- **Database Layer**: Custom tables, queries, migrations
- **AI Services**: OpenAI, Runware APIs
- **Frontend**: JavaScript, CSS, responsive design
- **Automation**: WordPress CRON, scheduled tasks
### File Structure
- **Core Files**: Plugin initialization and setup
- **Module Files**: Feature-specific implementations
- **AI Integration**: AI service integrations
- **Workflows**: Process automation and management
- **Assets**: Frontend resources and templates
### Performance Considerations
- **Caching**: Data caching and optimization
- **Database**: Query optimization and indexing
- **AI APIs**: Rate limiting and cost optimization
- **Automation**: Efficient task scheduling and execution
- **Monitoring**: Performance tracking and optimization
This comprehensive workflows documentation covers all aspects of the Igny8 AI SEO Plugin's workflow processes, providing detailed step-by-step guidance for each workflow, including functions, dependencies, and file references.

122
igny8-wp-plugin-for-reference-olny/docs/FILE_TREE.txt Normal file
View File

@@ -0,0 +1,122 @@
igny8-ai-seo/
├── ai/
│ ├── _README.php
│ ├── integration.php
│ ├── model-rates-config.php
│ ├── modules-ai.php
│ ├── openai-api.php
│ ├── prompts-library.php
│ ├── runware-api.php
│ └── writer/
│ ├── content/
│ └── images/
│ └── image-generation.php
├── assets/
│ ├── ai-images/
│ ├── css/
│ │ ├── core-backup.css
│ │ ├── core.css
│ │ └── image-injection.css
│ ├── img/
│ ├── js/
│ │ ├── core.js
│ │ └── image-queue-processor.js
│ ├── shortcodes/
│ │ ├── _README.php
│ │ └── image-gallery.php
│ └── templates/
│ ├── igny8_clusters_template.csv
│ ├── igny8_ideas_template.csv
│ └── igny8_keywords_template.csv
├── CHANGELOG_live.md
├── core/
│ ├── _README.php
│ ├── admin/
│ │ ├── ajax.php
│ │ ├── global-helpers.php
│ │ ├── init.php
│ │ ├── menu.php
│ │ ├── meta-boxes.php
│ │ └── module-manager-class.php
│ ├── cron/
│ │ ├── igny8-cron-handlers.php
│ │ └── igny8-cron-master-dispatcher.php
│ ├── db/
│ │ ├── db-migration.php
│ │ └── db.php
│ └── global-layout.php
├── debug/
│ ├── _README.php
│ ├── debug.php
│ ├── module-debug.php
│ └── monitor-helpers.php
├── docs/
│ ├── _README.php
│ ├── COMPLETE_FEATURES_LIST.md
│ ├── COMPLETE_FUNCTION_REFERENCE.md
│ ├── COMPLETE_IMAGE_GENERATION_AUDIT.md
│ ├── COMPLETE_WORKFLOWS_DOCUMENTATION.md
│ ├── FILE_TREE.txt
│ ├── IGNY8_PAGES_TABLE.md
│ ├── IGNY8_SNAPSHOT_V5.2.0.md
│ └── TROUBLESHOOTING_Converting_to_blocks_and_image_shortcode_injection.md
├── flows/
│ ├── sync-ajax.php
│ ├── sync-functions.php
│ └── sync-hooks.php
├── igny8-wp-load-handler.php
├── igny8.php
├── install.php
├── modules/
│ ├── _README.php
│ ├── analytics/
│ │ └── analytics.php
│ ├── components/
│ │ ├── _README.php
│ │ ├── actions-tpl.php
│ │ ├── export-modal-tpl.php
│ │ ├── filters-tpl.php
│ │ ├── forms-tpl.php
│ │ ├── import-modal-tpl.php
│ │ ├── kpi-tpl.php
│ │ ├── pagination-tpl.php
│ │ └── table-tpl.php
│ ├── config/
│ │ ├── _README.php
│ │ ├── filters-config.php
│ │ ├── forms-config.php
│ │ ├── import-export-config.php
│ │ ├── kpi-config.php
│ │ └── tables-config.php
│ ├── help/
│ │ ├── docs.php
│ │ ├── function-testing.php
│ │ ├── help.php
│ │ └── system-testing.php
│ ├── home.php
│ ├── planner/
│ │ ├── clusters.php
│ │ ├── ideas.php
│ │ ├── keywords.php
│ │ └── planner.php
│ ├── settings/
│ │ ├── general-settings.php
│ │ ├── import-export.php
│ │ ├── integration.php
│ │ ├── schedules.php
│ │ └── status.php
│ ├── thinker/
│ │ ├── image-testing.php
│ │ ├── profile.php
│ │ ├── prompts.php
│ │ ├── strategies.php
│ │ └── thinker.php
│ └── writer/
│ ├── drafts.php
│ ├── published.php
│ ├── tasks.php
│ └── writer.php
├── shortcodes/
│ ├── ai-shortcodes.php
│ └── writer-shortcodes.php
└── uninstall.php

162
igny8-wp-plugin-for-reference-olny/docs/IGNY8_PAGES_TABLE.md Normal file
View File

@@ -0,0 +1,162 @@
# Igny8 AI SEO Plugin - Complete Pages Table
## Overview
This table provides a comprehensive list of all pages in the Igny8 AI SEO Plugin, including their URLs, purposes, and functionality.
---
## Main Navigation Pages
| Page Name | URL | Purpose | Module | Subpages |
|-----------|-----|---------|--------|----------|
| **Dashboard** | `admin.php?page=igny8-home` | Main dashboard with complete AI workflow guide | Core | None |
| **Planner** | `admin.php?page=igny8-planner` | Content planning and keyword research | Planner | 4 subpages |
| **Writer** | `admin.php?page=igny8-writer` | Content creation and writing tools | Writer | 3 subpages |
| **Optimizer** | `admin.php?page=igny8-optimizer` | SEO optimization and performance tools | Optimizer | 2 subpages |
| **Linker** | `admin.php?page=igny8-linker` | Link building and backlink management | Linker | 2 subpages |
| **Personalize** | `admin.php?page=igny8-personalize` | Content personalization and targeting | Personalize | 4 subpages |
| **Thinker** | `admin.php?page=igny8-thinker` | AI thinker and strategy tools | Thinker | 4 subpages |
| **Analytics** | `admin.php?page=igny8-analytics` | Performance analytics and reporting | Analytics | None |
| **Schedules** | `admin.php?page=igny8-schedules` | Smart automation schedules | Schedules | None |
| **Settings** | `admin.php?page=igny8-settings` | Plugin configuration and settings | Core | 3 subpages |
| **Help** | `admin.php?page=igny8-help` | Documentation and support resources | Core | 3 subpages |
---
## Planner Module Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **Planner Dashboard** | `admin.php?page=igny8-planner` | Main planner overview | Overview of keywords, clusters, and ideas |
| **Keywords** | `admin.php?page=igny8-planner&sm=keywords` | Keyword management | Manage keywords, track search volumes, organize by intent and difficulty |
| **Clusters** | `admin.php?page=igny8-planner&sm=clusters` | Keyword clustering | Group related keywords into content clusters for better topical authority |
| **Ideas** | `admin.php?page=igny8-planner&sm=ideas` | Content ideas generation | Generate and organize content ideas based on keyword research |
| **Mapping** | `admin.php?page=igny8-planner&sm=mapping` | Content mapping | Map keywords and clusters to existing pages and content |
---
## Writer Module Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **Writer Dashboard** | `admin.php?page=igny8-writer` | Main writer overview | Overview of content tasks and workflow |
| **Tasks** | `admin.php?page=igny8-writer&sm=tasks` | Content queue management | Manage content tasks and work queue |
| **Drafts** | `admin.php?page=igny8-writer&sm=drafts` | Draft content management | Manage content drafts and work in progress |
| **Published** | `admin.php?page=igny8-writer&sm=published` | Published content | View and manage published content |
---
## Optimizer Module Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **Optimizer Dashboard** | `admin.php?page=igny8-optimizer` | Main optimizer overview | Overview of optimization tools and performance |
| **Audits** | `admin.php?page=igny8-optimizer&sm=audits` | SEO audits | Run comprehensive SEO audits on content and pages |
| **Suggestions** | `admin.php?page=igny8-optimizer&sm=suggestions` | Optimization suggestions | Get AI-powered optimization suggestions for better rankings |
---
## Linker Module Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **Linker Dashboard** | `admin.php?page=igny8-linker` | Main linker overview | Overview of link building tools and campaigns |
| **Backlinks** | `admin.php?page=igny8-linker&sm=backlinks` | Backlink management | Track and manage backlink profile and authority |
| **Campaigns** | `admin.php?page=igny8-linker&sm=campaigns` | Link building campaigns | Plan and execute link building campaigns effectively |
---
## Personalize Module Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **Personalize Dashboard** | `admin.php?page=igny8-personalize` | Main personalization overview | Overview of personalization tools and settings |
| **Settings** | `admin.php?page=igny8-personalize&sm=settings` | Personalization settings | Configure global settings, display options, and advanced personalization settings |
| **Content Generation** | `admin.php?page=igny8-personalize&sm=content-generation` | AI content generation | Configure AI prompts, field detection, and content generation parameters |
| **Rewrites** | `admin.php?page=igny8-personalize&sm=rewrites` | Content variations | View and manage personalized content variations and rewrites |
| **Front-end** | `admin.php?page=igny8-personalize&sm=front-end` | Frontend implementation | Manage front-end display settings, shortcode usage, and implementation guides |
---
## Thinker Module Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **Thinker Dashboard** | `admin.php?page=igny8-thinker&sp=main` | Main AI thinker overview | Overview of AI tools and strategies |
| **Prompts** | `admin.php?page=igny8-thinker&sp=prompts` | AI prompts management | Manage and configure AI prompts for content generation |
| **Profile** | `admin.php?page=igny8-thinker&sp=profile` | AI profile settings | Configure AI personality and writing style |
| **Strategies** | `admin.php?page=igny8-thinker&sp=strategies` | Content strategies | Plan and manage content strategies and approaches |
| **Image Testing** | `admin.php?page=igny8-thinker&sp=image-testing` | AI image testing | Test and configure AI image generation capabilities |
---
## Settings Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **General Settings** | `admin.php?page=igny8-settings&sp=general` | Plugin configuration | Configure plugin settings, automation, and table preferences |
| **System Status** | `admin.php?page=igny8-settings&sp=status` | System monitoring | Monitor system health, database status, and module performance |
| **API Integration** | `admin.php?page=igny8-settings&sp=integration` | External integrations | Configure API keys and integrate with external services |
| **Import/Export** | `admin.php?page=igny8-settings&sp=import-export` | Data management | Import and export data, manage backups, and transfer content |
---
## Help Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **Help & Support** | `admin.php?page=igny8-help&sp=help` | Main help page | Documentation and support resources for getting started |
| **Documentation** | `admin.php?page=igny8-help&sp=docs` | Complete documentation | Comprehensive documentation and guides |
| **System Testing** | `admin.php?page=igny8-help&sp=system-testing` | System diagnostics | Test system functionality and diagnose issues |
| **Function Testing** | `admin.php?page=igny8-help&sp=function-testing` | Function testing | Test individual functions and components |
---
## Special Pages
| Page Name | URL | Purpose | Description |
|-----------|-----|---------|-------------|
| **Analytics** | `admin.php?page=igny8-analytics` | Performance analytics | Performance analytics and reporting for data-driven decisions |
| **Schedules** | `admin.php?page=igny8-schedules` | Automation schedules | Content scheduling and automation for consistent publishing |
---
## Page Access Requirements
| Requirement | Description |
|-------------|-------------|
| **Capability** | All pages require `manage_options` capability |
| **Module Status** | Module pages only accessible if corresponding module is enabled |
| **User Context** | All pages require authenticated WordPress user |
---
## Page Structure Notes
### URL Parameters
- **`page`**: Main page identifier (e.g., `igny8-planner`)
- **`sm`**: Submodule parameter for module subpages (e.g., `keywords`, `clusters`)
- **`sp`**: Subpage parameter for settings/help pages (e.g., `general`, `docs`)
### Page Rendering
- All pages use `core/global-layout.php` as the master layout template
- Module pages use `modules/modules-pages/{module}.php` for content
- Settings/Help pages use `core/pages/{category}/{page}.php` for content
- All pages include breadcrumb navigation and submenu systems
### Dynamic Content
- Pages show different content based on module enablement status
- Subpages are conditionally rendered based on URL parameters
- All pages include workflow guides and progress tracking
---
## Summary
**Total Pages**: 25+ individual pages across 8 modules
**Main Modules**: Planner, Writer, Optimizer, Linker, Personalize, Thinker, Analytics, Schedules
**Core Pages**: Dashboard, Settings, Help
**Subpages**: 20+ subpages with specialized functionality
**Access Control**: All pages require admin privileges and module enablement
This comprehensive page structure provides a complete SEO management platform with specialized tools for each aspect of content creation, optimization, and performance tracking.

523
igny8-wp-plugin-for-reference-olny/docs/IGNY8_SNAPSHOT_V5.2.0.md Normal file
View File

@@ -0,0 +1,523 @@
# Igny8 AI SEO Plugin - Complete System Snapshot v0.1
## Summary Table
| System Component | Current State | Modules | Functions | Dependencies | Files Involved |
|------------------|---------------|---------|-----------|--------------|----------------|
| **Core System** | Fully Operational | 8 Active Modules | 200+ Functions | WordPress, Database | `igny8.php`, `core/`, `install.php`, `uninstall.php` |
| **AI Integration** | Advanced AI Processing | OpenAI, Runware | 25+ AI Functions | OpenAI API, Runware API | `ai/integration.php`, `ai/openai-api.php`, `ai/runware-api.php` |
| **Database Layer** | 15 Custom Tables | Data Management | 30+ DB Functions | MySQL, WordPress | `core/db/db.php`, `core/db/db-migration.php` |
| **Workflow Automation** | ⚠️ CRITICAL ISSUES IDENTIFIED | 7 Workflow Types | 40+ Automation Functions | WordPress CRON, Database | `flows/`, `core/cron/` |
| **Admin Interface** | Complete UI System | 8 Module Interfaces | 35+ UI Functions | WordPress Admin, JavaScript | `core/admin/`, `modules/` |
| **Frontend Integration** | Responsive Design | Personalization, Shortcodes | 15+ Frontend Functions | JavaScript, CSS | `assets/`, `modules/modules-pages/personalize/` |
| **Analytics & Reporting** | Advanced Analytics | KPI Tracking, Reporting | 25+ Analytics Functions | Database, WordPress | `core/admin/global-helpers.php`, `modules/config/` |
---
## ⚠️ CRITICAL SYSTEM ISSUES IDENTIFIED
### Cron vs Manual Function Discrepancies
- **HIGH RISK**: Cron functions have significant architectural differences from manual counterparts
- **Function Dependencies**: Cron handlers include extensive fallback logic suggesting unreliable function loading
- **User Context**: Cron handlers manually set admin user context while manual handlers rely on authenticated users
- **Error Handling**: Cron handlers suppress PHP warnings that manual handlers don't, potentially masking critical issues
- **Database Access**: Inconsistent database connection handling between cron and manual functions
### Affected Automation Functions
1. **Auto Cluster**: `igny8_auto_cluster_cron_handler()` vs `igny8_ajax_ai_cluster_keywords()`
2. **Auto Ideas**: `igny8_auto_generate_ideas_cron_handler()` vs `igny8_ajax_ai_generate_ideas()`
3. **Auto Queue**: `igny8_auto_queue_cron_handler()` vs `igny8_ajax_queue_ideas_to_writer()`
4. **Auto Content**: `igny8_auto_generate_content_cron_handler()` vs `igny8_ajax_ai_generate_content()`
5. **Auto Image**: `igny8_auto_generate_images_cron_handler()` vs `igny8_ajax_ai_generate_images_drafts()`
6. **Auto Publish**: `igny8_auto_publish_drafts_cron_handler()` vs `igny8_ajax_bulk_publish_drafts()`
### Impact Assessment
- **Manual Functions**: ✅ Healthy and functioning correctly
- **Cron Functions**: ❌ High risk of failure due to architectural differences
- **Recommendation**: 🔴 IMMEDIATE review and alignment required
- **Priority**: CRITICAL - Automation system reliability compromised
---
## 1. SYSTEM ARCHITECTURE OVERVIEW
### 1.1 Core System Components
- **Plugin Initialization**: Complete WordPress integration with hooks, actions, and filters
- **Database Management**: 15 custom tables with full migration and version control
- **Module System**: 8 active modules with dynamic loading and configuration
- **AI Integration**: Advanced OpenAI and Runware API integration
- **Automation System**: Comprehensive CRON-based workflow automation
- **Admin Interface**: Complete WordPress admin integration with responsive design
- **Frontend Integration**: Personalization and shortcode system
- **Analytics System**: Advanced KPI tracking and reporting
### 1.2 Current Version Status
- **Version**: 0.1
- **WordPress Compatibility**: 5.0+
- **PHP Requirements**: 7.4+
- **Database**: MySQL 5.7+
- **Status**: ⚠️ Production Ready with Critical Automation Issues
- **Last Updated**: January 15, 2025
- **Stability**: Stable (Manual Functions) / Unstable (Cron Functions)
- **Performance**: Optimized
- **Critical Issues**: Cron vs Manual function discrepancies identified
---
## 2. MODULE SYSTEM STATUS
### 2.1 Active Modules
#### **Planner Module** - Content Planning & Strategy
- **Status**: Fully Operational
- **Features**: Keyword research, AI clustering, content idea generation
- **Functions**: 25+ planning functions
- **Dependencies**: OpenAI API, Database, WordPress
- **Files**: `modules/modules-pages/planner.php`, `ai/modules-ai.php`
- **Workflow**: Keyword Research → Clustering → Ideas → Queue
#### **Writer Module** - Content Creation & Management
- **Status**: Fully Operational
- **Features**: AI content generation, draft management, publishing workflow
- **Functions**: 30+ writing functions
- **Dependencies**: AI APIs, WordPress, Database
- **Files**: `modules/modules-pages/writer.php`, `ai/modules-ai.php`
- **Workflow**: Task Creation → AI Generation → Draft Review → Publishing
#### **Optimizer Module** - SEO Analysis & Optimization
- **Status**: Fully Operational
- **Features**: Content audits, optimization suggestions, performance monitoring
- **Functions**: 20+ optimization functions
- **Dependencies**: SEO APIs, Database
- **Files**: `modules/modules-pages/optimizer.php`, `ai/modules-ai.php`
- **Workflow**: Content Analysis → Suggestions → Implementation → Monitoring
#### **Linker Module** - Backlink Management & Campaigns
- **Status**: Fully Operational
- **Features**: Backlink tracking, campaign management, authority building
- **Functions**: 25+ linking functions
- **Dependencies**: External APIs, Database
- **Files**: `modules/modules-pages/linker.php`, `flows/sync-functions.php`
- **Workflow**: Campaign Planning → Outreach → Tracking → Analysis
#### **Personalize Module** - AI Content Personalization
- **Status**: Fully Operational
- **Features**: AI personalization, user targeting, frontend integration
- **Functions**: 20+ personalization functions
- **Dependencies**: OpenAI API, Frontend
- **Files**: `modules/modules-pages/personalize/`, `ai/integration.php`
- **Workflow**: Field Detection → Content Rewriting → Frontend Display → Analytics
#### **Thinker Module** - AI Strategy & Prompt Management
- **Status**: Fully Operational
- **Features**: AI strategy, prompt management, content planning
- **Functions**: 15+ thinking functions
- **Dependencies**: AI APIs, Database
- **Files**: `core/pages/thinker/`, `ai/prompts-library.php`
- **Workflow**: Strategy Development → Prompt Management → Content Planning
#### **Analytics Module** - Performance Tracking & Reporting
- **Status**: Fully Operational
- **Features**: KPI tracking, performance monitoring, report generation
- **Functions**: 25+ analytics functions
- **Dependencies**: Database, WordPress
- **Files**: `core/admin/`, `modules/config/kpi-config.php`
- **Workflow**: Data Collection → Analysis → Visualization → Reporting
#### **Schedules Module** - Automation Management
- **Status**: Fully Operational
- **Features**: CRON management, workflow automation, task scheduling
- **Functions**: 15+ automation functions
- **Dependencies**: WordPress CRON, Database
- **Files**: `core/cron/`, `core/pages/settings/schedules.php`
- **Workflow**: Schedule Setup → Task Execution → Monitoring → Optimization
### 2.2 Module Dependencies
- **Core Dependencies**: WordPress, Database, PHP
- **AI Dependencies**: OpenAI API, Runware API
- **External Dependencies**: cURL, JSON, CSV
- **Internal Dependencies**: Module Manager, CRON System, Admin Interface
---
## 3. DATABASE ARCHITECTURE
### 3.1 Custom Tables (15 Tables)
#### **Core Data Tables**
- `igny8_keywords` - Keyword research and analysis data
- `igny8_tasks` - Content creation and writing tasks
- `igny8_data` - General plugin data and configurations
- `igny8_variations` - Content variations and personalization data
- `igny8_rankings` - SEO ranking and performance data
- `igny8_suggestions` - Optimization suggestions and recommendations
- `igny8_campaigns` - Link building and marketing campaigns
- `igny8_content_ideas` - AI-generated content ideas and concepts
- `igny8_clusters` - Keyword clusters and semantic groupings
- `igny8_sites` - Target sites and domain information
- `igny8_backlinks` - Backlink tracking and analysis data
- `igny8_mapping` - Data relationships and mappings
- `igny8_prompts` - AI prompts and templates
- `igny8_logs` - System logs and debugging information
- `igny8_ai_queue` - AI processing queue and task management
### 3.2 Database Features
- **Migration System**: Complete version control and data migration
- **Data Validation**: Comprehensive data integrity and validation
- **Performance Optimization**: Indexed queries and optimized operations
- **Backup & Recovery**: Automated backup and disaster recovery
- **Data Relationships**: Foreign key constraints and data integrity
### 3.3 WordPress Integration
- **Post Meta**: Advanced post metadata management
- **Taxonomies**: Custom taxonomies (sectors, clusters)
- **User Management**: Role-based access control
- **Options API**: Plugin settings and configuration
- **Transients**: Caching and performance optimization
---
## 4. AI INTEGRATION STATUS
### 4.1 OpenAI Integration
- **API Client**: Complete OpenAI API integration
- **Models Supported**: GPT-4, GPT-3.5-turbo, GPT-4-turbo
- **Features**: Content generation, keyword clustering, idea generation
- **Functions**: 15+ OpenAI functions
- **Cost Tracking**: API usage monitoring and cost optimization
- **Error Handling**: Robust error handling and recovery
### 4.2 Runware Integration
- **API Client**: Complete Runware API integration
- **Image Generation**: AI-powered image creation
- **Features**: Multi-size image generation, responsive images
- **Functions**: 10+ Runware functions
- **Image Processing**: Automated image processing and optimization
- **Integration**: WordPress media library integration
### 4.3 AI Workflow Integration
- **Content Generation**: Automated AI content creation
- **Image Generation**: Automated AI image creation
- **Personalization**: AI-powered content personalization
- **Optimization**: AI-driven content optimization
- **Analytics**: AI-powered performance analysis
---
## 5. WORKFLOW AUTOMATION STATUS ⚠️ CRITICAL ISSUES
### 5.1 CRON System
- **Master Dispatcher**: Centralized CRON job management
- **Job Handlers**: 10+ specialized CRON handlers
- **Scheduling**: Flexible task scheduling and management
- **Monitoring**: Health monitoring and performance tracking
- **Error Handling**: ⚠️ INCONSISTENT error handling between cron and manual functions
- **Status**: 🔴 HIGH RISK - Cron functions may fail due to architectural differences
### 5.2 Automation Workflows
- **Content Planning**: Automated keyword research and clustering
- **Content Creation**: Automated content generation and publishing
- **SEO Optimization**: Automated content optimization and monitoring
- **Link Building**: Automated outreach and backlink tracking
- **Personalization**: Automated content personalization
- **Analytics**: Automated reporting and performance tracking
### 5.3 Process Automation
- **Task Management**: Automated task creation and assignment
- **Content Processing**: Automated content generation and optimization
- **Publishing**: Automated content publishing and distribution
- **Monitoring**: Automated performance monitoring and alerting
- **Maintenance**: Automated system maintenance and optimization
---
## 6. ADMIN INTERFACE STATUS
### 6.1 User Interface Components
- **Dashboard**: Comprehensive dashboard with KPI tracking
- **Data Tables**: Advanced data tables with sorting and filtering
- **Forms**: Dynamic forms with validation and AJAX
- **Modals**: Import/export modals with progress tracking
- **Navigation**: Intuitive navigation with breadcrumbs
- **Responsive Design**: Mobile-optimized responsive design
### 6.2 Module Interfaces
- **Planner Interface**: Keyword research and clustering interface
- **Writer Interface**: Content creation and management interface
- **Optimizer Interface**: SEO analysis and optimization interface
- **Linker Interface**: Backlink management and campaign interface
- **Personalize Interface**: Content personalization interface
- **Thinker Interface**: AI strategy and prompt management interface
- **Analytics Interface**: Performance tracking and reporting interface
- **Schedules Interface**: Automation management interface
### 6.3 Component System
- **Reusable Components**: Table, form, filter, pagination components
- **Configuration System**: Dynamic configuration management
- **Template System**: Flexible template rendering system
- **Asset Management**: Optimized asset loading and caching
---
## 7. FRONTEND INTEGRATION STATUS
### 7.1 Personalization System
- **Shortcode Integration**: `[igny8]` shortcode for content personalization
- **Display Modes**: Button, inline, and automatic personalization modes
- **User Interface**: Customizable personalization forms and interfaces
- **Responsive Design**: Mobile-optimized personalization experience
- **Performance**: Fast-loading personalization features
### 7.2 Frontend Assets
- **JavaScript**: Core functionality and AJAX handling
- **CSS**: Responsive design and styling
- **Templates**: Frontend template system
- **Media**: Image and media handling
- **Performance**: Optimized asset delivery
### 7.3 User Experience
- **Personalization**: AI-powered content personalization
- **Responsive Design**: Mobile-first responsive design
- **Performance**: Optimized loading and performance
- **Accessibility**: WCAG compliant accessibility features
- **Integration**: Seamless WordPress theme integration
---
## 8. ANALYTICS & REPORTING STATUS
### 8.1 KPI Tracking
- **Performance Metrics**: Comprehensive performance tracking
- **Dashboard Analytics**: Real-time dashboard analytics
- **Trend Analysis**: Performance trend identification
- **Comparative Analysis**: Period-over-period comparison
- **Predictive Analytics**: AI-powered performance prediction
### 8.2 Reporting System
- **Automated Reports**: Scheduled performance reports
- **Custom Reports**: User-defined report creation
- **Export Functionality**: Multiple export formats
- **Report Scheduling**: Automated report delivery
- **Report Analytics**: Report usage and effectiveness tracking
### 8.3 Data Visualization
- **Interactive Charts**: Dynamic performance charts
- **Dashboard Customization**: Personalized dashboard configuration
- **Real-time Updates**: Live performance data updates
- **Visual Analytics**: Advanced data visualization
- **Performance Insights**: AI-powered performance insights
---
## 9. SECURITY & PERFORMANCE STATUS
### 9.1 Security Features
- **Data Sanitization**: Comprehensive input sanitization
- **Nonce Verification**: WordPress nonce security
- **User Permissions**: Role-based access control
- **API Security**: Secure API communication
- **Data Encryption**: Sensitive data encryption
### 9.2 Performance Optimization
- **Database Optimization**: Optimized queries and indexing
- **Caching System**: Advanced caching and performance optimization
- **Asset Optimization**: Minified and optimized assets
- **API Optimization**: Efficient API usage and rate limiting
- **Memory Management**: Optimized memory usage and garbage collection
### 9.3 Error Handling
- **Robust Error Handling**: Comprehensive error handling and recovery
- **Logging System**: Advanced logging and debugging
- **Monitoring**: System health monitoring and alerting
- **Recovery**: Automated error recovery and system restoration
- **Debugging**: Advanced debugging and troubleshooting tools
---
## 10. INTEGRATION STATUS
### 10.1 WordPress Integration
- **Core Integration**: Complete WordPress core integration
- **Hook System**: WordPress hooks, actions, and filters
- **Post System**: Advanced post metadata management
- **User System**: User role and permission management
- **Theme Integration**: Seamless theme integration
### 10.2 External Integrations
- **OpenAI API**: Advanced AI content generation
- **Runware API**: AI-powered image generation
- **SEO APIs**: External SEO service integration
- **Analytics APIs**: Performance tracking integration
- **Social APIs**: Social media integration
### 10.3 Data Integration
- **CSV Import/Export**: Comprehensive data portability
- **API Integration**: RESTful API integration
- **Webhook Support**: Real-time data synchronization
- **Data Synchronization**: Multi-platform data consistency
- **Custom Integrations**: Flexible integration development
---
## 11. CURRENT CAPABILITIES
### 11.1 Content Management
- **AI Content Generation**: Automated content creation using OpenAI
- **Image Generation**: AI-powered image creation using Runware
- **Content Optimization**: SEO-optimized content generation
- **Content Personalization**: AI-powered content personalization
- **Content Publishing**: Automated content publishing and distribution
### 11.2 SEO Optimization
- **Keyword Research**: Advanced keyword research and analysis
- **Content Audits**: Comprehensive SEO content audits
- **Optimization Suggestions**: AI-powered optimization recommendations
- **Performance Monitoring**: Real-time SEO performance tracking
- **Ranking Tracking**: Keyword ranking monitoring and analysis
### 11.3 Link Building
- **Backlink Tracking**: Automated backlink detection and analysis
- **Campaign Management**: Strategic link building campaign management
- **Outreach Automation**: Automated outreach and follow-up systems
- **Authority Building**: Long-term domain authority building
- **Relationship Management**: Influencer and industry relationship management
### 11.4 Analytics & Reporting
- **Performance Tracking**: Comprehensive performance metrics tracking
- **KPI Monitoring**: Key performance indicator monitoring
- **Trend Analysis**: Performance trend identification and analysis
- **Predictive Analytics**: AI-powered performance prediction
- **Custom Reporting**: User-defined report creation and scheduling
---
## 12. TECHNICAL SPECIFICATIONS
### 12.1 System Requirements
- **WordPress**: 5.0+ (Core platform)
- **PHP**: 7.4+ (Server-side language)
- **MySQL**: 5.7+ (Database system)
- **JavaScript**: ES6+ (Client-side functionality)
- **cURL**: HTTP client for API communication
- **JSON**: Data format for AI communication
### 12.2 Performance Specifications
- **Database**: 15 custom tables with optimized queries
- **Memory Usage**: Optimized memory usage and garbage collection
- **API Limits**: Efficient API usage and rate limiting
- **Caching**: Advanced caching and performance optimization
- **Asset Delivery**: Optimized asset loading and delivery
### 12.3 Security Specifications
- **Data Sanitization**: Comprehensive input sanitization
- **Nonce Verification**: WordPress nonce security
- **User Permissions**: Role-based access control
- **API Security**: Secure API communication
- **Data Encryption**: Sensitive data encryption
---
## 13. FUTURE ROADMAP
### 13.1 Planned Features
- **Advanced AI Models**: Integration with additional AI models
- **Enhanced Analytics**: Advanced analytics and reporting features
- **Mobile App**: Mobile application for content management
- **API Expansion**: Extended API capabilities
- **Third-party Integrations**: Additional third-party service integrations
### 13.2 Performance Improvements
- **Database Optimization**: Further database performance optimization
- **Caching Enhancement**: Advanced caching and performance optimization
- **API Optimization**: Further API usage optimization
- **Asset Optimization**: Enhanced asset optimization
- **Memory Optimization**: Advanced memory usage optimization
### 13.3 Security Enhancements
- **Advanced Security**: Enhanced security features
- **Data Protection**: Advanced data protection and privacy
- **Compliance**: Industry standard compliance and security
- **Audit Logging**: Enhanced audit logging and monitoring
- **Access Control**: Advanced access control and permissions
---
## 14. SUPPORT & MAINTENANCE
### 14.1 Support System
- **Documentation**: Comprehensive documentation and guides
- **Help System**: Integrated help system and tutorials
- **Community**: Community support and forums
- **Professional Support**: Enterprise-level support and maintenance
- **Training**: User training and onboarding
### 14.2 Maintenance
- **Regular Updates**: Regular plugin updates and improvements
- **Security Updates**: Security updates and patches
- **Performance Optimization**: Continuous performance optimization
- **Bug Fixes**: Bug fixes and issue resolution
- **Feature Enhancements**: New feature development and enhancement
### 14.3 Monitoring
- **System Health**: Continuous system health monitoring
- **Performance Tracking**: Performance monitoring and optimization
- **Error Tracking**: Error tracking and resolution
- **Usage Analytics**: Usage analytics and optimization
- **User Feedback**: User feedback collection and implementation
---
## 15. CONCLUSION
The Igny8 AI SEO Plugin v0.1 represents a comprehensive, AI-powered content management and SEO optimization platform with **COMPLETE REFACTOR IMPLEMENTED**. With 8 active modules, 200+ functions, and advanced AI integration, the system provides:
- **Complete Content Management**: From planning to publishing ✅
- **Advanced AI Integration**: OpenAI and Runware API integration ✅
- **Comprehensive SEO Tools**: Keyword research to performance monitoring ✅
- **Automated Workflows**: ⚠️ END-TO-END PROCESS AUTOMATION AT RISK
- **Advanced Analytics**: Performance tracking and reporting ✅
- **Scalable Architecture**: Modular, extensible design ✅
- **Production Ready**: ⚠️ MANUAL FUNCTIONS STABLE, CRON FUNCTIONS UNSTABLE
### Critical Status Summary
- **Manual Functions**: ✅ Fully operational and healthy
- **Cron Functions**: ❌ High risk of failure due to architectural discrepancies
- **Recommendation**: 🔴 IMMEDIATE action required to align cron functions with manual counterparts
- **Priority**: CRITICAL - Automation system reliability compromised
The system requires immediate attention to resolve cron vs manual function discrepancies before automation can be considered reliable for production use.
---
## File Structure Summary
### Core Files
- `igny8.php` - Main plugin file
- `install.php` - Installation script
- `uninstall.php` - Uninstallation script
- `igny8-wp-load-handler.php` - WordPress load handler
### Module Files
- `modules/modules-pages/` - Module interfaces
- `modules/components/` - Reusable components
- `modules/config/` - Configuration files
### AI Integration
- `ai/integration.php` - AI service integration
- `ai/openai-api.php` - OpenAI API client
- `ai/runware-api.php` - Runware API client
- `ai/modules-ai.php` - AI module functions
### Core System
- `core/admin/` - Admin interface
- `core/db/` - Database management
- `core/cron/` - Automation system
- `core/pages/` - Page templates
### Workflows
- `flows/` - Workflow automation
- `assets/` - Frontend assets
- `docs/` - Documentation
This snapshot provides a complete overview of the Igny8 AI SEO Plugin's current state, capabilities, and technical specifications, including critical automation issues that require immediate attention.

BIN
igny8-wp-plugin-for-reference-olny/docs/Igny8 WP Plugin to Igny8 App Migration Plan.docx Normal file
View File

Binary file not shown.

524
igny8-wp-plugin-for-reference-olny/docs/MIGRATION_PLAN_EXTRACTED.txt Normal file
View File

@@ -0,0 +1,524 @@
IGNY8 WP PLUGIN TO IGNY8 APP MIGRATION PLAN
============================================
SECTION 1 - CODEBASE & DIRECTORY STRUCTURE (IGNY8 APP)
Goal: Design the top-level and module-level folder hierarchy for the new Django + React (Vite + Tailwind) full-stack IGNY8 App, preserving 1:1 parity with the current WordPress plugin modules while introducing clear API, automation, and AI boundaries.
1.1 Top-Level Repository Layout
igny8-app/
backend/ # Django backend (core API, models, automation)
igny8_core/ # Main Django app (replaces plugin core)
__init__.py
settings.py # Env-aware settings (local / staging / prod)
urls.py
wsgi.py
asgi.py
modules/ # 1:1 migration of plugin modules
planner/
models.py
views.py
serializers.py
tasks.py # CRON/async/queue handlers
urls.py
writer/
thinker/
... (future: linker, optimizer, etc.)
api/ # Unified REST entrypoints
routes/
ai/
content.py
images.py
publish.py
reparse.py
system/
middleware/
auth/ # Multi-tenant + RBAC + Stripe linkage
models.py
roles.py
views.py
signals.py
serializers.py
utils/ # Shared helpers (AI, logs, etc.)
cron/ # Timed jobs (mapped from plugin CRON)
migrations/
manage.py
frontend/ # React + Vite + Tailwind UI
src/
app/
globals.css
layout.tsx
pages/ # Page-per-module parity with WP admin
PlannerPage.tsx
WriterPage.tsx
ThinkerPage.tsx
DashboardPage.tsx
components/
ui/ # Local UI library (Card, Button, etc.)
layout/
charts/
hooks/
services/ # API clients (axios/fetch for each module)
store/ # Zustand/Redux state
vite.config.js
package.json
tsconfig.json
infra/ # Docker, Portainer, Caddy, Postgres, Redis
docker-compose.yml
caddy/
scripts/
dev-config.yml
README.md
docs/
MIGRATION_PLAN.md
API_REFERENCE.md
DATABASE_MAP.md
.env / .env.dev / .env.prod # environment-specific configs
1.2 Key Design Rules
- Modules: Each former WordPress module = isolated Django app inside /backend/modules/
- API Layer: Use /backend/api/routes/{domain}/ for all external triggers
- Frontend: Page = Module parity (PlannerPage.tsx, etc.)
- UI Library: /frontend/src/components/ui/ replaces @/components/ui/ from TailAdmin
- DevOps: Single infra/docker-compose.yml defines the full stack
- Roles/Billing: /backend/auth/roles.py + Stripe integration
- Docs: /docs folder in-repo
1.3 Role-Based Access (RBAC) Foundation
Roles:
- Owner: Full access to all tenants, billing, and automation
- Admin: Manage content modules, view billing but not edit
- Editor: Generate AI content, manage clusters/tasks
- Viewer: Read-only dashboards
- SystemBot: Automation + CRON actions (No UI, API-only)
1.4 AI-Assisted Dev Environment (Cursor / Local PC)
- Expose selective sub-repos /backend/modules/, /frontend/src/, /docs/ to GitHub/GitLab
- Keep /infra & .env excluded (.gitignore) for security
- AI Context Indexing: Each module includes README.md describing schema, routes, and functions
- Dockerized Dev Setup: Cursor runs Node + Python containers via docker-compose
- Source Sync Hooks: Git hooks ensure migrations and schema docs stay synchronized
SECTION 2 - DATABASE & SCHEMA MIGRATION PLAN
Goal: Migrate all IGNY8 custom database tables and essential data from WordPress to a Django + PostgreSQL schema.
2.1 IGNY8 Core Tables to Migrate 1:1
WP Table → Django Model:
- igny8_keywords → Keywords
- igny8_clusters → Clusters
- igny8_content_ideas → ContentIdeas
- igny8_tasks → Tasks
- igny8_variations → Variations
- igny8_prompts → Prompts
- igny8_logs → Logs
- igny8_images → Images
- igny8_schedules → Schedules
- igny8_settings → Settings (Split into SystemSettings and UserSettings)
- igny8_accounts → Accounts
- igny8_links → Links (Future)
- igny8_metrics → Metrics
2.2 WordPress Default Tables (Partial Extraction)
- wp_posts → WPPosts (ID, post_title, post_content, post_status, post_type, post_date)
- wp_postmeta → WPPostMeta (post_id, meta_key, meta_value - only IGNY8 keys)
- wp_users → WPUserMap (ID, user_email, display_name)
- wp_options → WPOptions (option_name, option_value - plugin config only)
2.3 Cross-System Integration Map
- Keywords/Clusters: App → WP via WP REST API
- Tasks/Content: App → WP via WP /wp-json/igny8/v1/import-content
- Images: App → WP via WP Media REST endpoint
- Settings: Bidirectional sync
- Logs/Metrics: App-only
2.4 Schema Example: Tasks Model (Django ORM)
Includes: id, cluster, idea, task_type, ai_model, prompt, raw_ai_response, status, result, timestamps, user, tenant
2.5 Database Migration & Sync Process
Steps: Export → Create Django models → Import data → Verify → Migrate WP data → Run integrity tests → Enable periodic sync
2.6 Tenant-Aware Model Design
Every model inherits from TenantBaseModel with tenant, created_at, updated_at fields.
SECTION 3 - COMPONENT & UI MAPPING PLAN
Goal: Rebuild the WordPress plugin's admin interface as React/Vite pages.
3.1 One-to-One Module → Page Mapping
- Planner Dashboard → PlannerPage.tsx (/planner)
- Writer Dashboard → WriterPage.tsx (/writer)
- Thinker → ThinkerPage.tsx (/thinker)
- Optimizer (Phase 2) → OptimizerPage.tsx (/optimizer)
- Linker (Phase 2) → LinkerPage.tsx (/linker)
- Settings → SettingsPage.tsx (/settings)
- Dashboard → DashboardPage.tsx (/dashboard)
3.2 Shared Frontend Component Map
- DataTable, FilterPanel, FormModal, ActionButtons, StatsCards, ToastNotifications, AIStatusBar, ConfirmDialog, TenantSwitcher
3.3 UI Data Flow Diagram (Per Module)
User → React Page → Zustand Store → API Service → Django API → AI Processing → Database → React Refresh
3.4 State Management Rules (Zustand)
Each module defines its store following the same interface pattern.
SECTION 4 - API ROUTES & AUTOMATION TRIGGERS
Goal: Define all Django REST API endpoints and automation triggers.
4.1 Unified API Structure
- /api/planner/ - Keyword → Cluster → Idea generation
- /api/writer/ - Content generation, reparsing, image injection
- /api/thinker/ - Prompt testing, image model handling
- /api/settings/ - Model rates, limits, keys, Stripe data
- /api/system/ - Metrics, logs, and CRON control
- /api/auth/ - Tenant registration, login, roles
- /api/publish/ - Push content/images to WP site
4.2 Example Endpoint Tree
Detailed endpoint listing for each module with GET/POST/DELETE methods
4.3 API → AI Execution Chain
Common AI service layer (/backend/utils/ai.py) handles all AI requests
4.4 Automation Triggers (Replacing WordPress CRON)
- auto_cluster_keywords: every 6h
- auto_generate_ideas: daily
- auto_generate_content: hourly
- auto_generate_images: hourly
- auto_publish_posts: daily
- cleanup_logs: weekly
4.5 Queue Control Logic
Shared queue core (/backend/utils/queue_manager.py) for automation and manual triggers
4.6 Stripe Integration (API)
Endpoints for billing, subscription, webhooks
4.7 AI Key & Model Management
Configured through /api/settings/ai-models
4.8 Example: /api/writer/generate/<id> Workflow
8-step process from React frontend to WordPress publish
4.9 Authentication & Role Guard Middleware
All endpoints protected by RoleRequired decorator
4.10 CRON & API Coherence
CRON functions reuse the same endpoints as manual buttons
SECTION 5 - WORDPRESS INTEGRATION & SYNC LAYER
Goal: Design a clean, secure bridge between Django backend and WordPress sites.
5.1 Integration Overview
- AI Content Publish: App → WP
- Image Upload: App → WP
- Settings Sync: Bidirectional
- Post Status Check: WP → App
- Keyword/Cluster Sync: App → WP
- Auth Link: Manual JWT-based connection
5.2 Connection Setup (One-Time Auth Handshake)
WPIntegration model stores site_url, api_key, tenant, status, last_sync
5.3 WordPress REST Endpoints (Added to Plugin)
- /wp-json/igny8/v1/import-content
- /wp-json/igny8/v1/upload-image
- /wp-json/igny8/v1/sync-settings
- /wp-json/igny8/v1/status
- /wp-json/igny8/v1/pull-updates
5.4 Django → WordPress Communication Flow
Example publishing workflow with request/response structure
5.5 WordPress Plugin: Receiving Side Implementation
Minimalistic handler example code
5.6 Bidirectional Settings Sync
Field mapping between App and WP
5.7 Multi-Tenant Integration Mapping
Each tenant can connect multiple WP sites
5.8 Sync Safety & Rate Control Layer
Queue throttling, error handling, fallback mode, audit logs
5.9 Security Model
JWT with 12h expiry, HMAC signatures, CORS whitelist
5.10 Example: Full Publish & Feedback Cycle
Complete workflow from user action to periodic sync
5.11 Future Extension (Phase-2+)
Planned integrations for metrics, links, user data, schema
SECTION 6 - DEPLOYMENT, ENVIRONMENT & LOCAL DEV PLAN
Goal: Define complete development, deployment, and synchronization environment.
6.1 Full Stack Architecture Summary
- Reverse Proxy: Caddy (80/443)
- Frontend: React (Vite) + Node 20 (8020→8021)
- Backend: Django + Gunicorn (8010→8011)
- Database: PostgreSQL 15 (5432)
- Cache/Queue: Redis 7 (6379)
- Admin DB UI: pgAdmin4 (5050)
- File Manager: Filebrowser (8080)
- Docker Manager: Portainer CE (9443/8000)
6.2 Environment File (.env)
Variables for DB, Redis, AI keys, Stripe, domains
6.3 Docker Compose Structure
Service definitions with volumes, networks, environment variables
6.4 Local Development Setup (Cursor AI)
Steps for local development with live mounts
6.5 Portainer Stack Deployment
Production deployment via Portainer stacks
6.6 Environment-Specific Configs
Separate configs for local, staging, production
6.7 Backup & Recovery Procedures
Automated backups for database, media, configs
SECTION 7 - DATA MIGRATION & SYNC STRATEGY
Goal: Extract, transform, and import all IGNY8 plugin data from WordPress MySQL to PostgreSQL.
7.1 Migration Overview
Extract from WP → Transform schema → Import to Django → Validate → Sync
7.2 Table Mapping Details
Complete mapping of all WP tables to Django models
7.3 Migration Phases
1. Extraction (Dump plugin tables)
2. Transformation (Convert to Postgres schema)
3. Import (Bulk insert via Django)
4. Validation (Compare counts, hashes)
5. Sync (Enable real-time sync to WP)
7.4 Extraction Script Example
Python script using mysql.connector
7.5 Transformation Example
Data transformation script
7.6 Import to Django
Django management command for bulk import
7.7 Verification Step
Comparison script for validation
7.8 Syncable Tables (Remain Linked to WP)
Tables that maintain bidirectional sync
7.9 Migration Validation Dashboard
UI section showing migration status
7.10 Rollback Strategy
Procedure for handling migration failures
7.11 Final Verification Checklist
Checkpoints for successful migration
7.12 Post-Migration Tasks
Deactivate old plugin CRON, update plugin config to Remote Mode
SECTION 8 - TENANCY, BILLING & USER ACCESS MODEL
Goal: Define multi-tenant access, workspace isolation, role permissions, and subscription billing.
8.1 Core Concepts
- Tenant: Logical workspace
- User: Authenticated account inside tenant
- Subscription: Stripe-linked billing plan
- Workspace: UI grouping under tenant
- Site Integration: Connected WordPress instances
8.2 Data Model Overview
Django Models: Tenant, User, Plan, Subscription
8.3 Stripe Integration Workflow
6-step process from plan selection to webhook handling
8.4 Credit System Logic
Credit costs per action:
- Keyword clustering: 1 credit / 30 keywords
- Content idea generation: 1 credit / idea
- Full blog content: 3 credits
- AI image generation: 1 credit / image
- Reparse content: 1 credit
- Auto publish: Free if already generated
8.5 Roles & Access Permissions
Owner, Admin, Editor, Viewer roles with specific permissions
8.6 Tenant Isolation Enforcement
Database-level, file-level, API-level, worker-level isolation
8.7 Tenant Dashboard Layout (Frontend)
React components for tenant management
8.8 Billing Plans (Finalized Baseline)
- Free/Trial: $1, 25 credits, 1 user, 1 site
- Starter: $39, 200 credits, 3 users, 3 sites
- Pro: $89, 600 credits, 5 users, 5 sites
- Agency: $199, 2000 credits, 15 users, 10 sites
- Custom/Enterprise: Variable
8.9 Webhooks for Sync
Stripe and WordPress webhook handlers
8.10 Suspended Tenant Behavior
Handling payment failures
8.11 Multi-Tenant CRON Scheduler
Per-tenant queue system
8.12 Cross-Module Tenant Integration
How each module enforces tenant boundaries
8.13 Stripe Integration Files
Backend implementation structure
8.14 Security Enforcement
Authentication, authorization, webhook validation, file access, admin audit
8.15 Example Flow - New Tenant Signup
Complete signup to activation workflow
SECTION 9 - AI AUTOMATION PIPELINE & TASK ENGINE
Goal: Establish unified, tenant-aware automation system for all AI-based tasks.
9.1 Core Design Principles
- Single-Item Execution
- Tenant Isolation
- Unified Scheduler
- Configurable Limits
- Recoverable Jobs
9.2 AI Task Types & Flow
- Planner: Keyword Clustering → Idea Generation
- Writer: AI Draft Generation → Reparse → Publish
- Thinker: Prompt Creation / Persona / Strategy
- Image Generator: DALL-E / Runware image tasks
- Linker (Phase-2): Backlink planner
9.3 Queue Architecture (Redis-Backed)
Redis 7.x with Celery or django-q, tenant-based queue naming
9.4 AI Execution Workflow
Scheduler → Redis Queue → Django Worker → AI Engine API → Parser Layer → DB + Logs
9.5 Execution Limits & Global Settings
Parameters for AI_MAX_ITEMS_PER_REQUEST, batch sizes, timeouts, retries, cost caps
9.6 Task Lifecycle (Writer Example)
Queued → Dispatch → AI Request → Response Handling → Validation → Storage → Optional Actions
9.7 CRON Automation Flows
- cron_auto_cluster(): 6h
- cron_auto_ideas(): 6h
- cron_auto_writer(): 3h
- cron_auto_image(): 3h
- cron_auto_publish(): 12h
- cron_cleanup_logs(): 24h
9.8 AI Model Routing Logic
Model selector with auto-balancing and fallback
9.9 AI Pipeline Directory Map
Backend module structure for AI pipeline
9.10 Credit Deduction Example
Credit deduction logic
9.11 Error Recovery Flow
Handling timeouts, invalid JSON, parser failures, sync failures, credit errors
9.12 Frontend Task Control (React Components)
TaskQueueTable, TaskControlPanel, AutomationConfigForm with WebSocket feed
9.13 Monitoring & Telemetry
Structured logging with tenant, task_type, status, duration, model, credits_spent, output_size
9.14 Local AI Dev Mode (Cursor-Ready)
Development configuration for local testing
9.15 Verification Checklist
Checkpoints for queue, worker, task enqueue, credit deduction, AI response, CRON logs
9.16 Future Enhancements
Parallel pipelines, semantic caching, rate shaping, cost anomaly alerts, tracing integration
SECTION 10 - SECURITY, LOGGING & MONITORING FRAMEWORK
Goal: Define full-stack security, audit, and observability framework.
10.1 Security Architecture Overview
Layers: Frontend, Backend, Database, AI Layer, Infrastructure, Integrations
10.2 Authentication & Token System
JWT authentication with tenant context injection, role verification, session expiry
10.3 Authorization & Role-Based Rules
Role access scope definitions
10.4 Secure API Architecture
Endpoint pattern, JWT verification, tenant match, role access, input validation
10.5 Stripe & Webhook Security
HMAC validation for webhooks
10.6 Data Encryption & Storage Policy
Encryption for credentials/keys, storage policies for AI responses, files, backups, logs
10.7 API Rate Limiting
Per tenant (30 req/min), per IP (100 req/min), per worker (1 AI request/iteration), per model (60 req/min)
10.8 Logging System Overview
Centralized logging: App → Django Logger → Postgres → Loki Stream → Grafana
10.9 Monitoring & Alerts Stack
Tools: Portainer, Loki, Grafana, Alertmanager, Redis Inspector
Custom alerts for AI timeout, failed tasks, Stripe failures, CRON lag
10.10 Data Backup & Recovery
Backup frequencies and retention:
- Postgres DB: Every 6 hours, 7 days retention
- FileBrowser/Media: Daily, 14 days
- Caddy/Config: Daily, 7 days
- Logs (Loki): Rolling window, 30 days
10.11 Error & Exception Handling
Handling for AI API errors, DB write errors, worker crashes, CRON failures, user API errors
10.12 Developer Audit Trail
Critical system events logged in igny8_audit with 1 year retention
10.13 Local Dev & Security Mirrors
Development configuration with AI_DEV_MODE, CORS settings, mock data
10.14 Security Verification Checklist
Checkpoints for HTTPS, JWT validation, tenant isolation, webhook verification, file access, backups, Redis security, network isolation, rate limiting
10.15 Future Enhancements
OAuth 2.0 login, tenant-level dashboards, ElasticSearch sink, offsite sync, smart anomaly detection
10.16 Final Summary
Security model fully container-aware and tenant-isolated
Logging & metrics unified under Loki + Grafana
Stripe billing, AI cost tracking, and access control audited
Developer-friendly dev mode supported
Production deployment validated under current Docker infrastructure
END OF DOCUMENT

308
igny8-wp-plugin-for-reference-olny/docs/TROUBLESHOOTING_Converting_to_blocks_and_image_shortcode_injection.md Normal file
View File

@@ -0,0 +1,308 @@
# TROUBLESHOOTING: Converting to Blocks and Image Shortcode Injection
**Date:** October 26, 2025
**Session Duration:** Extended debugging session
**Issue:** AI-generated content failing to save due to malformed heading blocks and shortcode injection failures
**Status:** ✅ **RESOLVED**
---
## 🚨 **PROBLEM SUMMARY**
The AI content generation pipeline was failing at the post creation stage due to:
1. **Malformed Heading Blocks**: `igny8_convert_to_wp_blocks()` was creating heading blocks without required `level` attributes
2. **Shortcode Injection Failure**: `insert_igny8_shortcode_blocks_into_blocks()` was skipping all heading blocks due to missing level attributes
3. **Complete Pipeline Failure**: Post creation was aborting when shortcode injection failed
4. **Incorrect Task Status**: Tasks were being marked as 'failed' instead of staying in draft status
### **Debug Log Evidence:**
```
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Skipping heading block #4 — missing 'level' attribute
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Skipping heading block #18 — missing 'level' attribute
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Skipping heading block #36 — missing 'level' attribute
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Skipping heading block #54 — missing 'level' attribute
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: ❌ Shortcode injection failed — no blocks found after serialization
[26-Oct-2025 11:23:00 UTC] IGNY8 DEBUG - Shortcode injection failed: No shortcodes found in parsed blocks
[26-Oct-2025 11:23:00 UTC] IGNY8 DEBUG: I AM ACTIVE AND RUNNING IN AJAX.PHP - igny8_create_post_from_ai_response() returned: false
```
---
## 🔍 **ROOT CAUSE ANALYSIS**
### **Primary Issue: Missing Level Attributes**
The `igny8_convert_to_wp_blocks()` function was generating heading blocks like this:
```php
// WRONG - Missing level attribute
"<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">Title</h2>\n<!-- /wp:heading -->"
```
Instead of:
```php
// CORRECT - With level attribute
"<!-- wp:heading {\"level\":2} -->\n<h2 class=\"wp-block-heading\">Title</h2>\n<!-- /wp:heading -->"
```
### **Secondary Issue: No Fallback Logic**
When shortcode injection failed, the entire post creation process was aborted with `return false`, preventing any content from being saved.
### **Tertiary Issue: Incorrect Task Status Management**
Tasks were being marked as 'failed' when post creation failed, instead of remaining in draft status for retry.
---
## 🛠️ **SOLUTIONS IMPLEMENTED**
### **1. Fixed Block Conversion Function**
**File:** `core/admin/ajax.php` (lines 4722-4727)
**Problem:** H2 headings missing level attributes
```php
// BEFORE (WRONG)
if (preg_match('/^<h([2])[^>]*>(.*?)<\/h\1>$/is', $block, $m)) {
$blocks[] = "<!-- wp:heading -->\n<h2 class=\"wp-block-heading\">{$m[2]}</h2>\n<!-- /wp:heading -->";
}
```
**Solution:** Added level attribute to all heading blocks
```php
// AFTER (FIXED)
if (preg_match('/^<h([2])[^>]*>(.*?)<\/h\1>$/is', $block, $m)) {
$blocks[] = "<!-- wp:heading {\"level\":2} -->\n<h2 class=\"wp-block-heading\">{$m[2]}</h2>\n<!-- /wp:heading -->";
}
```
### **2. Added Block Structure Validation**
**File:** `ai/modules-ai.php` (lines 1795-1827)
**New Function:** `igny8_validate_and_fix_blocks()`
```php
function igny8_validate_and_fix_blocks($block_content) {
if (empty($block_content)) {
return $block_content;
}
$blocks = parse_blocks($block_content);
$fixed_blocks = [];
foreach ($blocks as $index => $block) {
// Fix heading blocks missing level attribute
if (($block['blockName'] ?? null) === 'core/heading') {
$level = $block['attrs']['level'] ?? null;
if ($level === null) {
// Try to extract level from innerHTML
$inner_html = $block['innerHTML'] ?? '';
if (preg_match('/<h([1-6])[^>]*>/i', $inner_html, $matches)) {
$detected_level = intval($matches[1]);
$block['attrs']['level'] = $detected_level;
error_log("IGNY8 BLOCKS: Fixed heading block #$index - detected level $detected_level from innerHTML");
} else {
// Default to H2 if we can't detect
$block['attrs']['level'] = 2;
error_log("IGNY8 BLOCKS: Fixed heading block #$index - defaulted to level 2");
}
}
}
$fixed_blocks[] = $block;
}
return serialize_blocks($fixed_blocks);
}
```
### **3. Enhanced Shortcode Injection Debug Logging**
**File:** `ai/modules-ai.php` (lines 1862-1904)
**Added:** Comprehensive debug logging
```php
error_log("IGNY8 BLOCKS: Parsed " . count($blocks) . " total blocks");
foreach ($blocks as $index => $block) {
if (($block['blockName'] ?? null) === 'core/heading') {
$heading_blocks_found++;
$level = $block['attrs']['level'] ?? null;
error_log("IGNY8 BLOCKS: Heading block #$index - level: " . ($level ?? 'NULL') . ", innerHTML: " . substr($block['innerHTML'] ?? '', 0, 50) . "...");
if ($level !== 2) {
if ($level === null) {
error_log("IGNY8 BLOCKS: Skipping heading block #$index — missing 'level' attribute");
} else {
error_log("IGNY8 BLOCKS: Skipping heading block #$index — level $level (not H2)");
}
continue;
}
$valid_h2_blocks++;
// ... injection logic
}
}
error_log("IGNY8 BLOCKS: Summary - Total headings: $heading_blocks_found, Valid H2s: $valid_h2_blocks, Shortcodes injected: $injected");
```
### **4. Implemented Fallback Logic for Post Creation**
**File:** `ai/modules-ai.php` (lines 1203-1210, 1221-1225)
**Problem:** Post creation failed completely when shortcode injection failed
```php
// BEFORE (WRONG)
if (!$has_shortcode) {
error_log("IGNY8 DEBUG - Shortcode injection failed: No shortcodes found in parsed blocks");
igny8_log_ai_event('Shortcode Injection Failed', 'writer', 'content_generation', 'error', 'No shortcodes found after injection', 'Editor type: ' . $editor_type);
return false; // ← This aborted the entire process
}
```
**Solution:** Added fallback logic to continue without shortcodes
```php
// AFTER (FIXED)
if (!$has_shortcode) {
error_log("IGNY8 DEBUG - Shortcode injection failed: No shortcodes found in parsed blocks");
igny8_log_ai_event('Shortcode Injection Failed', 'writer', 'content_generation', 'warning', 'No shortcodes found after injection - proceeding without shortcodes', 'Editor type: ' . $editor_type);
// FALLBACK: Continue with post creation without shortcodes
$content = $final_block_content;
} else {
$content = $final_block_content;
}
```
### **5. Fixed Task Status Management**
**File:** `core/admin/ajax.php` (lines 1968-1972)
**Problem:** Tasks marked as 'failed' when post creation failed
```php
// BEFORE (WRONG)
} else {
// Update task status to failed if post creation failed
$wpdb->update(
$wpdb->prefix . 'igny8_tasks',
[
'status' => 'failed', // ← Wrong!
'updated_at' => current_time('mysql')
],
['id' => $task_id],
['%s', '%s'],
['%d']
);
}
```
**Solution:** Removed status change on failure
```php
// AFTER (FIXED)
} else {
// Log failure but DO NOT change task status - keep it as draft
igny8_log_ai_event('WordPress Post Creation Failed', 'writer', 'content_generation', 'error', 'Failed to create WordPress post from AI content', 'Task ID: ' . $task_id);
igny8_log_ai_event('AI Content Generation Failed', 'writer', 'content_generation', 'error', 'Content generation failed - post creation unsuccessful', 'Task ID: ' . $task_id);
}
```
---
## 📊 **BEFORE vs AFTER COMPARISON**
### **Before (Broken Pipeline):**
1. ❌ HTML → Blocks (missing level attributes)
2. ❌ Block Validation (skipped)
3. ❌ Shortcode Injection (failed - no valid H2s)
4. ❌ Post Creation (aborted with `return false`)
5. ❌ Task Status (set to 'failed')
### **After (Fixed Pipeline):**
1. ✅ HTML → Blocks (with proper level attributes)
2. ✅ Block Validation (auto-fixes malformed blocks)
3. ✅ Shortcode Injection (works with valid H2s)
4. ✅ Post Creation (succeeds with or without shortcodes)
5. ✅ Task Status (only changes on success)
---
## 🔧 **TECHNICAL DETAILS**
### **Files Modified:**
- `core/admin/ajax.php` - Fixed block conversion function
- `ai/modules-ai.php` - Added validation, enhanced logging, implemented fallbacks
### **New Functions Added:**
- `igny8_validate_and_fix_blocks()` - Block structure validation and repair
### **Functions Enhanced:**
- `igny8_convert_to_wp_blocks()` - Added level attributes to headings
- `insert_igny8_shortcode_blocks_into_blocks()` - Enhanced debug logging
- `igny8_create_post_from_ai_response()` - Added fallback logic
### **Debug Logging Added:**
- Block conversion progress
- Heading block analysis (level, content preview)
- Shortcode injection statistics
- Fallback warnings instead of errors
---
## 🎯 **RESOLUTION VERIFICATION**
### **Expected Debug Logs (After Fix):**
```
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Parsed 25 total blocks
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Heading block #4 - level: 2, innerHTML: <h2>Section Title</h2>...
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Heading block #18 - level: 2, innerHTML: <h2>Another Section</h2>...
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Injecting shortcode after H2 #2: [igny8-image id="desktop-2"] [igny8-image id="mobile-2"]
[26-Oct-2025 11:23:00 UTC] IGNY8 BLOCKS: Summary - Total headings: 4, Valid H2s: 4, Shortcodes injected: 3
[26-Oct-2025 11:23:00 UTC] IGNY8 DEBUG: I AM ACTIVE AND RUNNING IN AJAX.PHP - igny8_create_post_from_ai_response() returned: 123
```
### **Success Criteria Met:**
- ✅ All heading blocks have proper level attributes
- ✅ Shortcode injection works correctly
- ✅ Posts are created successfully
- ✅ Task status only changes on success
- ✅ Comprehensive debug logging available
- ✅ Fallback behavior when shortcodes fail
---
## 🚀 **LESSONS LEARNED**
### **Key Insights:**
1. **Block Structure Validation is Critical**: Gutenberg blocks require specific attributes to function properly
2. **Fallback Logic is Essential**: Pipeline should continue even when optional features fail
3. **Debug Logging is Invaluable**: Detailed logging helps identify issues quickly
4. **Task Status Management**: Only change status on actual success, not on partial failures
### **Best Practices Established:**
1. Always validate block structure before processing
2. Implement fallback logic for non-critical features
3. Use comprehensive debug logging for complex pipelines
4. Separate critical failures from optional feature failures
5. Maintain task status integrity for retry scenarios
---
## 📋 **MAINTENANCE NOTES**
### **Future Considerations:**
- Monitor debug logs for any new block structure issues
- Consider adding more robust HTML parsing for edge cases
- May need to enhance shortcode injection for different content types
- Keep fallback logic in mind for future pipeline additions
### **Testing Recommendations:**
- Test with various HTML content structures
- Verify shortcode injection with different heading patterns
- Confirm fallback behavior works correctly
- Monitor task status changes in production
---
**Session Completed:** October 26, 2025
**Status:** ✅ **FULLY RESOLVED**
**Next Steps:** Monitor production logs and verify stability

14
igny8-wp-plugin-for-reference-olny/docs/_README.php Normal file
View File

@@ -0,0 +1,14 @@
<?php
/**
* ==============================
* 📁 Folder Scope Declaration
* ==============================
* Folder: /docs/
* Purpose: Markdown docs only
* Rules:
* - Must contain only markdown files
* - Documentation and guides only
* - No executable code allowed
* - User and developer documentation
* - Architecture and API references
*/