Actions Reference

add_action('squarewoosync_before_order_import', function($orderId, $data, $parent_process_id) {
    // Perform pre-import actions
    error_log("Starting import of Square order: {$orderId}");
}, 10, 3);

add_action('squarewoosync_square_order_created', function($square_order_id, $wc_order_id) {
    error_log("Order {$wc_order_id} synced to Square: {$square_order_id}");
}, 10, 2);

add_action('squarewoosync_square_order_imported', function($square_order_id, $wc_order_id) {
    // Post-import processing
    $order = wc_get_order($wc_order_id);
    $order->add_order_note('Imported from Square: ' . $square_order_id);
}, 10, 2);

add_action('sws_order_import_completed', function($progress) {
    $imported = $progress['imported'] ?? 0;
    $failed = $progress['failed'] ?? 0;
    error_log("Order import completed: {$imported} imported, {$failed} failed");
});

add_action('squarewoosync_product_created', function($product_id, $product, $wc_product_data, $data_to_import) {
    if (!empty($wc_product_data['is_new_product'])) {
        update_post_meta($product_id, '_first_imported_at', time());
    }
}, 10, 4);

add_action('squarewoosync_product_categories_assigned', function($product, $category_ids, $wc_product_data) {
    foreach ($category_ids as $term_id) {
        $term = get_term($term_id, 'product_cat');
        if ($term && $term->slug === 'events') {
            // e.g. mark event products as virtual
            $product->set_virtual(true);
            $product->save();
        }
    }
}, 10, 3);

// Sync all fields for a product
do_action('squarewoosync_sync_product_to_square', $product_id);
 
// Sync only specific fields
do_action('squarewoosync_sync_product_to_square', $product_id, [
    'stock' => true,
    'price' => true,
]);
 
// Example: Sync inventory after external update
add_action('my_inventory_updated', function($product_id) {
    do_action('squarewoosync_sync_product_to_square', $product_id, [
        'stock' => true,
    ]);
});
 
// Example: Bulk sync prices for a category
$products = wc_get_products(['category' => 'sale-items']);
foreach ($products as $product) {
    do_action('squarewoosync_sync_product_to_square', $product->get_id(), [
        'price' => true,
    ]);
}

add_action('squarewoosync_payment_completed', function($order_id, $payment_id, $payment_data) {
    // Access full payment data
    $amount = $payment_data['amount_money']['amount'] ?? 0;
 
    // Send custom notification
    wp_mail(
        '[email protected]',
        'New Square Payment',
        "Order #{$order_id} paid via Square: {$payment_id} - Amount: {$amount}"
    );
}, 10, 3);

// Run early (before other plugins)
add_action('squarewoosync_square_order_created', 'my_function', 5, 2);
 
// Run at default priority
add_action('squarewoosync_square_order_created', 'my_function', 10, 2);
 
// Run late (after other plugins)
add_action('squarewoosync_square_order_created', 'my_function', 99, 2);

add_action('squarewoosync_product_created', function($product_id, $product, $wc_product_data, $data_to_import) {
    try {
        // Your custom logic
        do_something_with_product($product_id);
    } catch (Exception $e) {
        error_log('SquareSync action error: ' . $e->getMessage());
        // Don't re-throw - let the sync continue
    }
}, 10, 4);

// Bad: Expensive operation during payment
add_action('squarewoosync_payment_completed', function($order_id, $payment_id, $payment_data) {
    $all_orders = get_posts(['post_type' => 'shop_order', 'numberposts' => -1]); // Slow!
}, 10, 3);
 
// Good: Defer expensive operations
add_action('squarewoosync_payment_completed', function($order_id, $payment_id, $payment_data) {
    // Schedule for later processing
    wp_schedule_single_event(time() + 60, 'my_deferred_processing', [$order_id]);
}, 10, 3);

add_action('squarewoosync_square_order_created', function($square_order_id, $wc_order_id) {
    if (defined('WP_DEBUG') && WP_DEBUG) {
        error_log(sprintf(
            '[SquareSync] Order %d synced to Square as %s',
            $wc_order_id,
            $square_order_id
        ));
    }
}, 10, 2);

add_action('squarewoosync_square_order_imported', function($square_order_id, $wc_order_id) {
    $order = wc_get_order($wc_order_id);
    $total = $order->get_total();
 
    wp_remote_post('https://hooks.slack.com/services/YOUR/WEBHOOK/URL', [
        'body' => json_encode([
            'text' => "New Square order imported: #{$wc_order_id} - \${$total}"
        ]),
        'headers' => ['Content-Type' => 'application/json']
    ]);
}, 10, 2);

add_action('squarewoosync_payment_completed', function($order_id, $payment_id, $payment_data) {
    $order = wc_get_order($order_id);
 
    // Send to CRM
    wp_remote_post('https://api.crm.example.com/orders', [
        'body' => json_encode([
            'order_id' => $order_id,
            'email' => $order->get_billing_email(),
            'total' => $order->get_total(),
            'payment_id' => $payment_id
        ]),
        'headers' => [
            'Content-Type' => 'application/json',
            'Authorization' => 'Bearer ' . CRM_API_KEY
        ]
    ]);
}, 10, 3);

add_action('squarewoosync_product_created', function($product_id, $product, $wc_product_data, $data_to_import) {
    // Add an extra WooCommerce category based on the Square categories
    $square_category_names = array_map(fn($c) => $c['name'] ?? '', $wc_product_data['categories'] ?? []);
 
    if (in_array('Specials', $square_category_names, true)) {
        wp_set_object_terms($product_id, 'special-items', 'product_cat', true);
    }
 
    // Feature newly imported products over a price threshold
    if (!empty($wc_product_data['is_new_product']) && ($wc_product_data['price'] ?? 0) > 100) {
        update_post_meta($product_id, '_featured', 'yes');
    }
}, 10, 4);