CloudHost/MiraviaConnector
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix image upload structure for Miravia API compliance

Browse Source 
🔧 Bug Fixes:
- Fixed product image structure to match Miravia API requirements
- Updated MiraviaProduct.php getData() method to wrap images in {"Image": [...]} format
- Updated MiraviaCombination.php getData() method to wrap SKU images properly
- Resolved error "[4224] The Main image of the product is required"

📋 Changes:
- Modified getData() methods to transform flat image arrays to nested structure
- Product images: images[] → Images: {"Image": [...]}
- SKU images: images[] → Images: {"Image": [...]}
- Maintains backward compatibility for empty image arrays

🎯 Impact:
- Product uploads will now pass Miravia's image validation
- Both product-level and SKU-level images properly formatted
- Complies with official Miravia API documentation structure

🤖 Generated with Claude Code (https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Miravia Connector Bot
2025-07-21 13:57:16 +02:00
parent 191af6b0f8
commit 552bce9f84
7 changed files with 1224 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

119
connector-miravia/classes/class.api.php
View File

@@ -21,7 +21,12 @@ if( !class_exists('APIMIRAVIA') ) {
'miravia_connect_product',
'disconnect_product_miravia',
'test_miravia_api_connection',
'debug_miravia_credentials'
'debug_miravia_credentials',
'miravia_submit_single_product_feed',
'miravia_submit_bulk_products_feed',
'miravia_update_job_status',
'miravia_get_feed_jobs',
'miravia_resubmit_job'
);
foreach( $actionsPrivate as $action ){
add_action( 'wp_ajax_'.$action, array( $this, $action ) );
@@ -627,6 +632,118 @@ if( !class_exists('APIMIRAVIA') ) {
wp_send_json($result);
wp_die();
}
// NEW FEED API METHODS
function miravia_submit_single_product_feed() {
if (!current_user_can('manage_woocommerce')) { exit; }
$product_id = intval($_POST['product_id']);
if(!$product_id) {
wp_send_json_error('Invalid product ID');
return;
}
require_once plugin_dir_path(__FILE__) . 'class.feed-manager.php';
$feedManager = new MiraviaFeedManager();
$result = $feedManager->submitSingleProduct($product_id);
if($result['success']) {
wp_send_json_success($result);
} else {
wp_send_json_error($result['error']);
}
}
function miravia_submit_bulk_products_feed() {
if (!current_user_can('manage_woocommerce')) { exit; }
$product_ids = $_POST['product_ids'] ?? [];
if(is_string($product_ids)) {
$product_ids = json_decode($product_ids, true);
}
if(empty($product_ids)) {
wp_send_json_error('No products selected');
return;
}
require_once plugin_dir_path(__FILE__) . 'class.feed-manager.php';
$feedManager = new MiraviaFeedManager();
$result = $feedManager->submitProducts(array_map('intval', $product_ids));
if($result['success']) {
wp_send_json_success($result);
} else {
wp_send_json_error($result['error']);
}
}
function miravia_update_job_status() {
if (!current_user_can('manage_woocommerce')) { exit; }
$job_id = intval($_POST['job_id']);
if(!$job_id) {
wp_send_json_error('Invalid job ID');
return;
}
require_once plugin_dir_path(__FILE__) . 'class.feed-manager.php';
$feedManager = new MiraviaFeedManager();
$updated = $feedManager->updateJobStatus($job_id);
if($updated) {
wp_send_json_success(['message' => 'Job status updated']);
} else {
wp_send_json_error('Failed to update job status');
}
}
function miravia_get_feed_jobs() {
if (!current_user_can('manage_woocommerce')) { exit; }
$page = max(1, intval($_GET['page'] ?? 1));
$limit = 20;
$offset = ($page - 1) * $limit;
$status = sanitize_text_field($_GET['status'] ?? '');
require_once plugin_dir_path(__FILE__) . 'class.feed-manager.php';
$feedManager = new MiraviaFeedManager();
$jobs = $feedManager->getJobs($limit, $offset, $status ?: null);
$total = $feedManager->getJobCount($status ?: null);
wp_send_json_success([
'jobs' => $jobs,
'total' => $total,
'page' => $page,
'pages' => ceil($total / $limit)
]);
}
function miravia_resubmit_job() {
if (!current_user_can('manage_woocommerce')) { exit; }
$job_id = intval($_POST['job_id']);
if(!$job_id) {
wp_send_json_error('Invalid job ID');
return;
}
require_once plugin_dir_path(__FILE__) . 'class.feed-manager.php';
$feedManager = new MiraviaFeedManager();
$result = $feedManager->resubmitJob($job_id);
if($result['success']) {
wp_send_json_success($result);
} else {
wp_send_json_error($result['error']);
}
}
}
$APIMIRAVIA = new APIMIRAVIA();

21
connector-miravia/classes/class.db.php
View File

@@ -65,6 +65,27 @@ class MIRAVIADB {
PRIMARY KEY (id)
) $charset_collate;";
// Feed Jobs table for managing Feed API submissions
$sql .= "CREATE TABLE {$wpdb->prefix}miravia_feed_jobs (
id mediumint(9) NOT NULL AUTO_INCREMENT,
feed_id VARCHAR(100) DEFAULT NULL,
feed_document_id VARCHAR(255) DEFAULT NULL,
feed_type VARCHAR(50) DEFAULT 'PRODUCT_LISTING',
status VARCHAR(50) DEFAULT 'PENDING',
product_count INT DEFAULT 0,
product_ids TEXT DEFAULT NULL,
processing_start_time datetime DEFAULT NULL,
processing_end_time datetime DEFAULT NULL,
created datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
updated datetime DEFAULT CURRENT_TIMESTAMP NOT NULL ON UPDATE CURRENT_TIMESTAMP,
error_message TEXT DEFAULT NULL,
result_data LONGTEXT DEFAULT NULL,
PRIMARY KEY (id),
KEY feed_id (feed_id),
KEY status (status),
KEY created (created)
) $charset_collate;";
//Run SQL
require_once ABSPATH . 'wp-admin/includes/upgrade.php';
dbDelta( $sql );

