Fix image upload structure for Miravia API compliance
🔧 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
parent
34fb289122
commit
28c2d4d1f0
@ -1,126 +1,65 @@
|
||||
# Miravia Feed API Connector
|
||||
|
||||
Official WordPress/WooCommerce plugin for Miravia marketplace integration using the native Feed API.
|
||||
WordPress/WooCommerce plugin for Miravia marketplace integration using the official Feed API.
|
||||
|
||||
## Overview
|
||||
## Features
|
||||
|
||||
This plugin provides seamless integration between WooCommerce and Miravia marketplace, allowing merchants to:
|
||||
- Upload products using Miravia's official Feed API
|
||||
- Manage product synchronization with job queue monitoring
|
||||
- Download and process orders from Miravia
|
||||
- Handle multiple Miravia accounts and profiles
|
||||
|
||||
## Key Features
|
||||
|
||||
### ✅ Feed API Integration
|
||||
- **Official API**: Uses Miravia's native Feed API (no third-party proxies)
|
||||
- **Asynchronous Processing**: Jobs are processed in background with real-time status monitoring
|
||||
- **Bulk Operations**: Submit multiple products simultaneously
|
||||
- **Error Handling**: Comprehensive error tracking and retry functionality
|
||||
|
||||
### ✅ Product Management
|
||||
- **Direct Upload**: Submit individual products or bulk selections
|
||||
- **Status Monitoring**: Real-time job status tracking in admin interface
|
||||
- **Auto-sync**: Automatic product updates when WooCommerce data changes
|
||||
- **Image Support**: Proper image handling for Miravia's requirements
|
||||
|
||||
### ✅ Order Management
|
||||
- **Order Import**: Download orders from Miravia to WooCommerce
|
||||
- **Status Sync**: Bidirectional order status synchronization
|
||||
- **Shipping Labels**: Generate and manage shipping labels
|
||||
- **Multi-account**: Support for multiple Miravia seller accounts
|
||||
- Upload products to Miravia using the official Feed API
|
||||
- Job queue system with real-time status monitoring
|
||||
- Bulk product submission with error handling
|
||||
- Order import from Miravia to WooCommerce
|
||||
- Multi-account support for multiple Miravia sellers
|
||||
|
||||
## Requirements
|
||||
|
||||
- **WordPress**: 5.0 or higher
|
||||
- **WooCommerce**: 3.0 or higher
|
||||
- **PHP**: 7.4 or higher
|
||||
- **Miravia Account**: Active seller account with API credentials
|
||||
- WordPress 5.0+
|
||||
- WooCommerce 3.0+
|
||||
- PHP 7.4+
|
||||
- Miravia seller account with API credentials
|
||||
|
||||
## Installation
|
||||
|
||||
1. Upload the plugin files to `/wp-content/plugins/miravia-feed-connector/`
|
||||
2. Activate the plugin through WordPress admin
|
||||
3. Go to **Miravia > Configuration** and enter your API credentials
|
||||
4. Enable "Use Feed API Only" option
|
||||
5. Test your API connection
|
||||
|
||||
## Configuration
|
||||
|
||||
### API Credentials
|
||||
|
||||
Navigate to **Miravia > Configuration** and provide:
|
||||
|
||||
- **App Key**: Your Miravia/AliExpress App Key
|
||||
- **Secret Key**: Your Miravia/AliExpress Secret Key
|
||||
- **Access Token**: Your personal seller access token
|
||||
|
||||
### Feed API Settings
|
||||
|
||||
Enable "Use Feed API Only" to use the official Miravia Feed API (recommended for all seller accounts).
|
||||
1. Upload plugin files to `/wp-content/plugins/miravia-feed-connector/`
|
||||
2. Activate plugin in WordPress admin
|
||||
3. Go to **Miravia > Configuration**
|
||||
4. Enter your API credentials:
|
||||
- App Key
|
||||
- Secret Key
|
||||
- Access Token
|
||||
5. Enable "Use Feed API Only"
|
||||
6. Test your connection
|
||||
|
||||
## Usage
|
||||
|
||||
### Product Upload
|
||||
|
||||
### Upload Products
|
||||
1. Go to **Miravia > Products**
|
||||
2. Select products using checkboxes
|
||||
3. Click "Submit Selected to Feed API"
|
||||
4. Monitor progress in **Miravia > Jobs**
|
||||
|
||||
### Job Monitoring
|
||||
### Monitor Jobs
|
||||
- View job status in **Miravia > Jobs**
|
||||
- Filter by status (Pending, Processing, Completed, Failed)
|
||||
- Resubmit failed jobs
|
||||
- View error details
|
||||
|
||||
The Jobs Queue provides:
|
||||
- Real-time status updates
|
||||
- Filtering by status (Pending, Processing, Completed, Failed)
|
||||
- Error details and retry functionality
|
||||
- Processing time tracking
|
||||
## Configuration
|
||||
|
||||
### Order Management
|
||||
|
||||
Orders are automatically downloaded from Miravia and created as WooCommerce orders with proper status mapping.
|
||||
|
||||
## Development
|
||||
|
||||
### Architecture
|
||||
|
||||
- **Feed Manager**: Core job handling (`MiraviaFeedManager`)
|
||||
- **SDK Integration**: Direct API client (`MiraviaSdk`, `SimpleIopClient`)
|
||||
- **Database**: Custom tables for jobs and sync data
|
||||
- **AJAX Interface**: WordPress-native AJAX endpoints
|
||||
|
||||
### Database Tables
|
||||
|
||||
- `wp_miravia_feed_jobs`: Feed API job tracking
|
||||
- `wp_miravia_accounts`: Seller account credentials
|
||||
- `wp_miravia_profiles`: Product upload profiles
|
||||
- `wp_miravia_products`: Product sync status
|
||||
Navigate to **Miravia > Configuration** to set up:
|
||||
- API credentials
|
||||
- Default product settings
|
||||
- Order import options
|
||||
- Debug mode
|
||||
|
||||
## Support
|
||||
|
||||
For issues, feature requests, or development questions:
|
||||
- Repository: https://devops.cloudhost.es/CloudHost/MiraviaConnector
|
||||
- Developer: CloudHost.es
|
||||
|
||||
- **Repository**: https://github.com/CloudHost/miravia-woocommerce-connector
|
||||
- **Issues**: https://github.com/CloudHost/miravia-woocommerce-connector/issues
|
||||
- **Developer**: CloudHost Solutions
|
||||
## Version History
|
||||
|
||||
## Changelog
|
||||
|
||||
### Version 2.0.0
|
||||
- Complete rebuild using official Feed API
|
||||
- Removed WeComm proxy dependencies
|
||||
- Added job queue system with real-time monitoring
|
||||
- Enhanced error handling and retry functionality
|
||||
- Updated branding to CloudHost Solutions
|
||||
- Improved WordPress admin integration
|
||||
|
||||
### Version 1.x
|
||||
- Legacy WeComm proxy integration (deprecated)
|
||||
|
||||
## License
|
||||
|
||||
GPL v3 or later. See [LICENSE](https://www.gnu.org/licenses/gpl-3.0.html) for details.
|
||||
**2.0.0** - Complete rebuild with official Feed API
|
||||
**1.x** - Legacy version (deprecated)
|
||||
|
||||
---
|
||||
|
||||
**CloudHost Solutions** | https://cloudhost.es
|
||||
CloudHost.es | https://cloudhost.es
|
||||
@ -3,9 +3,9 @@
|
||||
* Plugin Name: Miravia Feed API Connector
|
||||
* Description: Official Miravia marketplace integration using Feed API - Upload products and manage orders
|
||||
* Version: 2.0.0
|
||||
* Author: CloudHost Solutions
|
||||
* Author: CloudHost.es
|
||||
* Author URI: https://cloudhost.es
|
||||
* Plugin URI: https://github.com/CloudHost/miravia-woocommerce-connector
|
||||
* Plugin URI: https://devops.cloudhost.es/CloudHost/MiraviaConnector
|
||||
* Text Domain: miraviawoo
|
||||
* WC requires at least: 3.0
|
||||
* WC tested up to: 8.0
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user