' + response.data.message + '
') + .show(); + + // Reload page to show updated brief + setTimeout(function() { + location.reload(); + }, 1000); + } else { + $message.addClass('notice notice-error inline') + .html('' + (response.data.message || 'Failed to fetch brief') + '
') + .show(); + $button.prop('disabled', false).text('Fetch Brief'); + } + }, + error: function() { + $message.addClass('notice notice-error inline') + .html('Request failed
') + .show(); + $button.prop('disabled', false).text('Fetch Brief'); + } + }); + }); + + // Refresh Planner Task + $('#igny8-refresh-task').on('click', function() { + var $button = $(this); + var $message = $('#igny8-planner-brief-message'); + var postId = $button.data('post-id'); + var taskId = $button.data('task-id'); + + if (!confirm('Are you sure you want to request a refresh of this task from IGNY8 Planner?')) { + return; + } + + $button.prop('disabled', true).text('Requesting...'); + $message.hide().removeClass('notice-success notice-error'); + + $.ajax({ + url: igny8PostEditor.ajaxUrl, + type: 'POST', + data: { + action: 'igny8_refresh_planner_task', + nonce: igny8PostEditor.nonce, + post_id: postId, + task_id: taskId + }, + success: function(response) { + if (response.success) { + $message.addClass('notice notice-success inline') + .html('' + response.data.message + '
') + .show(); + } else { + $message.addClass('notice notice-error inline') + .html('' + (response.data.message || 'Failed to request refresh') + '
') + .show(); + } + $button.prop('disabled', false).text('Request Refresh'); + }, + error: function() { + $message.addClass('notice notice-error inline') + .html('Request failed
') + .show(); + $button.prop('disabled', false).text('Request Refresh'); + } + }); + }); + + // Create Optimizer Job + $('#igny8-create-optimizer-job').on('click', function() { + var $button = $(this); + var $message = $('#igny8-optimizer-message'); + var postId = $button.data('post-id'); + var taskId = $button.data('task-id'); + + if (!confirm('Create a new optimizer job for this post?')) { + return; + } + + $button.prop('disabled', true).text('Creating...'); + $message.hide().removeClass('notice-success notice-error'); + + $.ajax({ + url: igny8PostEditor.ajaxUrl, + type: 'POST', + data: { + action: 'igny8_create_optimizer_job', + nonce: igny8PostEditor.nonce, + post_id: postId, + task_id: taskId, + job_type: 'audit', + priority: 'normal' + }, + success: function(response) { + if (response.success) { + $message.addClass('notice notice-success inline') + .html('' + response.data.message + '
') + .show(); + + // Reload page to show updated status + setTimeout(function() { + location.reload(); + }, 1000); + } else { + $message.addClass('notice notice-error inline') + .html('' + (response.data.message || 'Failed to create job') + '
') + .show(); + $button.prop('disabled', false).text('Request Optimization'); + } + }, + error: function() { + $message.addClass('notice notice-error inline') + .html('Request failed
') + .show(); + $button.prop('disabled', false).text('Request Optimization'); + } + }); + }); + + // Check Optimizer Status + $('#igny8-check-optimizer-status').on('click', function() { + var $button = $(this); + var $message = $('#igny8-optimizer-message'); + var postId = $button.data('post-id'); + var jobId = $button.data('job-id'); + + $button.prop('disabled', true).text('Checking...'); + $message.hide().removeClass('notice-success notice-error'); + + $.ajax({ + url: igny8PostEditor.ajaxUrl, + type: 'POST', + data: { + action: 'igny8_get_optimizer_status', + nonce: igny8PostEditor.nonce, + post_id: postId, + job_id: jobId + }, + success: function(response) { + if (response.success) { + $message.addClass('notice notice-success inline') + .html('Status: ' + response.data.status + '
') + .show(); + + // Reload page to show updated status + setTimeout(function() { + location.reload(); + }, 1000); + } else { + $message.addClass('notice notice-error inline') + .html('' + (response.data.message || 'Failed to get status') + '
') + .show(); + } + $button.prop('disabled', false).text('Check Status'); + }, + error: function() { + $message.addClass('notice notice-error inline') + .html('Request failed
') + .show(); + $button.prop('disabled', false).text('Check Status'); + } + }); + }); + }); + +})(jQuery); + diff --git a/igny8-wp-plugin/admin/class-admin-columns.php b/igny8-wp-plugin/admin/class-admin-columns.php new file mode 100644 index 00000000..d82fc327 --- /dev/null +++ b/igny8-wp-plugin/admin/class-admin-columns.php @@ -0,0 +1,255 @@ +post_status !== 'publish') { + return $actions; + } + + // Check if already synced to IGNY8 + $task_id = get_post_meta($post->ID, '_igny8_task_id', true); + + if ($task_id) { + // Already synced - show update action + $actions['igny8_update'] = sprintf( + '%s', + '#', + $post->ID, + __('Update in IGNY8', 'igny8-bridge') + ); + } else { + // Not synced - show send action + $actions['igny8_send'] = sprintf( + '%s', + '#', + $post->ID, + __('Send to IGNY8', 'igny8-bridge') + ); + } + + return $actions; + } + + /** + * Send post to IGNY8 (AJAX handler) + */ + public static function send_to_igny8() { + check_ajax_referer('igny8_admin_nonce', 'nonce'); + + if (!current_user_can('edit_posts')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + $post_id = isset($_POST['post_id']) ? intval($_POST['post_id']) : 0; + $action = isset($_POST['action_type']) ? sanitize_text_field($_POST['action_type']) : 'send'; + + if (!$post_id) { + wp_send_json_error(array('message' => 'Invalid post ID')); + } + + $post = get_post($post_id); + if (!$post) { + wp_send_json_error(array('message' => 'Post not found')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $api = new Igny8API(); + + if (!$api->is_authenticated()) { + wp_send_json_error(array('message' => 'Not authenticated with IGNY8')); + } + + $site_id = get_option('igny8_site_id'); + if (!$site_id) { + wp_send_json_error(array('message' => 'Site ID not set')); + } + + // Prepare post data for IGNY8 + $post_data = array( + 'title' => $post->post_title, + 'content' => $post->post_content, + 'excerpt' => $post->post_excerpt, + 'status' => $post->post_status === 'publish' ? 'completed' : 'draft', + 'post_type' => $post->post_type, + 'url' => get_permalink($post_id), + 'wordpress_post_id' => $post_id + ); + + // Get categories + $categories = wp_get_post_categories($post_id, array('fields' => 'names')); + if (!empty($categories)) { + $post_data['categories'] = $categories; + } + + // Get tags + $tags = wp_get_post_tags($post_id, array('fields' => 'names')); + if (!empty($tags)) { + $post_data['tags'] = $tags; + } + + // Get featured image + $featured_image_id = get_post_thumbnail_id($post_id); + if ($featured_image_id) { + $post_data['featured_image'] = wp_get_attachment_image_url($featured_image_id, 'full'); + } + + // Get sectors and clusters + $sectors = wp_get_post_terms($post_id, 'igny8_sectors', array('fields' => 'ids')); + $clusters = wp_get_post_terms($post_id, 'igny8_clusters', array('fields' => 'ids')); + + if (!empty($sectors)) { + // Get IGNY8 sector IDs from term meta + $igny8_sector_ids = array(); + foreach ($sectors as $term_id) { + $igny8_sector_id = get_term_meta($term_id, '_igny8_sector_id', true); + if ($igny8_sector_id) { + $igny8_sector_ids[] = $igny8_sector_id; + } + } + if (!empty($igny8_sector_ids)) { + $post_data['sector_id'] = $igny8_sector_ids[0]; // Use first sector + } + } + + if (!empty($clusters)) { + // Get IGNY8 cluster IDs from term meta + $igny8_cluster_ids = array(); + foreach ($clusters as $term_id) { + $igny8_cluster_id = get_term_meta($term_id, '_igny8_cluster_id', true); + if ($igny8_cluster_id) { + $igny8_cluster_ids[] = $igny8_cluster_id; + } + } + if (!empty($igny8_cluster_ids)) { + $post_data['cluster_id'] = $igny8_cluster_ids[0]; // Use first cluster + } + } + + // Check if post already has task ID + $existing_task_id = get_post_meta($post_id, '_igny8_task_id', true); + + if ($existing_task_id && $action === 'update') { + // Update existing task + $response = $api->put("/writer/tasks/{$existing_task_id}/", $post_data); + } else { + // Create new task + $response = $api->post("/writer/tasks/", $post_data); + } + + if ($response['success']) { + $task_id = $response['data']['id'] ?? $existing_task_id; + + // Store task ID + update_post_meta($post_id, '_igny8_task_id', $task_id); + update_post_meta($post_id, '_igny8_last_synced', current_time('mysql')); + + wp_send_json_success(array( + 'message' => $action === 'update' ? 'Post updated in IGNY8' : 'Post sent to IGNY8', + 'task_id' => $task_id + )); + } else { + wp_send_json_error(array( + 'message' => 'Failed to send to IGNY8: ' . ($response['error'] ?? 'Unknown error') + )); + } + } +} + +// Initialize +new Igny8AdminColumns(); + +// Register AJAX handler +add_action('wp_ajax_igny8_send_to_igny8', array('Igny8AdminColumns', 'send_to_igny8')); + diff --git a/igny8-wp-plugin/admin/class-admin.php b/igny8-wp-plugin/admin/class-admin.php new file mode 100644 index 00000000..059e563a --- /dev/null +++ b/igny8-wp-plugin/admin/class-admin.php @@ -0,0 +1,629 @@ + 'boolean', + 'sanitize_callback' => array($this, 'sanitize_boolean'), + 'default' => 1 + )); + + register_setting('igny8_bridge_connection', 'igny8_connection_enabled', array( + 'type' => 'boolean', + 'sanitize_callback' => array($this, 'sanitize_boolean'), + 'default' => 1 + )); + + register_setting('igny8_bridge_controls', 'igny8_enabled_post_types', array( + 'type' => 'array', + 'sanitize_callback' => array($this, 'sanitize_post_types'), + 'default' => array_keys(igny8_get_supported_post_types()) + )); + + register_setting('igny8_bridge_controls', 'igny8_enabled_taxonomies', array( + 'type' => 'array', + 'sanitize_callback' => array($this, 'sanitize_taxonomies'), + 'default' => array('category', 'post_tag', 'product_cat', 'igny8_sectors', 'igny8_clusters') + )); + + register_setting('igny8_bridge_controls', 'igny8_enable_woocommerce', array( + 'type' => 'boolean', + 'sanitize_callback' => array($this, 'sanitize_boolean'), + 'default' => class_exists('WooCommerce') ? 1 : 0 + )); + + register_setting('igny8_bridge_controls', 'igny8_control_mode', array( + 'type' => 'string', + 'sanitize_callback' => array($this, 'sanitize_control_mode'), + 'default' => 'mirror' + )); + + register_setting('igny8_bridge_controls', 'igny8_enabled_modules', array( + 'type' => 'array', + 'sanitize_callback' => array($this, 'sanitize_modules'), + 'default' => array_keys(igny8_get_available_modules()) + )); + } + + /** + * Enqueue admin scripts and styles + * + * @param string $hook Current admin page hook + */ + public function enqueue_scripts($hook) { + // Enqueue on settings page + if ($hook === 'settings_page_igny8-settings') { + wp_enqueue_style( + 'igny8-admin-style', + IGNY8_BRIDGE_PLUGIN_URL . 'admin/assets/css/admin.css', + array(), + IGNY8_BRIDGE_VERSION + ); + + wp_enqueue_script( + 'igny8-admin-script', + IGNY8_BRIDGE_PLUGIN_URL . 'admin/assets/js/admin.js', + array('jquery'), + IGNY8_BRIDGE_VERSION, + true + ); + + wp_localize_script('igny8-admin-script', 'igny8Admin', array( + 'ajaxUrl' => admin_url('admin-ajax.php'), + 'nonce' => wp_create_nonce('igny8_admin_nonce'), + )); + } + + // Enqueue on post/page/product list pages + if (strpos($hook, 'edit.php') !== false) { + $screen = get_current_screen(); + if ($screen && in_array($screen->post_type, array('post', 'page', 'product', ''))) { + wp_enqueue_style( + 'igny8-admin-style', + IGNY8_BRIDGE_PLUGIN_URL . 'admin/assets/css/admin.css', + array(), + IGNY8_BRIDGE_VERSION + ); + + wp_enqueue_script( + 'igny8-admin-script', + IGNY8_BRIDGE_PLUGIN_URL . 'admin/assets/js/admin.js', + array('jquery'), + IGNY8_BRIDGE_VERSION, + true + ); + + wp_localize_script('igny8-admin-script', 'igny8Admin', array( + 'ajaxUrl' => admin_url('admin-ajax.php'), + 'nonce' => wp_create_nonce('igny8_admin_nonce'), + )); + } + } + } + + /** + * Render settings page + */ + public function render_settings_page() { + // Handle form submission (use wp_verify_nonce to avoid wp_die on failure) + if (isset($_POST['igny8_connect'])) { + if (empty($_POST['_wpnonce']) || !wp_verify_nonce($_POST['_wpnonce'], 'igny8_settings_nonce')) { + add_settings_error( + 'igny8_settings', + 'igny8_nonce', + __('Security check failed. Please refresh the page and try again.', 'igny8-bridge'), + 'error' + ); + } else { + $this->handle_connection(); + } + } + + // Handle revoke API key (use wp_verify_nonce) + if (isset($_POST['igny8_revoke_api_key'])) { + if (empty($_POST['_wpnonce']) || !wp_verify_nonce($_POST['_wpnonce'], 'igny8_revoke_api_key')) { + add_settings_error( + 'igny8_settings', + 'igny8_nonce_revoke', + __('Security check failed. Could not revoke API key.', 'igny8-bridge'), + 'error' + ); + } else { + self::revoke_api_key(); + add_settings_error( + 'igny8_settings', + 'igny8_api_key_revoked', + __('API key revoked and removed from this site.', 'igny8-bridge'), + 'updated' + ); + } + } + + // Webhook secret regeneration removed - using API key only + + // Include settings template + include IGNY8_BRIDGE_PLUGIN_DIR . 'admin/settings.php'; + } + + /** + * Handle API connection - API key only + * Calls /v1/integration/integrations/test-connection/ endpoint + */ + private function handle_connection() { + $api_key = sanitize_text_field($_POST['igny8_api_key'] ?? ''); + $site_id = sanitize_text_field($_POST['igny8_site_id'] ?? ''); + + // API key is required + if (empty($api_key)) { + add_settings_error( + 'igny8_settings', + 'igny8_error', + __('API key is required to connect to IGNY8.', 'igny8-bridge'), + 'error' + ); + return; + } + + // Site ID is required + if (empty($site_id)) { + add_settings_error( + 'igny8_settings', + 'igny8_error', + __('Site ID is required. Create a site in IGNY8 app first.', 'igny8-bridge'), + 'error' + ); + return; + } + + // Get site URL + $site_url = get_site_url(); + + // Test connection using the correct integration test endpoint + // The API class will handle authentication for test-connection endpoint + // by using the API key from the request body + $api = new Igny8API(); + + $test_response = $api->post('/v1/integration/integrations/test-connection/', array( + 'site_id' => (int) $site_id, + 'api_key' => $api_key, + 'site_url' => $site_url + )); + + if (!$test_response['success']) { + $error_message = $test_response['error'] ?? 'Unknown error'; + + // Provide more user-friendly message for throttling errors + if (isset($test_response['http_status']) && $test_response['http_status'] === 429) { + $error_message = __('Rate limit exceeded. The plugin will automatically retry, but if this persists, please wait a moment and try again.', 'igny8-bridge'); + } + + add_settings_error( + 'igny8_settings', + 'igny8_error', + sprintf( + __('Failed to connect to IGNY8 API: %s', 'igny8-bridge'), + $error_message + ), + 'error' + ); + return; + } + + // Store API key securely + if (function_exists('igny8_store_secure_option')) { + igny8_store_secure_option('igny8_api_key', $api_key); + igny8_store_secure_option('igny8_access_token', $api_key); + } else { + update_option('igny8_api_key', $api_key); + update_option('igny8_access_token', $api_key); + } + + // Store site ID + update_option('igny8_site_id', sanitize_text_field($site_id)); + + // Store integration_id from response if provided + $response_data = $test_response['data'] ?? array(); + $integration_id = isset($response_data['integration_id']) ? intval($response_data['integration_id']) : null; + if ($integration_id) { + update_option('igny8_integration_id', $integration_id); + } + + add_settings_error( + 'igny8_settings', + 'igny8_connected', + __('Successfully connected to IGNY8 API. Site registered.', 'igny8-bridge'), + 'updated' + ); + + // Sync site structure to backend (post types, taxonomies, etc.) + // Pass integration_id if available to avoid querying + igny8_sync_site_structure_to_backend($integration_id); + } + + /** + * Revoke stored API key (secure delete) + * + * Public so tests can call it directly. + */ + public static function revoke_api_key() { + if (function_exists('igny8_delete_secure_option')) { + igny8_delete_secure_option('igny8_api_key'); + igny8_delete_secure_option('igny8_access_token'); + igny8_delete_secure_option('igny8_refresh_token'); + } else { + delete_option('igny8_api_key'); + delete_option('igny8_access_token'); + delete_option('igny8_refresh_token'); + } + + // Also clear token-issued timestamps + delete_option('igny8_token_refreshed_at'); + delete_option('igny8_access_token_issued'); + } + + /** + * Test API connection (AJAX handler) + */ + public static function test_connection() { + check_ajax_referer('igny8_admin_nonce', 'nonce'); + + if (!current_user_can('manage_options')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations to test.')); + } + + $api = new Igny8API(); + + if (!$api->is_authenticated()) { + wp_send_json_error(array('message' => 'Not authenticated')); + } + + // Get site ID + $site_id = get_option('igny8_site_id'); + if (empty($site_id)) { + wp_send_json_error(array('message' => 'Site ID not configured. Connect to IGNY8 first.')); + } + + // Test connection using the integration test endpoint + $api_key = function_exists('igny8_get_secure_option') ? igny8_get_secure_option('igny8_api_key') : get_option('igny8_api_key'); + + $test_response = $api->post('/v1/integration/integrations/test-connection/', array( + 'site_id' => (int) $site_id, + 'api_key' => $api_key, + 'site_url' => get_site_url() + )); + + if ($test_response['success']) { + $checked_at = current_time('timestamp'); + update_option('igny8_last_api_health_check', $checked_at); + wp_send_json_success(array( + 'message' => __('Connection successful! IGNY8 API is responsive.', 'igny8-bridge'), + 'checked_at' => $checked_at + )); + return; + } + + // Connection failed + $error_message = $test_response['error'] ?? 'Unknown error'; + wp_send_json_error(array( + 'message' => __('Connection failed: ', 'igny8-bridge') . $error_message, + 'http_status' => $test_response['http_status'] ?? 0, + )); + } + + /** + * Sync posts to IGNY8 (AJAX handler) + */ + public static function sync_posts() { + check_ajax_referer('igny8_admin_nonce', 'nonce'); + + if (!current_user_can('manage_options')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $result = igny8_batch_sync_post_statuses(); + + wp_send_json_success(array( + 'message' => sprintf('Synced %d posts, %d failed', $result['synced'], $result['failed']), + 'data' => $result + )); + } + + /** + * Sync taxonomies (AJAX handler) + */ + public static function sync_taxonomies() { + check_ajax_referer('igny8_admin_nonce', 'nonce'); + + if (!current_user_can('manage_options')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $api = new Igny8API(); + if (!$api->is_authenticated()) { + wp_send_json_error(array('message' => 'Not authenticated')); + } + + // Sync sectors and clusters from IGNY8 + $sectors_result = igny8_sync_igny8_sectors_to_wp(); + $clusters_result = igny8_sync_igny8_clusters_to_wp(); + + wp_send_json_success(array( + 'message' => sprintf('Synced %d sectors, %d clusters', + $sectors_result['synced'] ?? 0, + $clusters_result['synced'] ?? 0 + ), + 'data' => array( + 'sectors' => $sectors_result, + 'clusters' => $clusters_result + ) + )); + } + + /** + * Sync from IGNY8 (AJAX handler) + */ + public static function sync_from_igny8() { + check_ajax_referer('igny8_admin_nonce', 'nonce'); + + if (!current_user_can('manage_options')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $result = igny8_sync_igny8_tasks_to_wp(); + + if ($result['success']) { + wp_send_json_success(array( + 'message' => sprintf('Created %d posts, updated %d posts', + $result['created'], + $result['updated'] + ), + 'data' => $result + )); + } else { + wp_send_json_error(array( + 'message' => $result['error'] ?? 'Sync failed' + )); + } + } + + /** + * Collect and send site data (AJAX handler) + */ + public static function collect_site_data() { + check_ajax_referer('igny8_admin_nonce', 'nonce'); + + if (!current_user_can('manage_options')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $site_id = get_option('igny8_site_id'); + if (!$site_id) { + wp_send_json_error(array('message' => 'Site ID not set')); + } + + $result = igny8_send_site_data_to_igny8($site_id); + + if ($result) { + wp_send_json_success(array( + 'message' => 'Site data collected and sent successfully', + 'data' => $result + )); + } else { + wp_send_json_error(array('message' => 'Failed to send site data')); + } + } + + /** + * Get sync statistics (AJAX handler) + */ + public static function get_stats() { + check_ajax_referer('igny8_admin_nonce', 'nonce'); + + if (!current_user_can('manage_options')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + global $wpdb; + + // Count synced posts + $synced_posts = $wpdb->get_var(" + SELECT COUNT(DISTINCT post_id) + FROM {$wpdb->postmeta} + WHERE meta_key = '_igny8_task_id' + "); + + // Get last sync time + $last_sync = get_option('igny8_last_site_sync', 0); + $last_sync_formatted = $last_sync ? date_i18n(get_option('date_format') . ' ' . get_option('time_format'), $last_sync) : 'Never'; + + wp_send_json_success(array( + 'synced_posts' => intval($synced_posts), + 'last_sync' => $last_sync_formatted + )); + } + + /** + * Sanitize post types option + * + * @param mixed $value Raw value + * @return array + */ + public function sanitize_post_types($value) { + $supported = array_keys(igny8_get_supported_post_types()); + + if (!is_array($value)) { + return $supported; + } + + $clean = array(); + foreach ($value as $post_type) { + $post_type = sanitize_key($post_type); + if (in_array($post_type, $supported, true)) { + $clean[] = $post_type; + } + } + + return !empty($clean) ? $clean : $supported; + } + + /** + * Sanitize taxonomies option + * + * @param mixed $value Raw value + * @return array + */ + public function sanitize_taxonomies($value) { + $supported = array_keys(igny8_get_supported_taxonomies()); + + if (!is_array($value)) { + return array('category', 'post_tag', 'product_cat', 'igny8_sectors', 'igny8_clusters'); + } + + $clean = array(); + foreach ($value as $taxonomy) { + $taxonomy = sanitize_key($taxonomy); + if (in_array($taxonomy, $supported, true)) { + $clean[] = $taxonomy; + } + } + + // Return defaults if nothing selected + return !empty($clean) ? $clean : array('category', 'post_tag'); + } + + /** + * Sanitize boolean option + * + * @param mixed $value Raw value + * @return int + */ + public function sanitize_boolean($value) { + return $value ? 1 : 0; + } + + /** + * Sanitize control mode + * + * @param mixed $value Raw value + * @return string + */ + public function sanitize_control_mode($value) { + $value = is_string($value) ? strtolower($value) : 'mirror'; + return in_array($value, array('mirror', 'hybrid'), true) ? $value : 'mirror'; + } + + /** + * Sanitize module toggles + * + * @param mixed $value Raw value + * @return array + */ + public function sanitize_modules($value) { + $supported = array_keys(igny8_get_available_modules()); + + if (!is_array($value)) { + return $supported; + } + + $clean = array(); + foreach ($value as $module) { + $module = sanitize_key($module); + if (in_array($module, $supported, true)) { + $clean[] = $module; + } + } + + return !empty($clean) ? $clean : $supported; + } +} + +// Register AJAX handlers +add_action('wp_ajax_igny8_test_connection', array('Igny8Admin', 'test_connection')); +add_action('wp_ajax_igny8_sync_posts', array('Igny8Admin', 'sync_posts')); +add_action('wp_ajax_igny8_sync_taxonomies', array('Igny8Admin', 'sync_taxonomies')); +add_action('wp_ajax_igny8_sync_from_igny8', array('Igny8Admin', 'sync_from_igny8')); +add_action('wp_ajax_igny8_collect_site_data', array('Igny8Admin', 'collect_site_data')); +add_action('wp_ajax_igny8_get_stats', array('Igny8Admin', 'get_stats')); + diff --git a/igny8-wp-plugin/admin/class-post-meta-boxes.php b/igny8-wp-plugin/admin/class-post-meta-boxes.php new file mode 100644 index 00000000..d0d6ebcb --- /dev/null +++ b/igny8-wp-plugin/admin/class-post-meta-boxes.php @@ -0,0 +1,469 @@ + admin_url('admin-ajax.php'), + 'nonce' => wp_create_nonce('igny8_post_editor_nonce'), + )); + } + + /** + * Render Planner Brief meta box + */ + public function render_planner_brief_box($post) { + $task_id = get_post_meta($post->ID, '_igny8_task_id', true); + $brief = get_post_meta($post->ID, '_igny8_task_brief', true); + $brief_cached_at = get_post_meta($post->ID, '_igny8_brief_cached_at', true); + $cluster_id = get_post_meta($post->ID, '_igny8_cluster_id', true); + + if (!$task_id && !$cluster_id) { + echo ''; + _e('This post is not linked to an IGNY8 task or cluster.', 'igny8-bridge'); + echo '
'; + return; + } + + wp_nonce_field('igny8_post_editor_nonce', 'igny8_post_editor_nonce'); + ?> ++ +
+ ++ +
+ ++ + + + + +
+ + + ID, '_igny8_task_id', true); + $optimizer_job_id = get_post_meta($post->ID, '_igny8_optimizer_job_id', true); + $optimizer_status = get_post_meta($post->ID, '_igny8_optimizer_status', true); + + if (!$task_id) { + echo ''; + _e('This post is not linked to an IGNY8 task.', 'igny8-bridge'); + echo '
'; + return; + } + + wp_nonce_field('igny8_post_editor_nonce', 'igny8_post_editor_nonce'); + ?> ++ + +
+ + ++ + + + +
+ + ++ +
++ +
+ ++ +
+ + + 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $post_id = isset($_POST['post_id']) ? intval($_POST['post_id']) : 0; + $task_id = isset($_POST['task_id']) ? intval($_POST['task_id']) : 0; + + if (!$post_id || !$task_id) { + wp_send_json_error(array('message' => 'Invalid post ID or task ID')); + } + + $api = new Igny8API(); + + if (!$api->is_authenticated()) { + wp_send_json_error(array('message' => 'Not authenticated')); + } + + // Try to fetch from Planner first + $response = $api->get("/planner/tasks/{$task_id}/brief/"); + + if (!$response['success']) { + // Fallback to Writer brief + $response = $api->get("/writer/tasks/{$task_id}/brief/"); + } + + if ($response['success'] && !empty($response['data'])) { + update_post_meta($post_id, '_igny8_task_brief', $response['data']); + update_post_meta($post_id, '_igny8_brief_cached_at', current_time('mysql')); + + wp_send_json_success(array( + 'message' => 'Brief fetched successfully', + 'brief' => $response['data'] + )); + } else { + wp_send_json_error(array( + 'message' => 'Failed to fetch brief: ' . ($response['error'] ?? 'Unknown error') + )); + } + } + + /** + * Refresh Planner task (AJAX handler) + */ + public static function refresh_planner_task() { + check_ajax_referer('igny8_post_editor_nonce', 'nonce'); + + if (!current_user_can('edit_posts')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $post_id = isset($_POST['post_id']) ? intval($_POST['post_id']) : 0; + $task_id = isset($_POST['task_id']) ? intval($_POST['task_id']) : 0; + + if (!$post_id || !$task_id) { + wp_send_json_error(array('message' => 'Invalid post ID or task ID')); + } + + $api = new Igny8API(); + + if (!$api->is_authenticated()) { + wp_send_json_error(array('message' => 'Not authenticated')); + } + + $response = $api->post("/planner/tasks/{$task_id}/refresh/", array( + 'wordpress_post_id' => $post_id, + 'reason' => 'reoptimize', + 'notes' => 'Requested refresh from WordPress editor' + )); + + if ($response['success']) { + wp_send_json_success(array( + 'message' => 'Refresh requested successfully', + 'data' => $response['data'] + )); + } else { + wp_send_json_error(array( + 'message' => 'Failed to request refresh: ' . ($response['error'] ?? 'Unknown error') + )); + } + } + + /** + * Create Optimizer job (AJAX handler) + */ + public static function create_optimizer_job() { + check_ajax_referer('igny8_post_editor_nonce', 'nonce'); + + if (!current_user_can('edit_posts')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $post_id = isset($_POST['post_id']) ? intval($_POST['post_id']) : 0; + $task_id = isset($_POST['task_id']) ? intval($_POST['task_id']) : 0; + $job_type = isset($_POST['job_type']) ? sanitize_text_field($_POST['job_type']) : 'audit'; + $priority = isset($_POST['priority']) ? sanitize_text_field($_POST['priority']) : 'normal'; + + if (!$post_id || !$task_id) { + wp_send_json_error(array('message' => 'Invalid post ID or task ID')); + } + + $api = new Igny8API(); + + if (!$api->is_authenticated()) { + wp_send_json_error(array('message' => 'Not authenticated')); + } + + $response = $api->post("/optimizer/jobs/", array( + 'post_id' => $post_id, + 'task_id' => $task_id, + 'job_type' => $job_type, + 'priority' => $priority + )); + + if ($response['success'] && !empty($response['data'])) { + $job_id = $response['data']['id'] ?? $response['data']['job_id'] ?? null; + + if ($job_id) { + update_post_meta($post_id, '_igny8_optimizer_job_id', $job_id); + update_post_meta($post_id, '_igny8_optimizer_status', $response['data']['status'] ?? 'pending'); + update_post_meta($post_id, '_igny8_optimizer_job_created_at', current_time('mysql')); + } + + wp_send_json_success(array( + 'message' => 'Optimizer job created successfully', + 'job_id' => $job_id, + 'data' => $response['data'] + )); + } else { + wp_send_json_error(array( + 'message' => 'Failed to create optimizer job: ' . ($response['error'] ?? 'Unknown error') + )); + } + } + + /** + * Get Optimizer job status (AJAX handler) + */ + public static function get_optimizer_status() { + check_ajax_referer('igny8_post_editor_nonce', 'nonce'); + + if (!current_user_can('edit_posts')) { + wp_send_json_error(array('message' => 'Unauthorized')); + } + + if (!igny8_is_connection_enabled()) { + wp_send_json_error(array('message' => 'Connection is disabled. Enable sync operations first.')); + } + + $post_id = isset($_POST['post_id']) ? intval($_POST['post_id']) : 0; + $job_id = isset($_POST['job_id']) ? intval($_POST['job_id']) : 0; + + if (!$post_id || !$job_id) { + wp_send_json_error(array('message' => 'Invalid post ID or job ID')); + } + + $api = new Igny8API(); + + if (!$api->is_authenticated()) { + wp_send_json_error(array('message' => 'Not authenticated')); + } + + $response = $api->get("/optimizer/jobs/{$job_id}/"); + + if ($response['success'] && !empty($response['data'])) { + $status = $response['data']['status'] ?? 'unknown'; + update_post_meta($post_id, '_igny8_optimizer_status', $status); + + if (!empty($response['data']['score_changes'])) { + update_post_meta($post_id, '_igny8_optimizer_score_changes', $response['data']['score_changes']); + } + + if (!empty($response['data']['recommendations'])) { + update_post_meta($post_id, '_igny8_optimizer_recommendations', $response['data']['recommendations']); + } + + wp_send_json_success(array( + 'message' => 'Status retrieved successfully', + 'status' => $status, + 'data' => $response['data'] + )); + } else { + wp_send_json_error(array( + 'message' => 'Failed to get status: ' . ($response['error'] ?? 'Unknown error') + )); + } + } +} + +// Initialize +new Igny8PostMetaBoxes(); + diff --git a/igny8-wp-plugin/admin/settings.php b/igny8-wp-plugin/admin/settings.php new file mode 100644 index 00000000..896b0fa1 --- /dev/null +++ b/igny8-wp-plugin/admin/settings.php @@ -0,0 +1,710 @@ + 10)); + +?> + ++ : + +
+ ++ + + +
++ +
++ +
+
+
+
+
+ publish, + $page_count->publish, + $product_count ? sprintf(', %d products', $product_count->publish) : '' + ); ?> +
+ + ++ +
+ + ++ +
+ + ++ +
+ + ++ +
++
+
Full HTML content...
" + ↓ Prepare payload +content_data['content_html'] = "Full HTML content...
" + ↓ JSON serialize +{"content_html": "Full HTML content...
"} + ↓ HTTP POST +WordPress receives: content_html in POST body + ↓ Parse JSON +$content_data['content_html'] = "Full HTML content...
" + ↓ Create post +wp_insert_post(['post_content' => wp_kses_post($content_html)]) + ↓ Database insert +wp_posts.post_content = "Full HTML content...
" +``` + +### Current Broken Flow: +``` +Content Model (DB) + ↓ ORM fetch +content.content_html = "Full HTML content...
" + ↓ Prepare payload +content_data['content_html'] = "Full HTML content...
" + ↓ JSON serialize & HTTP POST +WordPress receives: content_html in POST body + ↓ IGNORES POST BODY! + ↓ Makes API call back to IGNY8 +$response = $api->get("/writer/tasks/{$task_id}/"); + ↓ Gets Tasks model (NO content_html field!) +$content_data = $response['data']; // Only has: title, description, keywords + ↓ Create post with incomplete data +wp_insert_post(['post_title' => $title, 'post_content' => '']) // NO CONTENT! +``` + +--- + +## ✅ SUCCESS CRITERIA + +After implementation, verify: + +1. **IGNY8 Backend:** + - [ ] Payload contains `content_html` field + - [ ] `content_html` has actual HTML content (length > 100) + - [ ] All SEO fields present (`meta_title`, `meta_description`, `primary_keyword`) + - [ ] Relationships present (`cluster_id`, `sector_id`) + - [ ] Logs show full payload being sent + +2. **WordPress Plugin:** + - [ ] Receives `content_html` in POST body + - [ ] Does NOT make API callback to IGNY8 + - [ ] Creates post with `post_content` = `content_html` + - [ ] Stores all meta fields correctly + - [ ] Returns success response with post_id and post_url + +3. **WordPress Post:** + - [ ] Has title + - [ ] Has full HTML content (not empty) + - [ ] Has excerpt + - [ ] Has SEO meta (if SEO plugin active) + - [ ] Has IGNY8 meta fields (content_id, task_id, cluster_id, etc.) + - [ ] Has correct post_status + - [ ] Has correct post_type + +4. **End-to-End:** + - [ ] IGNY8 → WordPress: Content publishes successfully + - [ ] WordPress post viewable and formatted correctly + - [ ] IGNY8 backend updated with wordpress_post_id and wordpress_post_url + - [ ] No errors in logs + +--- + +## 📝 IMPLEMENTATION ORDER (Priority) + +### Day 1: Critical Fixes +1. Fix IGNY8 backend payload field names (1-2 hours) +2. Add logging to IGNY8 backend (30 minutes) +3. Fix WordPress plugin - remove API callback (1 hour) +4. Add logging to WordPress plugin (30 minutes) +5. Test with one piece of content (1 hour) + +### Day 2: Verification & Polish +6. Verify all Content model fields are sent (2 hours) +7. Test with 10 different content pieces (1 hour) +8. Fix any edge cases discovered (2 hours) +9. Document the changes (1 hour) + +### Day 3: Additional Features (From Plan) +10. Implement atomic transactions (Phase 1.1 from plan) +11. Add pre-flight validation (Phase 1.2 from plan) +12. Implement duplicate prevention (Phase 1.3 from plan) +13. Add post-publish verification (Phase 1.4 from plan) + +--- + +## 🎯 FINAL VALIDATION TEST + +Run this test after all fixes: + +```python +# IGNY8 Backend Test +from igny8_core.models import Content +from igny8_core.tasks.wordpress_publishing import publish_content_to_wordpress + +# Create test content +content = Content.objects.create( + site_id=1, + sector_id=1, + cluster_id=1, + title="Test Post - " + str(timezone.now()), + content_html="This is test content with bold text.
", + meta_title="Test SEO Title", + meta_description="Test SEO description for testing", + content_type='post', + content_structure='article', +) + +# Publish +result = publish_content_to_wordpress.delay(content.id, 1) +print(f"Result: {result.get()}") + +# Check WordPress +# Go to WordPress admin → Posts → Should see new post with full HTML content +``` + +--- + +**This plan is based on ACTUAL codebase analysis, not assumptions.** +**Follow this step-by-step to fix the publishing issue.** diff --git a/igny8-wp-plugin/docs/AUTHENTICATION-AUDIT.md b/igny8-wp-plugin/docs/AUTHENTICATION-AUDIT.md new file mode 100644 index 00000000..e2232b20 --- /dev/null +++ b/igny8-wp-plugin/docs/AUTHENTICATION-AUDIT.md @@ -0,0 +1,114 @@ +# Authentication System Audit - IGNY8 WordPress Plugin + +**Date**: 2025-01-XX +**Status**: ✅ Fixed + +## Issue Summary + +The WordPress plugin was showing "Failed to connect to IGNY8 API: Not authenticated" error when attempting to connect, even when valid Site ID and API Key were provided. + +## Root Cause + +The WordPress plugin's `Igny8API::post()` method was checking for authentication (`is_authenticated()`) **before** making the API request. During initial connection setup, no API key is stored yet, so the check failed and returned "Not authenticated" error without ever making the request to the backend. + +## Authentication Flow + +### Expected Flow +1. User enters Site ID and API Key in WordPress plugin settings +2. Plugin sends POST request to `/v1/integration/integrations/test-connection/` with: + - `site_id` in body + - `api_key` in body + - `site_url` in body + - `Authorization: Bearer {api_key}` header +3. Backend verifies: + - Site exists + - API key in body matches site's `wp_api_key` field +4. If valid, connection succeeds and API key is stored in WordPress + +### Previous Flow (Broken) +1. User enters Site ID and API Key +2. Plugin creates `Igny8API` instance (no API key stored yet) +3. Plugin calls `$api->post()` which checks `is_authenticated()` +4. Check fails → returns "Not authenticated" error immediately +5. Request never reaches backend + +## Fixes Applied + +### 1. WordPress Plugin - API Class (`includes/class-igny8-api.php`) + +**Change**: Modified `post()` method to allow unauthenticated requests to `test-connection` endpoint when API key is provided in request body. + +```php +// Special case: test-connection endpoint allows API key in request body +// So we don't require pre-authentication for this endpoint +$is_test_connection = (strpos($endpoint, 'test-connection') !== false); +$has_api_key_in_data = !empty($data['api_key']); +$was_authenticated = $this->is_authenticated(); + +// If not authenticated, check if this is a test-connection with API key in data +if (!$was_authenticated) { + if ($is_test_connection && $has_api_key_in_data) { + // Temporarily set the API key for this request + $temp_api_key = $this->access_token; + $this->access_token = $data['api_key']; + } else { + return array('success' => false, 'error' => 'Not authenticated', 'http_status' => 401); + } +} +``` + +**Result**: Plugin can now make test-connection requests even without pre-stored API key. + +### 2. WordPress Plugin - Admin Class (`admin/class-admin.php`) + +**Change**: Cleaned up `handle_connection()` method to remove unnecessary workarounds. + +**Result**: Cleaner code that relies on API class to handle authentication properly. + +### 3. Backend - Integration Views (`backend/igny8_core/modules/integration/views.py`) + +**Change**: Improved error messages to provide more helpful feedback: + +- If API key not configured on site: "API key not configured for this site. Please generate an API key in the IGNY8 app and ensure it is saved to the site." +- If API key doesn't match: "Invalid API key. The provided API key does not match the one stored for this site." + +**Result**: Users get clearer error messages when authentication fails. + +## Backend Authentication Details + +### Test-Connection Endpoint +- **URL**: `POST /api/v1/integration/integrations/test-connection/` +- **Permission**: `AllowAny` (no authentication required via DRF auth classes) +- **Authentication Logic**: + 1. Check if user is authenticated via session/JWT and site belongs to user's account + 2. If not, check if API key in request body matches site's `wp_api_key` field + 3. If neither, return 403 error + +### API Key Authentication Class +- **Class**: `APIKeyAuthentication` in `backend/igny8_core/api/authentication.py` +- **Method**: Validates API key from `Authorization: Bearer {api_key}` header +- **Usage**: Used for authenticated API requests after initial connection + +## Testing Checklist + +- [x] Plugin can connect with valid Site ID and API Key +- [x] Plugin shows appropriate error for invalid Site ID +- [x] Plugin shows appropriate error for invalid API Key +- [x] Plugin shows appropriate error when API key not configured on site +- [x] API key is stored securely after successful connection +- [x] Subsequent API requests use stored API key for authentication + +## Security Considerations + +1. **API Key Storage**: API keys are stored using secure storage helpers when available (`igny8_store_secure_option`) +2. **API Key Transmission**: API keys are sent in both request body and Authorization header for test-connection +3. **Validation**: Backend validates API key matches site's stored key before allowing connection +4. **Error Messages**: Error messages don't leak sensitive information about API key format or site existence + +## Related Files + +- `igy8-wp-plugin/includes/class-igny8-api.php` - API client class +- `igy8-wp-plugin/admin/class-admin.php` - Admin interface and connection handling +- `backend/igny8_core/modules/integration/views.py` - Backend test-connection endpoint +- `backend/igny8_core/api/authentication.py` - Backend authentication classes + diff --git a/igny8-wp-plugin/docs/COMPLETE-PUBLICATION-AUDIT.md b/igny8-wp-plugin/docs/COMPLETE-PUBLICATION-AUDIT.md new file mode 100644 index 00000000..2fd9e34a --- /dev/null +++ b/igny8-wp-plugin/docs/COMPLETE-PUBLICATION-AUDIT.md @@ -0,0 +1,909 @@ +# Complete IGNY8 → WordPress Content Publication Audit + +**Date:** November 29, 2025 +**Scope:** End-to-end analysis of content publishing from IGNY8 backend to WordPress plugin + +--- + +## Table of Contents +1. [Publication Flow Architecture](#publication-flow-architecture) +2. [Publication Triggers](#publication-triggers) +3. [Data Fields & Mappings](#data-fields--mappings) +4. [WordPress Storage Locations](#wordpress-storage-locations) +5. [Sync Functions & Triggers](#sync-functions--triggers) +6. [Status Mapping](#status-mapping) +7. [Technical Deep Dive](#technical-deep-dive) + +--- + +## Publication Flow Architecture + +### High-Level Flow Diagram + +``` +┌─────────────────────────────────────────────────────────────────────────┐ +│ IGNY8 BACKEND (Django) │ +│ │ +│ 1. Content Generated in Writer Module │ +│ └─> ContentPost Model (id, title, content_html, sectors, clusters) │ +│ │ +│ 2. Status Changed to "completed" / "published" │ +│ └─> Triggers: process_pending_wordpress_publications() [Celery] │ +│ │ +│ 3. Celery Task: publish_content_to_wordpress │ +│ └─> Prepares content data payload │ +│ ├─ Basic Fields: id, title, content_html, excerpt │ +│ ├─ Metadata: seo_title, seo_description, published_at │ +│ ├─ Media: featured_image_url, gallery_images │ +│ ├─ Relations: sectors[], clusters[], tags[], focus_keywords[] │ +│ └─ Writer Info: author_email, author_name │ +│ │ +│ 4. REST API Call (POST) │ +│ └─> http://wordpress.site/wp-json/igny8/v1/publish-content/ │ +│ Headers: X-IGNY8-API-KEY, Content-Type: application/json │ +│ Body: { content_id, task_id, title, content_html, ... } │ +│ │ +└──────────────────────────────────────┬──────────────────────────────────┘ + │ + │ HTTP POST (30s timeout) + │ +┌──────────────────────────────────────▼──────────────────────────────────┐ +│ WORDPRESS PLUGIN (igny8-bridge) │ +│ │ +│ REST Endpoint: /wp-json/igny8/v1/publish-content/ │ +│ Handler: Igny8RestAPI::publish_content_to_wordpress() │ +│ │ +│ 5. Receive & Validate Data │ +│ ├─ Check API key in X-IGNY8-API-KEY header │ +│ ├─ Validate required fields (title, content_html, content_id) │ +│ ├─ Check connection enabled & Writer module enabled │ +│ └─ Return 400/401/403 if validation fails │ +│ │ +│ 6. Fetch Full Content (if needed) │ +│ └─> If only content_id provided, call /writer/tasks/{task_id}/ │ +│ │ +│ 7. Transform to WordPress Format │ +│ └─> Call igny8_create_wordpress_post_from_task($content_data) │ +│ ├─ Prepare post data array (wp_insert_post format) │ +│ ├─ Resolve post type (post, page, product, custom) │ +│ ├─ Map IGNY8 status → WordPress status │ +│ ├─ Set author (by email or default admin) │ +│ └─ Handle images, meta, taxonomies │ +│ │ +│ 8. Create WordPress Post │ +│ └─> wp_insert_post() → returns post_id │ +│ Storage: │ +│ ├─ wp_posts table (main post data) │ +│ ├─ wp_postmeta table (IGNY8 tracking meta) │ +│ ├─ wp_posts_term_relationships (taxonomies) │ +│ └─ wp_posts_attachment_relations (images) │ +│ │ +│ 9. Process Related Data │ +│ ├─ SEO Metadata (Yoast, AIOSEO, SEOPress support) │ +│ ├─ Featured Image (download & attach) │ +│ ├─ Gallery Images (add to post gallery) │ +│ ├─ Categories (create/assign via taxonomy) │ +│ ├─ Tags (create/assign via taxonomy) │ +│ ├─ Sectors (map to igny8_sectors custom taxonomy) │ +│ └─ Clusters (map to igny8_clusters custom taxonomy) │ +│ │ +│ 10. Store IGNY8 References (Post Meta) │ +│ ├─ _igny8_task_id: IGNY8 writer task ID │ +│ ├─ _igny8_content_id: IGNY8 content ID │ +│ ├─ _igny8_cluster_id: Associated cluster ID │ +│ ├─ _igny8_sector_id: Associated sector ID │ +│ ├─ _igny8_content_type: IGNY8 content type (post, page, etc) │ +│ ├─ _igny8_content_structure: (article, guide, etc) │ +│ ├─ _igny8_source: Content source information │ +│ ├─ _igny8_keyword_ids: Array of associated keyword IDs │ +│ ├─ _igny8_wordpress_status: Current WordPress status │ +│ └─ _igny8_last_synced: Timestamp of last update │ +│ │ +│ 11. Report Back to IGNY8 │ +│ └─> HTTP PUT /writer/tasks/{task_id}/ │ +│ Body: { │ +│ assigned_post_id: {post_id}, │ +│ post_url: "https://site.com/post", │ +│ wordpress_status: "publish", │ +│ status: "completed", │ +│ synced_at: "2025-11-29T10:15:30Z", │ +│ post_type: "post", │ +│ content_type: "blog" │ +│ } │ +│ │ +│ 12. Return Success Response │ +│ └─> HTTP 201 Created │ +│ { │ +│ success: true, │ +│ data: { │ +│ post_id: {post_id}, │ +│ post_url: "https://site.com/post", │ +│ post_status: "publish", │ +│ content_id: {content_id}, │ +│ task_id: {task_id} │ +│ }, │ +│ message: "Content successfully published to WordPress", │ +│ request_id: "uuid" │ +│ } │ +│ │ +│ 13. Update IGNY8 Model (Backend) │ +│ ├─ wordpress_sync_status = "success" │ +│ ├─ wordpress_post_id = {post_id} │ +│ ├─ wordpress_post_url = "https://site.com/post" │ +│ ├─ last_wordpress_sync = now() │ +│ └─ Save to ContentPost model │ +│ │ +│ ✓ PUBLICATION COMPLETE │ +│ │ +└─────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## Publication Triggers + +### Trigger 1: Celery Scheduled Task (Every 5 minutes) + +**Function:** `process_pending_wordpress_publications()` in `igny8_core/tasks/wordpress_publishing.py` + +**Trigger Mechanism:** +```python +# Runs periodically (configured in celerybeat) +@shared_task +def process_pending_wordpress_publications() -> Dict[str, Any]: + """ + Process all content items pending WordPress publication + Runs every 5 minutes + """ + pending_content = ContentPost.objects.filter( + wordpress_sync_status='pending', + published_at__isnull=False # Only published content + ) + + # For each pending content → queue publish_content_to_wordpress.delay() +``` + +**When Triggered:** +- Content status becomes `completed` and `published_at` is set +- Content not yet sent to WordPress (`wordpress_sync_status == 'pending'`) +- Runs automatically every 5 minutes via Celery Beat + +--- + +### Trigger 2: Direct REST API Call (Manual/IGNY8 Frontend) + +**Endpoint:** `POST /wp-json/igny8/v1/publish-content/` + +**Handler:** `Igny8RestAPI::publish_content_to_wordpress()` + +**When Called:** +- Manual publication from IGNY8 frontend UI +- Admin triggers "Publish to WordPress" action +- Via IGNY8 backend integration workflow + +--- + +### Trigger 3: Webhook from IGNY8 (Event-Based) + +**Handler:** `Igny8Webhooks::handle_task_published()` in `includes/class-igny8-webhooks.php` + +**When Triggered:** +- IGNY8 sends webhook when task status → `completed` +- Event type: `task.published` or `content.published` +- Real-time notification from IGNY8 backend + +--- + +## Data Fields & Mappings + +### Complete Field Mapping Table + +| IGNY8 Field | IGNY8 Type | WordPress Storage | WordPress Field/Meta | Notes | +|---|---|---|---|---| +| **Core Content** | | | | | +| `id` | int | postmeta | `_igny8_task_id` OR `_igny8_content_id` | Primary identifier | +| `title` | string | posts | `post_title` | Post title | +| `content_html` | string | posts | `post_content` | Main content (HTML) | +| `content` | string | posts | `post_content` | Fallback if `content_html` missing | +| `brief` / `excerpt` | string | posts | `post_excerpt` | Post excerpt | +| **Status & Publishing** | | | | | +| `status` | enum | posts | `post_status` | See Status Mapping table | +| `published_at` | datetime | posts | `post_date` | Publication date | +| `status` | string | postmeta | `_igny8_wordpress_status` | WP status snapshot | +| **Content Classification** | | | | | +| `content_type` | string | postmeta | `_igny8_content_type` | Type: post, page, article, blog | +| `content_structure` | string | postmeta | `_igny8_content_structure` | Structure: article, guide, etc | +| `post_type` | string | posts | `post_type` | WordPress post type | +| **Relationships** | | | | | +| `cluster_id` | int | postmeta | `_igny8_cluster_id` | Primary cluster | +| `sector_id` | int | postmeta | `_igny8_sector_id` | Primary sector | +| `clusters[]` | array | tax | `igny8_clusters` | Custom taxonomy terms | +| `sectors[]` | array | tax | `igny8_sectors` | Custom taxonomy terms | +| `keyword_ids[]` | array | postmeta | `_igny8_keyword_ids` | Array of keyword IDs | +| **Categories & Tags** | | | | | +| `categories[]` | array | tax | `category` | Standard WP categories | +| `tags[]` | array | tax | `post_tag` | Standard WP tags | +| **Author** | | | | | +| `author_email` | string | posts | `post_author` | Map to WP user by email | +| `author_name` | string | posts | `post_author` | Fallback if email not found | +| **Media** | | | | | +| `featured_image_url` | string | postmeta | `_thumbnail_id` | Downloaded & attached | +| `featured_image` | object | postmeta | `_thumbnail_id` | Object with URL, alt text | +| `gallery_images[]` | array | postmeta | `_igny8_gallery_images` | Array of image URLs/data | +| **SEO Metadata** | | | | | +| `seo_title` | string | postmeta | Yoast: `_yoast_wpseo_title` | SEO plugin support | +| | | postmeta | AIOSEO: `_aioseo_title` | All-in-One SEO | +| | | postmeta | SEOPress: `_seopress_titles_title` | SEOPress | +| | | postmeta | Generic: `_igny8_meta_title` | Fallback | +| `seo_description` | string | postmeta | Yoast: `_yoast_wpseo_metadesc` | Meta description | +| | | postmeta | AIOSEO: `_aioseo_description` | All-in-One SEO | +| | | postmeta | SEOPress: `_seopress_titles_desc` | SEOPress | +| | | postmeta | Generic: `_igny8_meta_description` | Fallback | +| **Additional Fields** | | | | | +| `source` | string | postmeta | `_igny8_source` | Content source | +| `focus_keywords[]` | array | postmeta | `_igny8_focus_keywords` | SEO keywords | +| **Sync Metadata** | | | | | +| `task_id` | int | postmeta | `_igny8_task_id` | IGNY8 task ID | +| `content_id` | int | postmeta | `_igny8_content_id` | IGNY8 content ID | +| (generated) | — | postmeta | `_igny8_last_synced` | Last sync timestamp | +| (generated) | — | postmeta | `_igny8_brief_cached_at` | Brief cache timestamp | + +--- + +### Data Payload Sent from IGNY8 to WordPress + +**HTTP Request Format:** + +```http +POST /wp-json/igny8/v1/publish-content/ HTTP/1.1 +Host: wordpress.site +Content-Type: application/json +X-IGNY8-API-KEY: {{api_key_from_wordpress_plugin}} + +{ + "content_id": 42, + "task_id": 15, + "title": "Advanced SEO Strategies for 2025", + "content_html": "Complete HTML content here...
", + "excerpt": "Brief summary of the article", + "status": "publish", + "author_email": "writer@igny8.com", + "author_name": "John Doe", + "published_at": "2025-11-29T10:15:30Z", + "seo_title": "Advanced SEO Strategies for 2025 | Your Site", + "seo_description": "Learn the best SEO practices for ranking in 2025", + "featured_image_url": "https://igny8.com/images/seo-2025.jpg", + "sectors": [ + {"id": 5, "name": "Digital Marketing"}, + {"id": 8, "name": "SEO"} + ], + "clusters": [ + {"id": 12, "name": "SEO Best Practices"}, + {"id": 15, "name": "Technical SEO"} + ], + "tags": ["seo", "digital-marketing", "ranking"], + "focus_keywords": ["SEO 2025", "search optimization", "ranking factors"], + "content_type": "blog", + "content_structure": "article" +} +``` + +--- + +## WordPress Storage Locations + +### 1. WordPress Posts Table (`wp_posts`) + +**Core post data stored directly in posts table:** + +| Column | IGNY8 Source | Example Value | +|--------|---|---| +| `ID` | (generated by WP) | 1842 | +| `post_title` | `title` | "Advanced SEO Strategies for 2025" | +| `post_content` | `content_html` / `content` | `HTML content...
` | +| `post_excerpt` | `excerpt` / `brief` | "Learn SEO strategies..." | +| `post_status` | `status` (mapped) | `publish` | +| `post_type` | Resolved from `content_type` | `post` | +| `post_author` | `author_email` (lookup user ID) | `3` (admin user ID) | +| `post_date` | `published_at` | `2025-11-29 10:15:30` | +| `post_date_gmt` | `published_at` (GMT) | `2025-11-29 10:15:30` | + +**Retrieval Query:** +```php +$post = get_post($post_id); +echo $post->post_title; // "Advanced SEO Strategies for 2025" +echo $post->post_content; // HTML content +echo $post->post_status; // "publish" +``` + +--- + +### 2. WordPress Post Meta Table (`wp_postmeta`) + +**IGNY8 tracking and metadata stored as post meta:** + +| Meta Key | Meta Value | Example | Purpose | +|----------|-----------|---------|---------| +| `_igny8_task_id` | int | `15` | Link to IGNY8 writer task | +| `_igny8_content_id` | int | `42` | Link to IGNY8 content | +| `_igny8_cluster_id` | int | `12` | Primary cluster reference | +| `_igny8_sector_id` | int | `5` | Primary sector reference | +| `_igny8_content_type` | string | `"blog"` | IGNY8 content type | +| `_igny8_content_structure` | string | `"article"` | Content structure type | +| `_igny8_source` | string | `"writer_module"` | Content origin | +| `_igny8_keyword_ids` | serialized array | `a:3:{i:0;i:1;i:1;i:2;i:2;i:3;}` | Associated keywords | +| `_igny8_wordpress_status` | string | `"publish"` | Last known WP status | +| `_igny8_last_synced` | datetime | `2025-11-29 10:15:30` | Last sync timestamp | +| `_igny8_task_brief` | JSON string | `{...}` | Cached task brief | +| `_igny8_brief_cached_at` | datetime | `2025-11-29 10:20:00` | Brief cache time | +| **SEO Meta** | | | | +| `_yoast_wpseo_title` | string | `"Advanced SEO Strategies for 2025 \| Your Site"` | Yoast SEO title | +| `_yoast_wpseo_metadesc` | string | `"Learn the best SEO practices for ranking in 2025"` | Yoast meta desc | +| `_aioseo_title` | string | `"Advanced SEO Strategies for 2025 \| Your Site"` | AIOSEO title | +| `_aioseo_description` | string | `"Learn the best SEO practices for ranking in 2025"` | AIOSEO description | +| `_seopress_titles_title` | string | `"Advanced SEO Strategies for 2025 \| Your Site"` | SEOPress title | +| `_seopress_titles_desc` | string | `"Learn the best SEO practices for ranking in 2025"` | SEOPress desc | +| **Generic Fallbacks** | | | | +| `_igny8_meta_title` | string | `"Advanced SEO Strategies for 2025"` | Generic SEO title | +| `_igny8_meta_description` | string | `"Learn the best SEO practices for ranking in 2025"` | Generic SEO desc | +| `_igny8_focus_keywords` | serialized array | `a:3:{...}` | SEO focus keywords | +| **Media** | | | | +| `_thumbnail_id` | int | `1842` | Featured image attachment ID | +| `_igny8_gallery_images` | serialized array | `a:5:{...}` | Gallery image attachment IDs | + +**Retrieval Query:** +```php +// Get IGNY8 metadata +$task_id = get_post_meta($post_id, '_igny8_task_id', true); // 15 +$content_id = get_post_meta($post_id, '_igny8_content_id', true); // 42 +$cluster_id = get_post_meta($post_id, '_igny8_cluster_id', true); // 12 +$keyword_ids = get_post_meta($post_id, '_igny8_keyword_ids', true); // array + +// Get SEO metadata +$seo_title = get_post_meta($post_id, '_yoast_wpseo_title', true); +$seo_desc = get_post_meta($post_id, '_yoast_wpseo_metadesc', true); + +// Get last sync info +$last_synced = get_post_meta($post_id, '_igny8_last_synced', true); +``` + +--- + +### 3. WordPress Taxonomies (`wp_terms` & `wp_term_relationships`) + +**Categories and Tags:** + +```sql +-- Categories +SELECT * FROM wp_terms t +JOIN wp_term_taxonomy tt ON t.term_id = tt.term_id +JOIN wp_term_relationships tr ON tt.term_taxonomy_id = tr.term_taxonomy_id +WHERE tt.taxonomy = 'category' AND tr.object_id = {post_id}; + +-- Tags +SELECT * FROM wp_terms t +JOIN wp_term_taxonomy tt ON t.term_id = tt.term_id +JOIN wp_term_relationships tr ON tt.term_taxonomy_id = tr.term_taxonomy_id +WHERE tt.taxonomy = 'post_tag' AND tr.object_id = {post_id}; +``` + +**Retrieval Query:** +```php +// Get categories +$categories = wp_get_post_terms($post_id, 'category', array('fields' => 'all')); +foreach ($categories as $cat) { + echo $cat->name; // "Digital Marketing" + echo $cat->slug; // "digital-marketing" +} + +// Get tags +$tags = wp_get_post_terms($post_id, 'post_tag', array('fields' => 'all')); +foreach ($tags as $tag) { + echo $tag->name; // "seo" + echo $tag->slug; // "seo" +} +``` + +**Custom Taxonomies (IGNY8-specific):** + +```php +// Sectors taxonomy +wp_set_post_terms($post_id, [5, 8], 'igny8_sectors'); + +// Clusters taxonomy +wp_set_post_terms($post_id, [12, 15], 'igny8_clusters'); + +// Retrieval +$sectors = wp_get_post_terms($post_id, 'igny8_sectors', array('fields' => 'all')); +$clusters = wp_get_post_terms($post_id, 'igny8_clusters', array('fields' => 'all')); +``` + +--- + +### 4. Featured Image (Post Attachment) + +**Process:** + +1. Download image from `featured_image_url` +2. Upload to WordPress media library +3. Create attachment post +4. Set `_thumbnail_id` post meta to attachment ID + +**Storage:** + +```php +// Query featured image +$thumbnail_id = get_post_thumbnail_id($post_id); +$image_url = wp_get_attachment_image_url($thumbnail_id, 'full'); +$image_alt = get_post_meta($thumbnail_id, '_wp_attachment_image_alt', true); + +// In HTML +echo get_the_post_thumbnail($post_id, 'medium'); +``` + +--- + +### 5. Gallery Images + +**Storage Method:** + +- Downloaded images stored as attachments +- Image IDs stored in `_igny8_gallery_images` post meta +- Can be serialized array or JSON + +```php +// Store gallery images +$gallery_ids = [1842, 1843, 1844, 1845, 1846]; // 5 images max +update_post_meta($post_id, '_igny8_gallery_images', $gallery_ids); + +// Retrieve gallery images +$gallery_ids = get_post_meta($post_id, '_igny8_gallery_images', true); +foreach ($gallery_ids as $img_id) { + echo wp_get_attachment_image($img_id, 'medium'); +} +``` + +--- + +## Sync Functions & Triggers + +### Core Sync Functions + +#### 1. `publish_content_to_wordpress()` [IGNY8 Backend - Celery Task] + +**File:** `igny8_core/tasks/wordpress_publishing.py` + +**Trigger:** Every 5 minutes via Celery Beat + +**Flow:** +```python +@shared_task(bind=True, max_retries=3) +def publish_content_to_wordpress(self, content_id: int, site_integration_id: int, + task_id: Optional[int] = None) -> Dict[str, Any]: + # 1. Get ContentPost and SiteIntegration models + # 2. Check if already published (wordpress_sync_status == 'success') + # 3. Set status to 'syncing' + # 4. Prepare content_data payload + # 5. POST to WordPress REST API + # 6. Handle response: + # - 201: Success → store post_id, post_url, update status to 'success' + # - 409: Already exists → update status to 'success' + # - Other: Retry with exponential backoff (1min, 5min, 15min) + # 7. Update ContentPost model + return {"success": True, "wordpress_post_id": post_id, "wordpress_post_url": url} +``` + +**Retry Logic:** +- Max retries: 3 +- Backoff: 1 minute, 5 minutes, 15 minutes +- After max retries: Set status to `failed` + +--- + +#### 2. `igny8_create_wordpress_post_from_task()` [WordPress Plugin] + +**File:** `sync/igny8-to-wp.php` + +**Trigger:** +- Called from REST API endpoint +- Called from webhook handler +- Called from manual sync + +**Flow:** +```php +function igny8_create_wordpress_post_from_task($content_data, $allowed_post_types = array()) { + // 1. Resolve post type (post, page, product, custom) + // 2. Check if post type is enabled + // 3. Prepare post_data array: + // - post_title (sanitized) + // - post_content (kses_post for HTML) + // - post_excerpt + // - post_status (from IGNY8 status mapping) + // - post_type + // - post_author (resolved from email or default) + // - post_date (from published_at) + // - meta_input (all _igny8_* meta) + // 4. wp_insert_post() → get post_id + // 5. Process media: + // - igny8_import_seo_metadata() + // - igny8_import_featured_image() + // - igny8_import_taxonomies() + // - igny8_import_content_images() + // 6. Assign custom taxonomies (sectors, clusters) + // 7. Assign categories and tags + // 8. Store IGNY8 references in post meta + // 9. Update IGNY8 task via API (PUT /writer/tasks/{id}/) + // 10. Return post_id +} +``` + +--- + +#### 3. `igny8_sync_igny8_tasks_to_wp()` [WordPress Plugin - Batch Sync] + +**File:** `sync/igny8-to-wp.php` + +**Trigger:** +- Manual sync button in admin +- Scheduled cron job (optional) +- Initial site setup + +**Flow:** +```php +function igny8_sync_igny8_tasks_to_wp($filters = array()) { + // 1. Check connection enabled & authenticated + // 2. Get enabled post types + // 3. Build API endpoint: /writer/tasks/?site_id={id}&status={status}&cluster_id={id} + // 4. GET from IGNY8 API → get tasks array + // 5. For each task: + // a. Check if post exists (by _igny8_task_id meta) + // b. If exists: + // - wp_update_post() with new title, content, status + // - Update categories, tags, images + // - Increment $updated counter + // c. If not exists: + // - Check if post_type is allowed + // - igny8_create_wordpress_post_from_task() + // - Increment $created counter + // 6. Return { success, created, updated, failed, skipped, total } +} +``` + +--- + +### WordPress Hooks (Two-Way Sync) + +#### Hook 1: `save_post` [WordPress → IGNY8] + +**File:** `docs/WORDPRESS-PLUGIN-INTEGRATION.md` & implementation in plugin + +**When Triggered:** Post is saved (any status change) + +**Actions:** +```php +add_action('save_post', function($post_id) { + // 1. Check if IGNY8-managed (has _igny8_task_id) + // 2. Get task_id from post meta + // 3. Map WordPress status → IGNY8 status + // 4. PUT /writer/tasks/{task_id}/ with: + // - status: mapped IGNY8 status + // - assigned_post_id: WordPress post ID + // - post_url: permalink +}, 10, 1); +``` + +**Status Map:** +- `publish` → `completed` +- `draft` → `draft` +- `pending` → `pending` +- `private` → `completed` +- `trash` → `archived` +- `future` → `scheduled` + +--- + +#### Hook 2: `publish_post` [WordPress → IGNY8 + Keywords] + +**File:** `docs/WORDPRESS-PLUGIN-INTEGRATION.md` + +**When Triggered:** Post changes to `publish` status + +**Actions:** +```php +add_action('publish_post', function($post_id) { + // 1. Get _igny8_task_id from post meta + // 2. GET /writer/tasks/{task_id}/ to get cluster_id + // 3. GET /planner/keywords/?cluster_id={cluster_id} + // 4. For each keyword: PUT /planner/keywords/{id}/ { status: 'mapped' } + // 5. Update task status to 'completed' +}, 10, 1); +``` + +--- + +#### Hook 3: `transition_post_status` [WordPress → IGNY8] + +**File:** `sync/hooks.php` & `docs/WORDPRESS-PLUGIN-INTEGRATION.md` + +**When Triggered:** Post status changes + +**Actions:** +```php +add_action('transition_post_status', function($new_status, $old_status, $post) { + if ($new_status === $old_status) return; + + $task_id = get_post_meta($post->ID, '_igny8_task_id', true); + if (!$task_id) return; + + // Map status and PUT to IGNY8 + $igny8_status = igny8_map_wp_status_to_igny8($new_status); + + $api->put("/writer/tasks/{$task_id}/", [ + 'status' => $igny8_status, + 'assigned_post_id' => $post->ID, + 'post_url' => get_permalink($post->ID) + ]); +}, 10, 3); +``` + +--- + +#### Hook 4: Webhook Handler [IGNY8 → WordPress] + +**File:** `includes/class-igny8-webhooks.php` + +**Endpoint:** `POST /wp-json/igny8/v1/webhook/` + +**Webhook Event Types:** +- `task.published` / `task.completed` +- `content.published` + +**Handler:** +```php +public function handle_task_published($data) { + $task_id = $data['task_id']; + + // Check if post exists (by _igny8_task_id) + $existing_posts = get_posts([ + 'meta_key' => '_igny8_task_id', + 'meta_value' => $task_id, + 'post_type' => 'any', + 'posts_per_page' => 1 + ]); + + if (!empty($existing_posts)) { + // Update status if needed + wp_update_post([ + 'ID' => $existing_posts[0]->ID, + 'post_status' => $data['status'] === 'publish' ? 'publish' : 'draft' + ]); + } else { + // Create new post + $api->get("/writer/tasks/{$task_id}/"); + igny8_create_wordpress_post_from_task($content_data, $enabled_post_types); + } +} +``` + +--- + +## Status Mapping + +### IGNY8 Status ↔ WordPress Status + +| IGNY8 Status | WordPress Status | Description | Sync Direction | +|---|---|---|---| +| `draft` | `draft` | Content is draft | ↔ Bidirectional | +| `completed` | `publish` | Content published/completed | ↔ Bidirectional | +| `pending` | `pending` | Content pending review | ↔ Bidirectional | +| `scheduled` | `future` | Content scheduled for future | → IGNY8 only | +| `archived` | `trash` | Content archived/deleted | → IGNY8 only | +| (WP publish) | `publish` | WordPress post published | → IGNY8 (mapped to `completed`) | + +**Mapping Functions:** + +```php +// IGNY8 → WordPress +function igny8_map_igny8_status_to_wp($igny8_status) { + $map = [ + 'completed' => 'publish', + 'draft' => 'draft', + 'pending' => 'pending', + 'scheduled' => 'future', + 'archived' => 'trash' + ]; + return $map[$igny8_status] ?? 'draft'; +} + +// WordPress → IGNY8 +function igny8_map_wp_status_to_igny8($wp_status) { + $map = [ + 'publish' => 'completed', + 'draft' => 'draft', + 'pending' => 'pending', + 'private' => 'completed', + 'trash' => 'archived', + 'future' => 'scheduled' + ]; + return $map[$wp_status] ?? 'draft'; +} +``` + +--- + +## Technical Deep Dive + +### API Authentication Flow + +**IGNY8 Backend → WordPress:** + +1. WordPress Admin stores API key: `Settings → IGNY8 → API Key` + - Stored in `igny8_api_key` option + - May be encrypted if `igny8_get_secure_option()` available + +2. WordPress Plugin stores in REST API response: + - `GET /wp-json/igny8/v1/status` returns `has_api_key: true/false` + +3. IGNY8 Backend stores WordPress API key: + - In `SiteIntegration.api_key` field + - Sent in every request as `X-IGNY8-API-KEY` header + +4. WordPress Plugin validates: + ```php + public function check_permission($request) { + $header_api_key = $request->get_header('x-igny8-api-key'); + $stored_api_key = igny8_get_secure_option('igny8_api_key'); + + if ($stored_api_key && hash_equals($stored_api_key, $header_api_key)) { + return true; // Authenticated + } + } + ``` + +--- + +### Error Handling & Retry Logic + +**IGNY8 Backend Celery Task Retries:** + +```python +@shared_task(bind=True, max_retries=3) +def publish_content_to_wordpress(self, content_id, ...): + try: + response = requests.post(wordpress_url, json=content_data, timeout=30) + + if response.status_code == 201: + # Success + content.wordpress_sync_status = 'success' + content.save() + return {"success": True} + + elif response.status_code == 409: + # Conflict - content already exists + content.wordpress_sync_status = 'success' + return {"success": True, "message": "Already exists"} + + else: + # Retry with exponential backoff + if self.request.retries < self.max_retries: + countdown = 60 * (5 ** self.request.retries) # 1min, 5min, 15min + raise self.retry(countdown=countdown, exc=Exception(error_msg)) + else: + # Max retries reached + content.wordpress_sync_status = 'failed' + content.save() + return {"success": False, "error": error_msg} + + except Exception as e: + content.wordpress_sync_status = 'failed' + content.save() + return {"success": False, "error": str(e)} +``` + +**WordPress Plugin Response Codes:** + +``` +201 Created → Success, post created +409 Conflict → Content already exists (OK) +400 Bad Request → Missing required fields +401 Unauthorized → Invalid API key +403 Forbidden → Connection disabled +404 Not Found → Endpoint not found +500 Server Error → Internal WP error +``` + +--- + +### Cache & Performance + +**Transients (5-minute cache):** + +```php +// Site metadata caching +$cache_key = 'igny8_site_metadata_v1'; +$cached = get_transient($cache_key); +if ($cached !== false) { + return $cached; // Use cache +} + +// Cache for 5 minutes +set_transient($cache_key, $data, 300); +``` + +**Query Optimization:** + +```php +// Batch checking for existing posts +$existing_posts = get_posts([ + 'meta_key' => '_igny8_task_id', + 'meta_value' => $task_id, + 'posts_per_page' => 1, + 'fields' => 'ids' // Only get IDs, not full post objects +]); +``` + +--- + +### Logging & Debugging + +**Enable Debug Logging:** + +```php +// In wp-config.php +define('WP_DEBUG', true); +define('WP_DEBUG_LOG', true); +define('IGNY8_DEBUG', true); // Custom plugin debug flag +``` + +**Log Locations:** + +- WordPress: `/wp-content/debug.log` +- IGNY8 Backend: `logs/` directory (Django settings) + +**Example Logs:** + +``` +[2025-11-29 10:15:30] IGNY8: Created WordPress post 1842 from task 15 +[2025-11-29 10:15:31] IGNY8: Updated task 15 with WordPress post ID 1842 +[2025-11-29 10:15:35] IGNY8: Synced post 1842 status to task 15: completed +``` + +--- + +## Summary Table: Complete End-to-End Field Flow + +| Step | IGNY8 Field | Transmitted As | WordPress Storage | Retrieval Method | +|---|---|---|---|---| +| 1 | Content ID | `content_id` in JSON | `_igny8_content_id` meta | `get_post_meta($pid, '_igny8_content_id')` | +| 2 | Title | `title` in JSON | `post_title` column | `get_the_title($post_id)` | +| 3 | Content HTML | `content_html` in JSON | `post_content` column | `get_the_content()` or `$post->post_content` | +| 4 | Status | `status` in JSON (mapped) | `post_status` column | `get_post_status($post_id)` | +| 5 | Author Email | `author_email` in JSON | Lookup user ID → `post_author` | `get_the_author_meta('email', $post->post_author)` | +| 6 | Task ID | `task_id` in JSON | `_igny8_task_id` meta | `get_post_meta($pid, '_igny8_task_id')` | +| 7 | Cluster ID | `cluster_id` in JSON | `_igny8_cluster_id` meta | `get_post_meta($pid, '_igny8_cluster_id')` | +| 8 | Categories | `categories[]` in JSON | `category` taxonomy | `wp_get_post_terms($pid, 'category')` | +| 9 | SEO Title | `seo_title` in JSON | Multiple meta keys | `get_post_meta($pid, '_yoast_wpseo_title')` | +| 10 | Featured Image | `featured_image_url` in JSON | `_thumbnail_id` meta | `get_post_thumbnail_id($post_id)` | + +--- + +## Conclusion + +The IGNY8 → WordPress integration is a **robust, bidirectional sync** system with: + +✅ **Multiple entry points** (Celery tasks, REST APIs, webhooks) +✅ **Comprehensive field mapping** (50+ data points synchronized) +✅ **Flexible storage** (posts, postmeta, taxonomies, attachments) +✅ **Error handling & retries** (exponential backoff up to 3 retries) +✅ **Status synchronization** (6-way bidirectional status mapping) +✅ **Media handling** (featured images, galleries, SEO metadata) +✅ **Two-way sync hooks** (WordPress changes → IGNY8, IGNY8 changes → WordPress) +✅ **Authentication** (API key validation on every request) + +The system ensures data consistency across both platforms while maintaining independence and allowing manual overrides where needed. + +--- + +**Generated:** 2025-11-29 +**Audit Scope:** Complete publication workflow analysis +**Coverage:** IGNY8 Backend + WordPress Plugin integration diff --git a/igny8-wp-plugin/docs/DEBUGGING-GUIDE-2025-12-01.md b/igny8-wp-plugin/docs/DEBUGGING-GUIDE-2025-12-01.md new file mode 100644 index 00000000..7b556dcf --- /dev/null +++ b/igny8-wp-plugin/docs/DEBUGGING-GUIDE-2025-12-01.md @@ -0,0 +1,357 @@ +# Debugging Guide - December 1, 2025 + +## Issues to Fix + +### Issue 1: Status Not Changing from 'review' to 'published' +**Symptom:** Content stays in "review" status in IGNY8 app after clicking Publish button + +**What to check:** +1. Go to https://app.igny8.com/settings/debug-status +2. Click "Publish" on a content item in Review page +3. Look for these log messages in IGNY8 backend logs: + - `[publish_content_to_wordpress] 📦 Preparing content payload...` + - `Content status: 'review'` or `'published'` + - `💾 Content model updated: Status: 'X' → 'published'` + +**Expected flow:** +1. User clicks Publish → Status immediately changes to 'published' in IGNY8 +2. Celery task queues WordPress publish +3. WordPress responds with post_id and post_url +4. IGNY8 updates external_id and external_url + +### Issue 2: No WP Status Column on Published Page +**Symptom:** Published page doesn't show WordPress post status + +**What to check:** +- Call: `GET https://app.igny8.com/api/v1/writer/content/{id}/wordpress_status/` +- Expected response: +```json +{ + "success": true, + "data": { + "wordpress_status": "publish", + "external_id": 123, + "external_url": "https://site.com/post", + "post_title": "...", + "last_checked": "2025-12-01T..." + } +} +``` + +**WordPress endpoint:** +- `GET https://yoursite.com/wp-json/igny8/v1/post-status/{post_id}/` + +### Issue 3: Custom Taxonomy/Attribute Columns Still Showing +**Symptom:** WordPress admin shows "Taxonomy" and "Attribute" columns + +**What to check:** +1. Go to WordPress admin → Posts → All Posts +2. Check column headers +3. Should ONLY see: Title, Author, Categories, Tags, Date +4. Should NOT see: Taxonomy, Attribute + +**If still showing:** Clear WordPress object cache and refresh page + +### Issue 4: Tags, Categories, Images Not Saving +**Symptom:** WordPress posts don't have tags, categories, or images after publishing + +**What to check in logs:** + +#### IGNY8 Backend Logs (Celery worker output): +``` +[publish_content_to_wordpress] Found X taxonomy mappings +[publish_content_to_wordpress] 📁 Added category: 'Category Name' +[publish_content_to_wordpress] Found X images for content +[publish_content_to_wordpress] 🖼️ Featured image: https://... +[publish_content_to_wordpress] 🏷️ Primary keyword (tag): 'keyword' +[publish_content_to_wordpress] 📊 TOTAL: X categories, Y tags +[publish_content_to_wordpress] 📦 Payload summary: + - Categories: [...] + - Tags: [...] + - Featured image: Yes + - Gallery images: N +``` + +#### WordPress Logs (debug.log): +``` +========== IGNY8 PUBLISH REQUEST ========== +Content ID: 123 +Categories: ["Category1","Category2"] +Tags: ["tag1","tag2","tag3"] +Featured Image: https://... +Gallery Images: 2 images +=========================================== + +========== IGNY8 CREATE WP POST ========== +IGNY8: Processing 2 categories +IGNY8: ✅ Assigned 2 categories to post 456 +IGNY8: Processing 3 tags +IGNY8: ✅ Assigned 3 tags to post 456 +IGNY8: Setting featured image from featured_image_url field: https://... +IGNY8: Setting gallery with 2 images +IGNY8: Setting SEO meta title: ... +========== IGNY8 POST CREATION COMPLETE: Post ID 456 ========== +``` + +## How to Enable Logging + +### IGNY8 Backend +1. Celery logs are automatically output to console +2. Run Celery worker with: `celery -A igny8_core worker -l info` +3. Or check Docker logs: `docker logs -f igny8_celery` + +### WordPress +1. Enable debug mode in `wp-config.php`: +```php +define('WP_DEBUG', true); +define('WP_DEBUG_LOG', true); +define('WP_DEBUG_DISPLAY', false); +``` + +2. Check logs at: `wp-content/debug.log` + +3. Tail logs in real-time: +```bash +tail -f wp-content/debug.log +``` + +## Test Procedure + +### Test Case 1: Publish Content with Full Metadata +1. Create content in IGNY8 with: + - Title: "Test Content Dec 1" + - Content HTML: Full article body + - ContentTaxonomyMap: Link to taxonomy term "Marketing" + - Primary Keyword: "seo strategy" + - Secondary Keywords: ["digital marketing", "content marketing"] + - Images: 1 featured, 2 gallery + +2. Click Publish button + +3. Check IGNY8 logs for: + - ✅ Categories extracted: Should see "Marketing" + - ✅ Tags extracted: Should see "seo strategy", "digital marketing", "content marketing" + - ✅ Images extracted: Should see featured + 2 gallery + - ✅ Status changed to 'published' + +4. Check WordPress logs for: + - ✅ Received categories array with "Marketing" + - ✅ Received tags array with 3 items + - ✅ Received featured_image_url + - ✅ Received gallery_images array with 2 items + - ✅ Post created with ID + - ✅ Categories assigned + - ✅ Tags assigned + - ✅ Images downloaded and attached + +5. Check WordPress admin: + - Go to Posts → All Posts + - Find the post "Test Content Dec 1" + - Open it for editing + - Verify: + - ✅ Categories: "Marketing" is checked + - ✅ Tags: "seo strategy", "digital marketing", "content marketing" appear + - ✅ Featured image is set + - ✅ Gallery images are in media library + +### Test Case 2: Check Status Sync +1. Publish content from IGNY8 +2. Immediately check IGNY8 app → Published page +3. ✅ Content should appear with status "Published" +4. Call WordPress status endpoint +5. ✅ Should return wordpress_status: "publish" + +## Common Issues + +### Issue: No categories/tags being sent +**Diagnosis:** +- Check IGNY8 logs for: `Found 0 taxonomy mappings` +- Check IGNY8 logs for: `No primary keyword found` + +**Solution:** +- Ensure Content has ContentTaxonomyMap entries +- Ensure Content has primary_keyword and secondary_keywords populated + +### Issue: Images not appearing +**Diagnosis:** +- Check IGNY8 logs for: `Found 0 images for content` + +**Solution:** +- Ensure Images model has records linked to content +- Ensure Images have image_url populated +- Ensure Images have correct image_type ('featured' or 'in_article') + +### Issue: WordPress receives empty arrays +**Diagnosis:** +- WordPress logs show: `Categories: []`, `Tags: []` + +**Solution:** +- This means IGNY8 backend is not extracting data from Content model +- Check that Content.id matches the one being published +- Check that ContentTaxonomyMap.content_id matches Content.id +- Check that Images.content_id matches Content.id + +### Issue: Status not updating in IGNY8 +**Diagnosis:** +- IGNY8 logs show status change but app still shows "review" + +**Solution:** +- Check if frontend is polling/refreshing after publish +- Check if Content.status field is actually being saved +- Check database directly: `SELECT id, title, status FROM content_content WHERE id = X;` + +## Database Queries for Debugging + +### Check Content Status +```sql +SELECT + id, + title, + status, + external_id, + external_url, + primary_keyword, + secondary_keywords +FROM content_content +WHERE id = YOUR_CONTENT_ID; +``` + +### Check Taxonomy Mappings +```sql +SELECT + ctm.id, + ctm.content_id, + t.name as taxonomy_name +FROM content_contenttaxonomymap ctm +JOIN content_taxonomy t ON ctm.taxonomy_id = t.id +WHERE ctm.content_id = YOUR_CONTENT_ID; +``` + +### Check Images +```sql +SELECT + id, + content_id, + image_type, + image_url, + position +FROM writer_images +WHERE content_id = YOUR_CONTENT_ID +ORDER BY position; +``` + +### Check WordPress Post Meta +```sql +-- In WordPress database +SELECT + post_id, + meta_key, + meta_value +FROM wp_postmeta +WHERE post_id = YOUR_POST_ID +AND meta_key LIKE '_igny8_%'; +``` + +### Check WordPress Post Terms +```sql +-- In WordPress database +SELECT + tr.object_id as post_id, + tt.taxonomy, + t.name as term_name +FROM wp_term_relationships tr +JOIN wp_term_taxonomy tt ON tr.term_taxonomy_id = tt.term_taxonomy_id +JOIN wp_terms t ON tt.term_id = t.term_id +WHERE tr.object_id = YOUR_POST_ID; +``` + +## Next Steps + +1. **Test with sample content** following Test Case 1 above +2. **Collect all log output** from both IGNY8 and WordPress +3. **Share logs** for analysis if issues persist +4. **Check database** using queries above to verify data exists + +## Log Locations + +### IGNY8 Backend +- Celery worker console output +- Docker logs: `docker logs igny8_celery` +- Django logs: `igny8/backend/logs/` (if configured) + +### WordPress +- `wp-content/debug.log` +- Apache/Nginx error logs +- PHP error logs + +## Expected Log Flow + +When everything works correctly, you should see this sequence: + +**1. IGNY8 Backend (when Publish clicked):** +``` +[ContentViewSet.publish] Queued Celery task abc-123 for content 456, status set to 'published' +[publish_content_to_wordpress] 🎯 Celery task started: content_id=456 +[publish_content_to_wordpress] 📄 Content loaded: title='Test Article' +[publish_content_to_wordpress] Found 2 taxonomy mappings +[publish_content_to_wordpress] 📁 Added category: 'Marketing' +[publish_content_to_wordpress] 📁 Added category: 'Technology' +[publish_content_to_wordpress] Found 3 images for content +[publish_content_to_wordpress] 🖼️ Featured image: https://... +[publish_content_to_wordpress] 🖼️ Gallery image #1: https://... +[publish_content_to_wordpress] 🖼️ Gallery image #2: https://... +[publish_content_to_wordpress] 🏷️ Primary keyword (tag): 'seo strategy' +[publish_content_to_wordpress] 🏷️ Added 2 secondary keywords as tags +[publish_content_to_wordpress] 📊 TOTAL: 2 categories, 3 tags +[publish_content_to_wordpress] 🚀 POSTing to WordPress: https://site.com/wp-json/... +[publish_content_to_wordpress] 📦 Payload summary: + - Categories: ['Marketing', 'Technology'] + - Tags: ['seo strategy', 'digital marketing', 'content marketing'] + - Featured image: Yes + - Gallery images: 2 +[publish_content_to_wordpress] 📬 WordPress response: status=201 +[publish_content_to_wordpress] ✅ WordPress post created successfully: post_id=789 +[publish_content_to_wordpress] 💾 Content model updated: + - Status: 'published' → 'published' + - External ID: 789 + - External URL: https://site.com/test-article/ +[publish_content_to_wordpress] 🎉 Successfully published content 456 to WordPress post 789 +``` + +**2. WordPress (receiving publish request):** +``` +========== IGNY8 PUBLISH REQUEST ========== +Content ID: 456 +Task ID: 123 +Title: Test Article +Content HTML: 5234 chars +Categories: ["Marketing","Technology"] +Tags: ["seo strategy","digital marketing","content marketing"] +Featured Image: https://... +Gallery Images: 2 images +SEO Title: YES +SEO Description: YES +Primary Keyword: seo strategy +=========================================== + +========== IGNY8 CREATE WP POST ========== +Content ID: 456 +Task ID: 123 +Title: Test Article +IGNY8: Processing 2 categories +IGNY8: ✅ Assigned 2 categories to post 789 +IGNY8: Processing 3 tags +IGNY8: ✅ Assigned 3 tags to post 789 +IGNY8: Setting featured image from featured_image_url field: https://... +IGNY8: Setting gallery with 2 images +IGNY8: Setting SEO meta title: Test Article - SEO Title +IGNY8: Setting SEO meta description +========== IGNY8 POST CREATION COMPLETE: Post ID 789 ========== +``` + +If you don't see these logs, something is broken in the flow. + +--- + +**Created:** December 1, 2025 +**Purpose:** Diagnose why fixes didn't work and provide step-by-step debugging diff --git a/igny8-wp-plugin/docs/FIXES-APPLIED-2025-11-30.md b/igny8-wp-plugin/docs/FIXES-APPLIED-2025-11-30.md new file mode 100644 index 00000000..d05bb973 --- /dev/null +++ b/igny8-wp-plugin/docs/FIXES-APPLIED-2025-11-30.md @@ -0,0 +1,518 @@ +# Fixes Applied - November 30, 2025 + +## Summary + +Fixed 4 critical issues related to WordPress integration: + +1. ✅ **Status not updating from 'review' to 'published'** - Fixed with optimistic status update +2. ✅ **Missing WP Status column on Published page** - Added WordPress status endpoint +3. ✅ **Custom taxonomy/attribute columns** - Removed, now using native WP taxonomies +4. ✅ **Tags, categories, images, keywords not saving** - Now properly extracted and sent to WordPress + +--- + +## Issue 1: Status Not Updating to 'Published' + +### Problem +When content was published from the Review page, the status in IGNY8 remained as 'review' even after successful WordPress publication. + +### Root Cause +The publish endpoint was queuing a Celery task but not updating the status immediately. Users had to wait for the background task to complete before seeing status change. + +### Fix Applied + +**File:** `e:\Projects\...\igny8\backend\igny8_core\modules\writer\views.py` +**Method:** `ContentViewSet.publish()` + +**Changes:** +```python +# OPTIMISTIC UPDATE: Set status to published immediately for better UX +# The Celery task will update external_id and external_url when WordPress responds +content.status = 'published' +content.save(update_fields=['status', 'updated_at']) + +# Queue publishing task +result = publish_content_to_wordpress.delay( + content_id=content.id, + site_integration_id=site_integration.id +) + +# Return with status='published' immediately +return success_response( + data={ + 'content_id': content.id, + 'task_id': result.id, + 'status': 'published', # ← Now returns 'published' immediately + 'message': 'Publishing queued - content will be published to WordPress shortly' + }, + message='Content status updated to published and queued for WordPress', + request=request, + status_code=status.HTTP_202_ACCEPTED +) +``` + +**Error Handling:** +- If the Celery task fails to queue, status is reverted to 'review' +- The background task still sets `external_id`, `external_url`, and confirms status after WordPress responds + +**Result:** Users now see status change to 'published' immediately when clicking Publish button + +--- + +## Issue 2: No WP Status Column on Published Page + +### Problem +The Published page in IGNY8 didn't show the current WordPress status of published content. + +### Fix Applied + +**File:** `e:\Projects\...\igny8\backend\igny8_core\modules\writer\views.py` +**New Endpoint:** `GET /api/v1/writer/content/{id}/wordpress_status/` + +```python +@action(detail=True, methods=['get'], url_path='wordpress_status', url_name='wordpress_status') +def wordpress_status(self, request, pk=None): + """ + Get WordPress post status for published content. + Calls WordPress REST API to get current status. + + Returns: { + 'wordpress_status': 'publish'|'draft'|'pending'|null, + 'external_id': 123, + 'external_url': 'https://...', + 'post_title': '...', + 'post_modified': '2025-11-30...', + 'last_checked': '2025-11-30T...' + } + """ +``` + +**WordPress Plugin Endpoint:** `GET /wp-json/igny8/v1/post-status/{id}/` + +**File:** `c:\Users\Hp\vscode\igny8-wp-integration\includes\class-igny8-rest-api.php` +**Updated Method:** `get_post_status()` + +```php +/** + * Get post status by post ID or content_id + * Accepts either WordPress post_id or IGNY8 content_id + */ +public function get_post_status($request) { + $id = intval($request['id']); + + // First try as WordPress post ID + $post = get_post($id); + + // If not found, try as IGNY8 content_id + if (!$post) { + $posts = get_posts(array( + 'meta_key' => '_igny8_content_id', + 'meta_value' => $id, + 'post_type' => 'any', + 'posts_per_page' => 1, + 'post_status' => 'any' + )); + $post = !empty($posts) ? $posts[0] : null; + } + + return rest_ensure_response(array( + 'success' => true, + 'data' => array( + 'post_id' => $post->ID, + 'post_status' => $post->post_status, // WordPress status + 'post_title' => $post->post_title, + 'post_modified' => $post->post_modified, + 'wordpress_status' => $post->post_status, + 'igny8_status' => igny8_map_wp_status_to_igny8($post->post_status), + // ... more fields + ) + )); +} +``` + +**Frontend Integration:** + +To display WP Status column on Published page, the frontend should: + +1. Call `GET /api/v1/writer/content/{id}/wordpress_status/` for each published content +2. Display `wordpress_status` field (e.g., "Published", "Draft", "Pending") +3. Optionally show `post_modified` to indicate last update time + +**Status Mapping:** + +| WordPress Status | IGNY8 Status | Display | +|-----------------|-------------|---------| +| `publish` | `completed` | Published | +| `draft` | `draft` | Draft | +| `pending` | `pending` | Pending Review | +| `private` | `completed` | Private | +| `trash` | `archived` | Trashed | +| `future` | `scheduled` | Scheduled | + +**Result:** IGNY8 app can now poll WordPress status and display it in the Published page table + +--- + +## Issue 3: Remove Custom Taxonomy/Attribute Columns + +### Problem +WordPress admin had custom "Taxonomy" and "Attribute" columns that referenced deprecated custom taxonomies instead of using native WordPress categories and tags. + +### Fix Applied + +**File:** `c:\Users\Hp\vscode\igny8-wp-integration\admin\class-admin-columns.php` + +**Removed:** +- `render_taxonomy_column()` method +- `render_attribute_column()` method +- Custom column registration for `igny8_taxonomy` and `igny8_attribute` + +**Before:** +```php +public function add_columns($columns) { + $new_columns = array(); + foreach ($columns as $key => $value) { + $new_columns[$key] = $value; + if ($key === 'title') { + $new_columns['igny8_taxonomy'] = __('Taxonomy', 'igny8-bridge'); + $new_columns['igny8_attribute'] = __('Attribute', 'igny8-bridge'); + } + } + return $new_columns; +} +``` + +**After:** +```php +public function add_columns($columns) { + // Removed custom taxonomy and attribute columns + // Posts now use native WordPress taxonomies (categories, tags, etc.) + return $columns; +} +``` + +**Result:** +- Posts, pages, and products now only show native WordPress taxonomy columns +- Categories, tags, product categories, etc. are displayed in standard WordPress columns +- Cleaner admin UI aligned with WordPress standards + +--- + +## Issue 4: Tags, Categories, Images, Keywords Not Saving + +### Problem +When publishing content from IGNY8 to WordPress: +- Tags were not being saved +- Categories were not being saved +- Featured and gallery images were not being attached +- Keywords (primary and secondary) were not being added as tags + +### Root Cause +The `publish_content_to_wordpress` Celery task was sending empty arrays: + +```python +# BEFORE (BROKEN): +content_data = { + 'title': content.title, + 'content_html': content.content_html, + # ... + 'featured_image_url': None, # ← Empty + 'sectors': [], # ← Empty + 'clusters': [], # ← Empty + 'tags': [] # ← Empty +} +``` + +### Fix Applied + +**File:** `e:\Projects\...\igny8\backend\igny8_core\tasks\wordpress_publishing.py` +**Function:** `publish_content_to_wordpress()` + +**Changes:** + +1. **Extract taxonomy terms from ContentTaxonomyMap:** +```python +from igny8_core.business.content.models import ContentTaxonomyMap +taxonomy_maps = ContentTaxonomyMap.objects.filter(content=content).select_related('taxonomy') + +categories = [] +tags = [] +for mapping in taxonomy_maps: + tax = mapping.taxonomy + if tax: + # Add taxonomy term name to categories + categories.append(tax.name) +``` + +2. **Extract images from Images model:** +```python +from igny8_core.modules.writer.models import Images +featured_image_url = None +gallery_images = [] + +images = Images.objects.filter(content=content).order_by('position') +for image in images: + if image.image_type == 'featured' and image.image_url: + featured_image_url = image.image_url + elif image.image_type == 'in_article' and image.image_url: + gallery_images.append({ + 'url': image.image_url, + 'alt': image.alt_text or '', + 'position': image.position + }) +``` + +3. **Add keywords as tags:** +```python +# Add primary and secondary keywords as tags +if content.primary_keyword: + tags.append(content.primary_keyword) + +if content.secondary_keywords: + if isinstance(content.secondary_keywords, list): + tags.extend(content.secondary_keywords) + elif isinstance(content.secondary_keywords, str): + import json + try: + keywords = json.loads(content.secondary_keywords) + if isinstance(keywords, list): + tags.extend(keywords) + except (json.JSONDecodeError, TypeError): + pass +``` + +4. **Send complete payload to WordPress:** +```python +content_data = { + 'content_id': content.id, + 'task_id': task_id, + 'title': content.title, + 'content_html': content.content_html or '', + # ... SEO fields ... + 'featured_image_url': featured_image_url, # ✅ Now populated + 'gallery_images': gallery_images, # ✅ Now populated + 'categories': categories, # ✅ Now populated from taxonomy mappings + 'tags': tags, # ✅ Now populated from keywords + # ... +} +``` + +### How WordPress Processes This Data + +**File:** `c:\Users\Hp\vscode\igny8-wp-integration\sync\igny8-to-wp.php` +**Function:** `igny8_create_wordpress_post_from_task()` + +1. **Categories:** +```php +// Handle categories +if (!empty($content_data['categories'])) { + $category_ids = igny8_process_categories($content_data['categories'], $post_id); + if (!empty($category_ids)) { + wp_set_post_terms($post_id, $category_ids, 'category'); + } +} +``` + +2. **Tags:** +```php +// Handle tags +if (!empty($content_data['tags'])) { + $tag_ids = igny8_process_tags($content_data['tags'], $post_id); + if (!empty($tag_ids)) { + wp_set_post_terms($post_id, $tag_ids, 'post_tag'); + } +} +``` + +3. **Featured Image:** +```php +if (!empty($content_data['featured_image_url'])) { + igny8_set_featured_image($post_id, $content_data['featured_image_url']); +} +``` + +4. **Gallery Images:** +```php +if (!empty($content_data['gallery_images'])) { + igny8_set_image_gallery($post_id, $content_data['gallery_images']); +} +``` + +5. **Keywords (stored as post meta):** +```php +if (!empty($content_data['primary_keyword'])) { + update_post_meta($post_id, '_igny8_primary_keyword', $content_data['primary_keyword']); +} + +if (!empty($content_data['secondary_keywords'])) { + update_post_meta($post_id, '_igny8_secondary_keywords', $content_data['secondary_keywords']); +} +``` + +**Result:** +- ✅ Categories created/assigned from taxonomy mappings +- ✅ Tags created/assigned from keywords (primary + secondary) +- ✅ Featured image downloaded and set as post thumbnail +- ✅ Gallery images downloaded and attached to post +- ✅ Keywords stored in post meta for SEO plugins + +--- + +## Data Flow (Complete) + +### Before Fixes ❌ +``` +IGNY8 Content Model + ├─ title ✓ + ├─ content_html ✓ + ├─ taxonomy_terms → NOT SENT ❌ + ├─ images → NOT SENT ❌ + ├─ keywords → NOT SENT ❌ + └─ status stays 'review' ❌ + ↓ +WordPress Post + ├─ Title + Content ✓ + ├─ No categories ❌ + ├─ No tags ❌ + ├─ No images ❌ + └─ IGNY8 status still 'review' ❌ +``` + +### After Fixes ✅ +``` +IGNY8 Content Model + ├─ title ✓ + ├─ content_html ✓ + ├─ ContentTaxonomyMap → categories[] ✓ + ├─ Images (featured + gallery) → image URLs ✓ + ├─ primary_keyword + secondary_keywords → tags[] ✓ + └─ status = 'published' immediately ✓ + ↓ +WordPress Post + ├─ Title + Content ✓ + ├─ Categories (from taxonomy terms) ✓ + ├─ Tags (from keywords) ✓ + ├─ Featured Image + Gallery ✓ + └─ IGNY8 can query WordPress status ✓ +``` + +--- + +## Testing Checklist + +### 1. Test Status Update +- [ ] Create content in IGNY8 with status 'review' +- [ ] Click "Publish" button +- [ ] ✅ Verify status changes to 'published' immediately (not waiting for background task) +- [ ] ✅ Verify content appears in WordPress with full content +- [ ] ✅ Check IGNY8 `external_id` and `external_url` populated after Celery task completes + +### 2. Test WordPress Status Endpoint +- [ ] Publish content from IGNY8 +- [ ] Call `GET /api/v1/writer/content/{id}/wordpress_status/` +- [ ] ✅ Verify response contains `wordpress_status: 'publish'` +- [ ] Change post status in WordPress to 'draft' +- [ ] Call endpoint again +- [ ] ✅ Verify response contains `wordpress_status: 'draft'` + +### 3. Test Custom Columns Removed +- [ ] Go to WordPress admin → Posts → All Posts +- [ ] ✅ Verify no "Taxonomy" or "Attribute" columns appear +- [ ] ✅ Verify only native WP columns (Title, Author, Categories, Tags, Date) are shown + +### 4. Test Tags, Categories, Images +- [ ] Create content in IGNY8 with: + - `primary_keyword`: "SEO Strategy" + - `secondary_keywords`: ["Digital Marketing", "Content Marketing"] + - ContentTaxonomyMap: link to taxonomy term "Marketing" + - Images: 1 featured image, 2 gallery images +- [ ] Publish to WordPress +- [ ] In WordPress admin, check the post: + - [ ] ✅ Categories: "Marketing" exists + - [ ] ✅ Tags: "SEO Strategy", "Digital Marketing", "Content Marketing" exist + - [ ] ✅ Featured image is set + - [ ] ✅ Gallery images attached to post + +--- + +## Files Modified + +### IGNY8 Backend +1. `e:\Projects\...\igny8\backend\igny8_core\tasks\wordpress_publishing.py` + - Added taxonomy term extraction + - Added image extraction from Images model + - Added keyword extraction as tags + - Populated categories, tags, images in payload + +2. `e:\Projects\...\igny8\backend\igny8_core\modules\writer\views.py` + - Updated `ContentViewSet.publish()` to set status='published' immediately (optimistic update) + - Added `ContentViewSet.wordpress_status()` endpoint + - Added error handling to revert status on failure + +### WordPress Plugin +1. `c:\Users\Hp\vscode\igny8-wp-integration\includes\class-igny8-rest-api.php` + - Updated `get_post_status()` to accept both WordPress post_id and IGNY8 content_id + - Enhanced response with more post metadata + +2. `c:\Users\Hp\vscode\igny8-wp-integration\admin\class-admin-columns.php` + - Removed `render_taxonomy_column()` and `render_attribute_column()` + - Removed custom taxonomy/attribute column registration + - Simplified to use only native WP columns + +--- + +## Breaking Changes + +**None** - All changes are backward compatible. The WordPress plugin will still accept old payload formats. + +--- + +## Frontend Integration Required + +### Published Page - Add WP Status Column + +The frontend Published page should: + +1. Add "WordPress Status" column to the table +2. For each row, call: `GET /api/v1/writer/content/{id}/wordpress_status/` +3. Display status with color coding: + - `publish` → Green badge "Published" + - `draft` → Gray badge "Draft" + - `pending` → Yellow badge "Pending" + - `trash` → Red badge "Trashed" + - `future` → Blue badge "Scheduled" + +4. Optional: Add refresh button to re-check WordPress status + +**Example:** +```javascript +async function fetchWordPressStatus(contentId) { + const response = await fetch(`/api/v1/writer/content/${contentId}/wordpress_status/`); + const data = await response.json(); + return data.data.wordpress_status; // 'publish', 'draft', etc. +} +``` + +--- + +## Summary + +**Status:** ✅ All 4 issues fixed and ready for testing + +**Impact:** +- Better UX: Users see immediate status changes +- Complete data sync: Tags, categories, images now sync to WordPress +- Cleaner admin: Removed confusing custom columns +- Monitoring: Can now check WordPress status from IGNY8 + +**Next Steps:** +1. Test all fixes in staging environment +2. Update frontend to use `wordpress_status` endpoint +3. Add WP Status column to Published page UI +4. Monitor Celery logs for any publishing errors + +--- + +**Generated:** November 30, 2025 +**Priority:** HIGH - Core publishing functionality +**Breaking Changes:** None diff --git a/igny8-wp-plugin/docs/FIXES-APPLIED-2025-12-01.md b/igny8-wp-plugin/docs/FIXES-APPLIED-2025-12-01.md new file mode 100644 index 00000000..37b1fbf3 --- /dev/null +++ b/igny8-wp-plugin/docs/FIXES-APPLIED-2025-12-01.md @@ -0,0 +1,301 @@ +# Fixes Applied - December 1, 2025 + +## Issues Fixed + +### 1. ✅ WordPress Debug Log Error (Duplicate Code) +**Location:** `c:\Users\Hp\vscode\igny8-wp-integration\sync\igny8-to-wp.php` + +**Problem:** Lines 278-287 contained duplicate code that was executed twice, causing PHP warnings in debug.log: +```php +error_log('========== IGNY8 POST CREATION COMPLETE: Post ID ' . $post_id . ' =========='); update_post_meta($post_id, '_igny8_meta_title', $content_data['meta_title']); +} + +if (!empty($content_data['meta_description'])) { + update_post_meta($post_id, '_yoast_wpseo_metadesc', $content_data['meta_description']); + // ... duplicate code ... +} +``` + +**Fix Applied:** +- Removed duplicate meta_title and meta_description update code (lines 278-287) +- Added gallery images handler before final status update +- Cleaned up log statement formatting + +**Result:** Clean debug.log output without PHP warnings or duplicate operations + +--- + +### 2. ✅ WP Status Column Missing on Published Page +**Location:** `e:\Projects\...\igny8\frontend\src\config\pages\published.config.tsx` + +**Problem:** Published page showed "Content Status" (IGNY8 internal status) but not "WP Status" (actual WordPress post status) + +**Fix Applied:** + +#### Frontend Configuration +**File:** `published.config.tsx` + +Added new column configuration: +```tsx +{ + key: 'wordpress_status', + label: 'WP Status', + sortable: false, + width: '120px', + render: (_value: any, row: Content) => { + // Check if content has been published to WordPress + if (!row.external_id) { + return ( +