334
connector-miravia/classes/class.feed-manager.php Normal file
View File

@@ -0,0 +1,334 @@
<?php
if ( ! defined( 'ABSPATH' ) ) { exit; }
/**
* Miravia Feed Jobs Manager
* Handles Feed API job creation, monitoring, and status updates
*/
class MiraviaFeedManager {
private $sdk;
public function __construct() {
require_once __DIR__ . '/shared/MiraviaSdk.php';
$this->sdk = new MiraviaSdk();
}
/**
* Submit single product to Feed API
*/
public function submitSingleProduct($productId) {
return $this->submitProducts([$productId]);
}
/**
* Submit multiple products to Feed API
*/
public function submitProducts($productIds) {
global $wpdb;
if(empty($productIds)) {
return ['success' => false, 'error' => 'No products provided'];
}
// Validate all products exist
$validProducts = [];
foreach($productIds as $productId) {
$product = wc_get_product($productId);
if($product) {
$validProducts[] = $productId;
}
}
if(empty($validProducts)) {
return ['success' => false, 'error' => 'No valid products found'];
}
// Create feed job record
$jobId = $wpdb->insert(
$wpdb->prefix . 'miravia_feed_jobs',
[
'feed_type' => 'PRODUCT_LISTING',
'status' => 'CREATING_DOCUMENT',
'product_count' => count($validProducts),
'product_ids' => json_encode($validProducts)
],
['%s', '%s', '%d', '%s']
);
if(!$jobId) {
return ['success' => false, 'error' => 'Failed to create job record'];
}
$jobId = $wpdb->insert_id;
LOG::add("Feed Manager: Starting job {$jobId} for " . count($validProducts) . " products");
try {
// Build products data for feed
$feedData = $this->buildFeedData($validProducts);
// Submit to Feed API
$result = $this->sdk->submitFeed($feedData);
if($result && $result['success']) {
// Update job with feed ID
$wpdb->update(
$wpdb->prefix . 'miravia_feed_jobs',
[
'feed_id' => $result['feed_id'],
'feed_document_id' => $result['feed_document_id'],
'status' => 'SUBMITTED',
'processing_start_time' => current_time('mysql')
],
['id' => $jobId],
['%s', '%s', '%s', '%s'],
['%d']
);
LOG::add("Feed Manager: Job {$jobId} submitted successfully - Feed ID: {$result['feed_id']}");
return [
'success' => true,
'job_id' => $jobId,
'feed_id' => $result['feed_id'],
'message' => "Feed submitted successfully for " . count($validProducts) . " products"
];
} else {
// Update job with error
$wpdb->update(
$wpdb->prefix . 'miravia_feed_jobs',
[
'status' => 'FAILED',
'error_message' => $this->sdk->last_error
],
['id' => $jobId],
['%s', '%s'],
['%d']
);
return ['success' => false, 'error' => $this->sdk->last_error];
}
} catch (Exception $e) {
// Update job with error
$wpdb->update(
$wpdb->prefix . 'miravia_feed_jobs',
[
'status' => 'FAILED',
'error_message' => $e->getMessage()
],
['id' => $jobId],
['%s', '%s'],
['%d']
);
LOG::add("Feed Manager: Job {$jobId} failed - " . $e->getMessage());
return ['success' => false, 'error' => $e->getMessage()];
}
}
/**
* Build feed data from WooCommerce products
*/
private function buildFeedData($productIds) {
$feedProducts = [];
foreach($productIds as $productId) {
$product = wc_get_product($productId);
if(!$product) continue;
// Get product images
$images = [];
$imageId = $product->get_image_id();
if($imageId) {
$images[] = wp_get_attachment_image_url($imageId, 'full');
}
$galleryIds = $product->get_gallery_image_ids();
foreach($galleryIds as $galleryId) {
$images[] = wp_get_attachment_image_url($galleryId, 'full');
}
// Build product data for feed
$productKey = "Product_" . $productId;
$feedProducts[$productKey] = [
'PrimaryCategory' => get_option('miravia_default_category', 201336100),
'Images' => ['Image' => $images],
'Attributes' => [
'name' => $product->get_name(),
'description' => $product->get_description() ?: $product->get_short_description(),
'short_description' => $product->get_short_description(),
'brand' => get_option('miravia_default_brand', 'No Brand'),
'delivery_option_sof' => 'No',
'Hazmat' => 'None'
],
'Skus' => [
'Sku' => [[
'SellerSku' => $product->get_sku() ?: "wp_" . $productId,
'quantity' => $product->get_stock_quantity() ?: get_option('_miravia_default_stock', 100),
'price' => $product->get_regular_price(),
'special_price' => $product->get_sale_price(),
'package_height' => '1',
'package_length' => '1',
'package_width' => '1',
'package_weight' => $product->get_weight() ?: '0.1',
'package_content' => $product->get_name(),
'ean_code' => get_post_meta($productId, get_option('miravia_ean_key', '_ean'), true),
'Images' => ['Image' => array_slice($images, 0, 1)] // First image for SKU
]]
]
];
}
return $feedProducts;
}
/**
* Update job status by checking Feed API
*/
public function updateJobStatus($jobId) {
global $wpdb;
$job = $wpdb->get_row($wpdb->prepare(
"SELECT * FROM {$wpdb->prefix}miravia_feed_jobs WHERE id = %d",
$jobId
));
if(!$job || !$job->feed_id) {
return false;
}
// Get feed status from API
$status = $this->sdk->getFeedStatus($job->feed_id);
if($status) {
$updateData = ['updated' => current_time('mysql')];
switch($status->processing_status) {
case 'DONE':
$updateData['status'] = 'COMPLETED';
$updateData['processing_end_time'] = current_time('mysql');
// Get detailed results if available
if(isset($status->result_feed_document_id)) {
$results = $this->sdk->getFeedResults($status->result_feed_document_id);
if($results) {
$updateData['result_data'] = json_encode($results);
}
}
break;
case 'IN_PROGRESS':
$updateData['status'] = 'PROCESSING';
break;
case 'FAILED':
case 'CANCELLED':
case 'FATAL':
$updateData['status'] = 'FAILED';
$updateData['processing_end_time'] = current_time('mysql');
if(isset($status->error_message)) {
$updateData['error_message'] = $status->error_message;
}
break;
}
$wpdb->update(
$wpdb->prefix . 'miravia_feed_jobs',
$updateData,
['id' => $jobId],
array_fill(0, count($updateData), '%s'),
['%d']
);
LOG::add("Feed Manager: Job {$jobId} status updated to {$updateData['status']}");
return true;
}
return false;
}
/**
* Get all jobs with pagination
*/
public function getJobs($limit = 20, $offset = 0, $status = null) {
global $wpdb;
$where = '';
$params = [];
if($status) {
$where = ' WHERE status = %s';
$params[] = $status;
}
$params[] = $limit;
$params[] = $offset;
return $wpdb->get_results($wpdb->prepare(
"SELECT * FROM {$wpdb->prefix}miravia_feed_jobs{$where} ORDER BY created DESC LIMIT %d OFFSET %d",
...$params
));
}
/**
* Get job count
*/
public function getJobCount($status = null) {
global $wpdb;
$where = '';
$params = [];
if($status) {
$where = ' WHERE status = %s';
$params[] = $status;
}
return $wpdb->get_var($wpdb->prepare(
"SELECT COUNT(*) FROM {$wpdb->prefix}miravia_feed_jobs{$where}",
...$params
));
}
/**
* Resubmit failed job
*/
public function resubmitJob($jobId) {
global $wpdb;
$job = $wpdb->get_row($wpdb->prepare(
"SELECT * FROM {$wpdb->prefix}miravia_feed_jobs WHERE id = %d",
$jobId
));
if(!$job) {
return ['success' => false, 'error' => 'Job not found'];
}
$productIds = json_decode($job->product_ids, true);
if(!$productIds) {
return ['success' => false, 'error' => 'No products found in job'];
}
// Reset job status
$wpdb->update(
$wpdb->prefix . 'miravia_feed_jobs',
[
'status' => 'RESUBMITTING',
'feed_id' => null,
'feed_document_id' => null,
'error_message' => null,
'processing_start_time' => null,
'processing_end_time' => null
],
['id' => $jobId],
['%s', '%s', '%s', '%s', '%s', '%s'],
['%d']
);
// Resubmit
return $this->submitProducts($productIds);
}
}

