WooCommerce Remote Sync — Actions & Filters

// Add a custom task to the to_do list (pair with the custom_doing action below).
add_filter(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_sync_product_to_do_list',
    function ( $array ) {
        $array['to_do'][] = 'do_something_with_stock_in_warehouse';
        return $array;
    }
);

add_action(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_sync_product_custom_doing',
    function ( $do, $remote_product_id, $wc_product, $integration ) {
        if ( 'do_something_with_stock_in_warehouse' === $do ) {
            $stock_in_warehouse = $integration->service->get_product_stock_in_warehouse( $remote_product_id );
            $wc_product->update_meta_data( 'stock_in_warehouse', $stock_in_warehouse );
        }
    },
    10,
    4
);

// Add a custom column to the product sync list table.
add_filter(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_sync_products_list_columns',
    function ( $columns ) {
        $columns['my_custom_column'] = __( 'My Column', 'my-plugin' );
        return $columns;
    }
);

add_action(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_sync_products_list_row_after',
    function ( $row ) {
        // $row contains: id, wc_product_id, wc_parent_id, remote_product_id,
        //                wc_synced_date, diff (JSON), code, name, deleted_status.
        // Custom data must be fetched from WooCommerce or post meta.
        $wc_product = wc_get_product( $row['wc_product_id'] );
        $value      = $wc_product ? $wc_product->get_meta( '_my_custom_meta' ) : '-';
        echo '<td>' . esc_html( $value ?: '-' ) . '</td>';
    }
);

// Override the product name before import.
// Note: properties are readonly — return a new DTO with the changed values.
add_filter(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_import_products_simple_remote_product',
    function ( $remote_product ) {
        return new \PlugandPay\Remote_Sync\DTOs\Importable_Product_Data(
            id:          $remote_product->id,
            code:        $remote_product->code,
            name:        strtoupper( $remote_product->name ),
            meta:        $remote_product->meta,
            group_by_id: $remote_product->group_by_id,
            attributes:  $remote_product->attributes,
            categories:  $remote_product->categories,
        );
    }
);

// Import product description from a remote field.
add_action(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_import_products_simple_end',
    function ( $wc_product_id, $remote_product ) {
        $wc_product = wc_get_product( $wc_product_id );
        if ( ! $wc_product ) {
            return;
        }
        // Remote product data is available on the $remote_product DTO:
        // id, code, name, group_by_id, attributes, categories, meta (array).
        // Meta keys are service-specific — check your integration's service class.
        $wc_product->set_description( $remote_product->meta['comment'] ?? '' );
        $wc_product->save();
    },
    10,
    2
);

// Override the variable product's name from a custom remote field.
// Note: add_fields is Fina-specific and stored in meta — keys depend on your integration.
add_filter(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_import_products_variable_group',
    function ( $remote_products ) {
        $remote_products[0] = new \PlugandPay\Remote_Sync\DTOs\Importable_Product_Data(
            id:          $remote_products[0]->id,
            code:        $remote_products[0]->code,
            name:        $remote_products[0]->meta['add_fields']['usr_column_509'] ?? $remote_products[0]->name,
            meta:        $remote_products[0]->meta,
            group_by_id: $remote_products[0]->group_by_id,
            attributes:  $remote_products[0]->attributes,
            categories:  $remote_products[0]->categories,
        );
        return $remote_products;
    }
);

// Import a shared description onto the parent variable product.
add_action(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_import_products_variable_end',
    function ( $wc_parent_product_id, $group ) {
        $wc_product = wc_get_product( $wc_parent_product_id );
        if ( ! $wc_product ) {
            return;
        }
        // Remote product data is available on the $remote_product DTO:
        // id, code, name, group_by_id, attributes, categories, meta (array).
        // Meta keys are service-specific — check your integration's service class.
        $wc_product->set_description( $group[0]->meta['comment'] ?? '' );
        $wc_product->save();
    },
    10,
    2
);

// Append a custom note to every outgoing order.
add_filter(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_sync_order_data',
    function ( $service_order, $order_id, $remote_order_id, $order ) {
        $service_order['comment'] = 'Source: WooCommerce #' . $order_id;
        return $service_order;
    },
    10,
    4
);

// Add a custom field to the customer payload.
add_filter(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_sync_order_customer_data',
    function ( $service_customer, $customer_id, $remote_customer_id, $order ) {
        $service_customer['vip'] = (bool) get_user_meta( $customer_id, 'is_vip', true );
        return $service_customer;
    },
    10,
    4
);

// Sync all orders to a single fixed customer in the remote service.
add_filter(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_sync_order_override_customer_id',
    function ( $override_customer_id ) {
        return 'FIXED_REMOTE_CUSTOMER_ID';
    }
);

// Append a remote product code to each order line item.
add_filter(
    'plugandpay_woocommerce_remote_sync_{remote_slug}_sync_order_retrieve_product_params',
    function ( $params, $item, $product ) {
        $params['remote_code'] = $product->get_meta( '_remote_product_code' );
        return $params;
    },
    10,
    3
);

add_filter(
    'plugandpay_{plugin_id}_sync_order_personal_no_checkout_field_params',
    function ( $params ) {
        $params['label'] = __( 'ID Number', 'my-plugin' );
        $params['required'] = false;
        return $params;
    }
);

add_filter(
    'plugandpay_{plugin_id}_sync_order_validate_personal_no_char_length',
    function () {
        return 9;
    }
);

// Disable the length check (e.g. during testing).
add_filter(
    'plugandpay_{plugin_id}_sync_order_validate_personal_no_char_length_test',
    function () {
        return false;
    }
);

// Allow letters in the personal number field.
add_filter(
    'plugandpay_{plugin_id}_sync_order_validate_personal_no_numbers_only',
    function () {
        return false;
    }
);

// Add a custom header to all API requests.
add_filter(
    'plugandpay_{plugin_id}_api_request_args',
    function ( $args, $endpoint ) {
        $args['headers']['X-Custom-Header'] = 'my-value';
        return $args;
    },
    10,
    2
);