Yaay365 Sync - WooCommerce Product Synchronization Plugin

A WordPress plugin to sync WooCommerce products to the Yaay365 catalogue system via REST API using your Yaay365 API keys (Public Key and Secret Key).

Features

• ✅ Automatic Sync - Products sync automatically when saved/updated
• ✅ Bulk Sync - Sync all products with one click
• ✅ Scheduled Sync - Hourly automatic synchronization
• ✅ Connection Testing - Test API connection before syncing
• ✅ Comprehensive Logging - Monitor all sync activities
• ✅ Error Handling - Detailed error messages and recovery
• ✅ Category Mapping - Automatic category creation and mapping
• ✅ Image Support - Sync product images and gallery
• ✅ Stock Management - Keep stock levels in sync
• ✅ Price Sync - Regular and sale prices

Requirements

• WordPress 5.8+
• WooCommerce 5.0+
• PHP 7.4+
• Valid Yaay365 API key pair (Public Key and Secret Key)

Installation

1. Upload the plugin folder to /wp-content/plugins/yaay365-sync/
2. Activate the plugin through the WordPress 'Plugins' menu
3. Navigate to Yaay365 Sync > Settings
4. Enter your Public Key and Secret Key (generate these in your Yaay365 dashboard under API Keys)
5. Test the connection
6. Start syncing!

Configuration

API Settings

Navigate to Yaay365 Sync > Settings and configure:

• Public Key: Your Yaay365 API public key (X-Public-Key)
• Secret Key: Your Yaay365 API secret key (X-Secret-Key) — shown only once when generated in your Yaay365 dashboard

Sync Options

• Sync on Save: Automatically sync products when created/updated
• Auto Sync (Cron): Enable hourly automatic synchronization
• Logging: Enable/disable activity logging

Usage

Manual Sync

1. Go to Yaay365 Sync dashboard
2. Click Sync All Products Now
3. Wait for the sync to complete
4. Review results and check logs if needed

Automatic Sync

Enable "Sync on Save" in settings. Products will automatically sync when:

• A new product is created
• An existing product is updated
• Product status changes to "published"

Scheduled Sync

Enable "Auto Sync" in settings to run hourly synchronization automatically via WordPress cron.

View Logs

Navigate to Yaay365 Sync > Logs to:

• View recent sync activities
• Monitor errors and warnings
• Clear old logs

API Format

The plugin sends requests to POST /v1/partner/catalogues/sync with authentication via HTTP headers. The company is resolved automatically from the API key — no company_id is needed in the body.

Request headers:

Content-Type: application/json
Accept: application/json
X-Public-Key: your-public-key
X-Secret-Key: your-secret-key

Request body:

{
  "products": [
    {
      "name": "Product Name",
      "sku": "PROD-001",
      "description": "Product description",
      "regular_price": "99.99",
      "sale_price": "79.99",
      "stock_quantity": 100,
      "status": "publish",
      "featured": true,
      "images": [
        {"src": "https://example.com/image.jpg"}
      ],
      "categories": [
        {"name": "Category Name"}
      ],
      "currency": "USD"
    }
  ]
}

Expected API Response

Your API should return:

{
  "success": true,
  "synced": 10,
  "created": 5,
  "updated": 5,
  "failed": 0,
  "errors": []
}

Troubleshooting

Connection Test Fails

• API URL must be https://api.yaay365.com and endpoint /v1/partner/catalogues/sync
• Double-check your Public Key and Secret Key — the secret is shown only once when generated
• If you lost the secret key, generate a new key pair in your Yaay365 dashboard
• Check the server can make outbound HTTPS requests to api.yaay365.com

Products Not Syncing

• Ensure "Sync on Save" is enabled
• Check product status is "published"
• Review logs for error messages
• Test API connection

Cron Not Running

• Verify "Auto Sync" is enabled
• Check WordPress cron is working: wp cron event list
• Manually trigger: wp cron event run yaay365_sync_cron

Development

File Structure

yaay365-sync/
├── assets/
│   ├── css/
│   │   └── admin.css
│   └── js/
│       └── admin.js
├── includes/
│   ├── Admin.php
│   ├── ApiClient.php
│   ├── Logger.php
│   ├── Plugin.php
│   └── ProductSync.php
├── templates/
│   ├── admin-logs.php
│   ├── admin-main.php
│   └── admin-settings.php
├── yaay365-sync.php
├── readme.txt
└── README.md

Hooks & Filters

Actions:

• yaay365_sync_before_sync - Before syncing products
• yaay365_sync_after_sync - After syncing products
• yaay365_sync_product_formatted - After formatting a product

Filters:

• yaay365_sync_product_data - Modify product data before sending
• yaay365_sync_api_headers - Modify API request headers
• yaay365_sync_api_timeout - Change API timeout (default: 60s)

Extending

// Modify product data before sync
add_filter('yaay365_sync_product_data', function($product_data, $wc_product) {
    // Add custom fields
    $product_data['custom_field'] = get_post_meta($wc_product->get_id(), 'custom_field', true);
    return $product_data;
}, 10, 2);

License

GPL v2 or later

Support

For support and documentation, visit: https://yaay365.com/support

Changelog

2.0.5 (2026-05-18)

• Overhauled settings menu: completely hid the "API URL" and "Sync Endpoint" configuration fields and hardcoded them directly to point securely to the production environment
• Premium Redesign: introduced a stunning, custom-branded top navigation header containing the official company logo across all plugin subpages
• Favicon Branding: overhauled styles to map primary tokens (borders, glows, buttons, inputs) to the company's official crimson red brand color (#e31e24)
• Stats Grid Alignment: optimized the merchant dashboard stats panel to align all 5 statistics panels cleanly in a single row on desktop screens
• Deal Selection & Sync integration: added a dropdown in the settings panel allowing merchants to choose and link their active Deal, automatically sending it to the backend on sync
• Robust Sync Fallback: resolved the "Field 'deal_id' doesn't have a default value" DB constraint by validating and resolving deal_id on the API controller, automatically falling back to active deals or dynamically generating a default approved sync deal on the fly
• Logs Stability: fixed a fatal PHP error on the log panel caused by calling a non-existent method, wrapping logs inside a sleek dark developer terminal
• Declarative HPOS Compatibility: added explicit declaration support for High-Performance Order Storage (HPOS) to eliminate WooCommerce admin warning flags
• Upgraded System Requirements: modernized compatibility requirements to support PHP 8.3, WordPress 6.0+, and WooCommerce 9.0+

1.0.5

• Replaced email/password/company ID authentication with API key authentication (Public Key + Secret Key)
• Authentication now uses X-Public-Key and X-Secret-Key request headers
• Company resolved automatically server-side — no company_id needed
• Switched sync endpoint to /v1/partner/catalogues/sync
• Default API URL updated to https://api.yaay365.com
• Added automatic migration of existing installs to new endpoint and auth method
• Improved connection test error reporting

1.0.0

• Initial release
• Core sync functionality
• Admin interface
• Logging system
• Cron support