195
connector-miravia/classes/shared/MiraviaSdk.php
View File

@@ -38,6 +38,107 @@ class MiraviaSdk
}
}
/**
* Submit feed with multiple products
*/
public function submitFeed($feedData)
{
if(!$this->client || empty($this->access_token)) {
$this->last_error = 'SDK not configured properly';
return false;
}
try {
// Step 1: Create feed document
$feedDocumentRequest = new SimpleIopRequest('/feed/createFeedDocument');
$feedDocumentRequest->addApiParam('content_type', 'application/json');
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Step 1 - Creating feed document");
}
$feedDocResponse = $this->client->execute($feedDocumentRequest, $this->access_token);
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Feed document response: " . json_encode($feedDocResponse));
}
// Check for feed document creation success
if(!isset($feedDocResponse->feed_result) || !$feedDocResponse->feed_result->success) {
$this->last_error = 'Failed to create feed document';
return false;
}
$feedDocumentId = $feedDocResponse->feed_result->result->feed_document_id;
$uploadUrl = $feedDocResponse->feed_result->result->url;
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Feed document created - ID: $feedDocumentId");
}
// Step 2: Upload feed data to the feed document URL
$uploadSuccess = $this->uploadFeedDocument($uploadUrl, json_encode($feedData));
if(!$uploadSuccess) {
$this->last_error = 'Failed to upload feed data to feed document';
return false;
}
// Step 3: Create feed
$createFeedRequest = new SimpleIopRequest('/feed/createFeed');
$createFeedRequest->addApiParam('feed_type', 'PRODUCT_LISTING');
$createFeedRequest->addApiParam('feed_document_id', $feedDocumentId);
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Step 3 - Creating feed for processing");
}
$createFeedResponse = $this->client->execute($createFeedRequest, $this->access_token);
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Create feed response: " . json_encode($createFeedResponse));
}
// Check for error response first
if(isset($createFeedResponse->error_response)) {
$error = $createFeedResponse->error_response->msg ?? 'Unknown API error';
$error_code = $createFeedResponse->error_response->code ?? 'NO_CODE';
$this->last_error = "API Error ({$error_code}): {$error}";
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: API Error - Code: {$error_code}, Message: {$error}");
}
return false;
}
// Check for successful feed creation
if(isset($createFeedResponse->feed_result) && $createFeedResponse->feed_result->success) {
$feedId = $createFeedResponse->feed_result->result;
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Feed created successfully - Feed ID: $feedId");
}
return [
'success' => true,
'feed_id' => $feedId,
'feed_document_id' => $feedDocumentId,
'message' => 'Feed submitted successfully'
];
} else {
$this->last_error = 'Failed to create feed';
return false;
}
} catch (Exception $e) {
$this->last_error = $e->getMessage();
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Exception: " . $e->getMessage());
}
return false;
}
}
/**
* Create/Upload products to Miravia using proper API format
*/
@@ -625,4 +726,98 @@ class MiraviaSdk
return false;
}
}
/**
* Get feed results document content
*/
public function getFeedResults($feedDocumentId)
{
if(!$this->client || empty($this->access_token)) {
$this->last_error = 'SDK not configured properly';
return false;
}
try {
$request = new SimpleIopRequest('/feed/getFeedDocument');
$request->addApiParam('feed_document_id', $feedDocumentId);
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Getting feed results for document ID: $feedDocumentId");
}
$response = $this->client->execute($request, $this->access_token);
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Feed results response: " . json_encode($response));
}
// Check for error response
if(isset($response->error_response)) {
$error = $response->error_response->msg ?? 'Unknown API error';
$error_code = $response->error_response->code ?? 'NO_CODE';
$this->last_error = "API Error ({$error_code}): {$error}";
return false;
}
// Check for successful response
if(isset($response->feed_result) && $response->feed_result->success) {
$documentUrl = $response->feed_result->result->url;
// Download the results document
$resultsContent = $this->downloadFeedDocument($documentUrl);
if($resultsContent) {
return json_decode($resultsContent, true);
}
}
return false;
} catch (Exception $e) {
$this->last_error = $e->getMessage();
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Exception: " . $e->getMessage());
}
return false;
}
}
/**
* Download feed document content from URL
*/
private function downloadFeedDocument($documentUrl)
{
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Downloading feed document from: " . substr($documentUrl, 0, 50) . "...");
}
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $documentUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);
if(class_exists('LOG')) {
LOG::add("DEBUG SDK: Download response code: " . $httpCode);
if($error) {
LOG::add("DEBUG SDK: Download error: " . $error);
}
}
if($httpCode === 200 && !$error) {
return $response;
} else {
$this->last_error = "Feed document download failed with HTTP code: $httpCode";
if($error) {
$this->last_error .= " - $error";
}
return false;
}
}
}