Changeset 3762744

Timestamp:

10/24/2026 04:45:14 AM (5 hours ago)

Author:

koalabtech

Message:

Version 1.3.0

Location:

koalab-sync/trunk

Files:

• includes/movements.php (modified) (10 diffs)
• includes/signals.php (added)
• koalab-sync.php (modified) (9 diffs)
• readme.txt (modified) (6 diffs)
• uninstall.php (modified) (3 diffs)

koalab-sync/trunk/includes/movements.php

@@ -22 +22 @@
 const KOALAB_SYNC_COLLAPSE_THRESHOLD = 1000; // Above this in one request → single "bulk" summary.
 const KOALAB_SYNC_DELIVER_CHUNK      = 200;   // Events per delivery batch.
-const KOALAB_SYNC_FIELDS             = array( 'regular_price', 'sale_price', 'stock_quantity', 'stock_status' );
+/**
+ * «This product does not keep an inventory count», said with a word.
+ *
+ * When `manage_stock` is switched off WooCommerce empties `stock_quantity` (`validate_props()`), so the
+ * change used to travel as «12 → (nothing)», which Koalab cannot tell apart from a value nobody knows and
+ * dropped as noise. Since 1.3.0 the plugin says it explicitly, in both directions, with the same token
+ * Koalab uses everywhere else (`UNTRACKED_STOCK` in the API). Koalab 14 Oct 2026 also reads the old form.
+ */
+const KOALAB_SYNC_UNTRACKED          = 'untracked';
+/**
+ * The product fields whose changes travel to Koalab.
+ *
+ * Scalar only, and on purpose. A movement is a ledger line — «this went from X to Y» — and it is
+ * read in a table next to hundreds of others. A full description or a gallery has no readable
+ * before/after in that shape, so those changes belong to the catalogue reconciliation, not here.
+ *
+ * `sku` is first for a reason: it is the key Koalab matches products by. Changing it in the store
+ * silently detaches the product from its catalogue entry, and until now nothing said so.
+ */
+const KOALAB_SYNC_FIELDS             = array(
+        'regular_price',
+        'sale_price',
+        'stock_quantity',
+        'stock_status',
+        'sku',
+        'name',
+        'status',
+        'manage_stock',
+        'weight',
+);
 
 /* -------------------------------------------------------------------------
@@ -167 +196 @@
  * ---------------------------------------------------------------------- */
 
+/**
+ * Flattens a field value into something a ledger line can hold.
+ *
+ * `manage_stock` arrives as a real boolean and `(string) false` is an empty string — which reads as
+ * «the value was removed» instead of «it was off». Anything that is not a scalar is refused
+ * outright rather than serialised into noise.
+ */
+function koalab_sync_scalar( $value ) {
+        if ( is_bool( $value ) ) {
+                return $value ? 'yes' : 'no';
+        }
+        if ( is_null( $value ) || is_scalar( $value ) ) {
+                return $value;
+        }
+        return null;
+}
+
 function koalab_sync_push_event( $product, $field, $old, $new ) {
         if ( ! koalab_sync_is_connected() || koalab_sync_is_suppressed() ) {
@@ -172 +218 @@
         }
         if ( (string) $old === (string) $new ) {
+                return;
+        }
+        // A non-scalar that `koalab_sync_scalar` refused. Sending it would put `Array` in the ledger.
+        if ( ! is_null( $old ) && ! is_scalar( $old ) ) {
+                return;
+        }
+        if ( ! is_null( $new ) && ! is_scalar( $new ) ) {
                 return;
         }
@@ -211 +264 @@
         $in_order   = ! empty( $GLOBALS['koalab_sync_ctx'] );
 
+        if ( array_key_exists( 'stock_quantity', $changes ) ) {
+                // This save already reports its stock: the `..._set_stock` hooks below must not report it again.
+                $GLOBALS['koalab_sync_stock_seen'][ $product->get_id() ] = true;
+        }
+
         foreach ( KOALAB_SYNC_FIELDS as $field ) {
                 if ( ! array_key_exists( $field, $changes ) ) {
@@ -219 +277 @@
                 }
                 $old = isset( $data[ $field ] ) ? $data[ $field ] : null;
-                koalab_sync_push_event( $product, $field, $old, $changes[ $field ] );
-        }
+                $new = $changes[ $field ];
+                if ( 'stock_quantity' === $field ) {
+                        list( $old, $new ) = koalab_sync_stock_pair( $product, $data, $old, $new );
+                }
+                koalab_sync_push_event( $product, $field, koalab_sync_scalar( $old ), koalab_sync_scalar( $new ) );
+        }
+}
+
+/**
+ * The stock's before/after, with «no inventory control» named instead of left blank.
+ *
+ * - Switched off: WooCommerce has just emptied the quantity → «N → untracked».
+ * - Switched on, on a product that already existed: the quantity appears from nothing → «untracked → N».
+ *   A brand-new product also starts from nothing, and that is not a switch, so it keeps its blank.
+ */
+function koalab_sync_stock_pair( $product, $data, $old, $new ) {
+        $was_managed = ! empty( $data['manage_stock'] ) && 'no' !== $data['manage_stock'];
+        $is_managed  = (bool) $product->get_manage_stock( 'edit' );
+        if ( ! $is_managed && ( null === $new || '' === $new ) ) {
+                $new = KOALAB_SYNC_UNTRACKED;
+        }
+        if ( $is_managed && ! $was_managed && ( null === $old || '' === $old ) && $product->get_id() ) {
+                $old = KOALAB_SYNC_UNTRACKED;
+        }
+        return array( $old, $new );
 }
 
@@ -255 +336 @@
 }
 
-/** Refund restock → gives old and new directly. */
-function koalab_sync_capture_restock_refunded( $product_id, $old_stock, $new_stock, $item_qty = 0, $order = null ) {
+/**
+ * Refund restock → gives old and new directly.
+ *
+ * WooCommerce calls it with `( $product_id, $old_stock, $new_stock, $order, $product )`. Up to 1.2.0 the
+ * fourth argument was read as a quantity and the fifth as the order, so the order was never found and the
+ * refund reached Koalab without its order number. Whichever of the two is the order is used.
+ */
+function koalab_sync_capture_restock_refunded( $product_id, $old_stock, $new_stock, $arg4 = null, $arg5 = null ) {
         $product = wc_get_product( $product_id );
         if ( ! $product ) {
                 return;
         }
-        koalab_sync_ctx_open( 'refund', is_a( $order, 'WC_Order' ) ? $order->get_id() : 0 );
+        $order = is_a( $arg4, 'WC_Order' ) ? $arg4 : ( is_a( $arg5, 'WC_Order' ) ? $arg5 : null );
+        // WooCommerce restocks a refund item by item and calls this after each one. Closing the context
+        // here left the NEXT item's stock write without it, so the `..._set_stock` hooks would report it a
+        // second time as a hand edit. The context the refund opened is restored instead.
+        $prev_ctx   = isset( $GLOBALS['koalab_sync_ctx'] ) ? $GLOBALS['koalab_sync_ctx'] : null;
+        $prev_order = isset( $GLOBALS['koalab_sync_order_id'] ) ? $GLOBALS['koalab_sync_order_id'] : 0;
+        koalab_sync_ctx_open( 'refund', $order ? $order->get_id() : 0 );
         koalab_sync_push_event( $product, 'stock_quantity', $old_stock, $new_stock );
-        koalab_sync_ctx_close();
+        if ( $prev_ctx ) {
+                koalab_sync_ctx_open( $prev_ctx, $prev_order );
+        } else {
+                koalab_sync_ctx_close();
+        }
+}
+
+/**
+ * Stock written straight to the database by `wc_update_product_stock()`.
+ *
+ * That function updates the quantity with SQL and then loads it into the product as already READ, not as
+ * a pending change, so the save that follows has no stock change in it and the CRUD hook above saw
+ * nothing. It is the path of WooCommerce's own bulk edit («Products → Bulk actions → Edit → Stock qty»),
+ * of the order-item quantity edits in the admin, and of most ERP and stock-sync plugins. Up to 1.2.0
+ * those changes never reached Koalab. Read in WooCommerce 11.2.1 (`wc-stock-functions.php`,
+ * `class-wc-admin-post-types.php`).
+ *
+ * The same pair of actions also fires inside an ordinary save that does carry a stock change, and inside
+ * every order operation: the first is already reported by the CRUD hook (`koalab_sync_stock_seen`), the
+ * second by the order hooks (an open context). Both are skipped, so nothing is counted twice.
+ */
+function koalab_sync_capture_before_set_stock( $product ) {
+        if ( ! is_a( $product, 'WC_Product' ) || ! empty( $GLOBALS['koalab_sync_ctx'] ) ) {
+                return;
+        }
+        if ( ! empty( $GLOBALS['koalab_sync_stock_seen'][ $product->get_id() ] ) ) {
+                return;
+        }
+        $GLOBALS['koalab_sync_stock_before'][ $product->get_id() ] = $product->get_stock_quantity( 'edit' );
+}
+
+function koalab_sync_capture_set_stock( $product ) {
+        if ( ! is_a( $product, 'WC_Product' ) ) {
+                return;
+        }
+        $id = $product->get_id();
+        unset( $GLOBALS['koalab_sync_stock_seen'][ $id ] );
+        if ( ! isset( $GLOBALS['koalab_sync_stock_before'] ) || ! array_key_exists( $id, $GLOBALS['koalab_sync_stock_before'] ) ) {
+                return;
+        }
+        $old = $GLOBALS['koalab_sync_stock_before'][ $id ];
+        unset( $GLOBALS['koalab_sync_stock_before'][ $id ] );
+        if ( ! empty( $GLOBALS['koalab_sync_ctx'] ) ) {
+                return;
+        }
+        koalab_sync_push_event( $product, 'stock_quantity', $old, $product->get_stock_quantity( 'edit' ) );
 }
 
@@ -315 +453 @@
 const KOALAB_SYNC_MAX_ATTEMPTS = 5;
 
+/**
+ * Schedules a retry of a batch.
+ *
+ * The batch itself is parked in an option and only its key travels as the action's argument. Action
+ * Scheduler refuses arguments longer than 8,000 characters once JSON-encoded —it logs the exception and
+ * schedules nothing— and one event is ~350 characters, so up to 1.2.0 the retry of any batch of more than
+ * about twenty events was silently never scheduled: exactly the batches that matter (a sale with many
+ * lines, a bulk edit) were lost when Koalab answered with a 5xx.
+ */
 function koalab_sync_enqueue_delivery( $events, $attempt = 1, $delay = 0 ) {
-        // Entrega inmediata (delay 0): acción ASÍNCRONA de Action Scheduler — corre vía loopback en el
-        // shutdown, en segundos, SIN depender de WP-Cron (clave en tiendas de bajo tráfico). Los
-        // reintentos usan una acción programada con backoff.
+        $key = 'koalab_sync_retry_' . md5( wp_json_encode( $events ) . '|' . $attempt . '|' . microtime( true ) );
+        update_option( $key, $events, false );
+        $args = array( $key, $attempt );
+
         if ( $delay <= 0 && function_exists( 'as_enqueue_async_action' ) ) {
-                as_enqueue_async_action( 'koalab_sync_deliver', array( $events, $attempt ), 'koalab-sync' );
+                as_enqueue_async_action( 'koalab_sync_deliver_parked', $args, 'koalab-sync' );
                 return;
         }
         $when = time() + (int) $delay;
         if ( function_exists( 'as_schedule_single_action' ) ) {
-                as_schedule_single_action( $when, 'koalab_sync_deliver', array( $events, $attempt ), 'koalab-sync' );
+                as_schedule_single_action( $when, 'koalab_sync_deliver_parked', $args, 'koalab-sync' );
         } else {
-                wp_schedule_single_event( $when, 'koalab_sync_deliver', array( $events, $attempt ) );
-        }
-}
+                wp_schedule_single_event( $when, 'koalab_sync_deliver_parked', $args );
+        }
+}
+
+/** Runs a parked retry: takes the batch out of its option (once) and delivers it. */
+function koalab_sync_deliver_parked( $key, $attempt = 1 ) {
+        if ( ! is_string( $key ) || 0 !== strpos( $key, 'koalab_sync_retry_' ) ) {
+                return;
+        }
+        $events = get_option( $key, null );
+        delete_option( $key );
+        if ( is_array( $events ) ) {
+                koalab_sync_deliver( $events, (int) $attempt );
+        }
+}
+add_action( 'koalab_sync_deliver_parked', 'koalab_sync_deliver_parked', 10, 2 );
 
 /**
@@ -387 +548 @@
         }
 }
+// Kept for retries scheduled by 1.1.0/1.2.0 before the update, which carry the batch itself.
 add_action( 'koalab_sync_deliver', 'koalab_sync_deliver', 10, 2 );
 
@@ -406 +568 @@
                 add_action( 'woocommerce_before_product_object_save', 'koalab_sync_capture_product_save', 20, 1 );
                 add_action( 'woocommerce_before_product_variation_object_save', 'koalab_sync_capture_product_save', 20, 1 );
+
+                // Stock written by `wc_update_product_stock()` outside an order: bulk edit, ERPs, other plugins.
+                add_action( 'woocommerce_product_before_set_stock', 'koalab_sync_capture_before_set_stock', 20, 1 );
+                add_action( 'woocommerce_variation_before_set_stock', 'koalab_sync_capture_before_set_stock', 20, 1 );
+                add_action( 'woocommerce_product_set_stock', 'koalab_sync_capture_set_stock', 20, 1 );
+                add_action( 'woocommerce_variation_set_stock', 'koalab_sync_capture_set_stock', 20, 1 );
 
                 // Order-driven stock: precise old→new + origin.
@@ -420 +588 @@
                         add_action( 'woocommerce_order_status_' . $status, $open_sale, 1, 1 );
                 }
-                add_action( 'woocommerce_order_status_cancelled', function ( $order_id ) {
-                        koalab_sync_ctx_open( 'return', $order_id );
-                }, 1, 1 );
+                // Every status in which WooCommerce gives a reduced order's units back
+                // (`wc_maybe_increase_stock_levels`): cancelled, pending and —since WooCommerce 11.0— failed.
+                foreach ( array( 'cancelled', 'pending', 'failed' ) as $status ) {
+                        add_action( 'woocommerce_order_status_' . $status, function ( $order_id ) {
+                                koalab_sync_ctx_open( 'return', $order_id );
+                        }, 1, 1 );
+                }
                 add_action( 'woocommerce_create_refund', function () {
                         koalab_sync_ctx_open( 'refund', 0 );

koalab-sync/trunk/koalab-sync.php

@@ -1 +1 @@
 <?php
 /**
- * Plugin Name:       Koalab Sync — Bulk Price & Stock Updates for WooCommerce
+ * Plugin Name:       Koalab Sync for WooCommerce
  * Plugin URI:        https://koalab.tech
- * Description:       Update prices and stock of your entire WooCommerce catalog from your supplier's Excel/CSV price list — with markup rules, preview and one-click revert.
- * Version:           1.1.0
+ * Description:       Optional companion for Koalab Sync: sends your store's price and stock changes to Koalab in seconds, each with its cause. Koalab works without it, through WooCommerce's own webhooks.
+ * Version:           1.3.0
  * Author:            Koalab
  * License:           GPLv2 or later
@@ -13 +13 @@
  * Requires Plugins:  woocommerce
  * WC requires at least: 7.0
+ * WC tested up to:  11.2
  */
 
@@ -19 +20 @@
 }
 
-define( 'KOALAB_SYNC_VERSION', '1.1.0' );
-define( 'KOALAB_SYNC_APP_URL', 'https://koalab.tech' );
+define( 'KOALAB_SYNC_VERSION', '1.3.0' );
+
+/**
+ * A dónde habla el plugin. Producción por defecto, que es lo que instala un comerciante.
+ *
+ * Se puede fijar antes desde `wp-config.php` para apuntarlo a QA o a una API local. Sin esta
+ * guarda no se podía: el valor estaba escrito en duro, así que el plugin sólo sabía hablar con
+ * producción y no había forma de probarlo de punta a punta sin editar su código. Definirlo fuera
+ * además provocaba un aviso de PHP por redefinir una constante.
+ *
+ * No cambia nada para quien lo instala desde WordPress.org: si nadie lo define antes, vale lo mismo
+ * que valía.
+ */
+if ( ! defined( 'KOALAB_SYNC_APP_URL' ) ) {
+        define( 'KOALAB_SYNC_APP_URL', 'https://koalab.tech' );
+}
 
 // Movement capture engine (P4) — optional store-side change tracking.
 require_once plugin_dir_path( __FILE__ ) . 'includes/movements.php';
+// Heartbeat and «I am being switched off», while movement sync is connected (1.3.0).
+require_once plugin_dir_path( __FILE__ ) . 'includes/signals.php';
 
 // Translations are loaded automatically by WordPress.org for plugins hosted there
@@ -42 +59 @@
 register_activation_hook( __FILE__, function () {
         update_option( 'koalab_sync_show_notice', 1 );
-} );
+        koalab_sync_on_activate();
+} );
+
+/**
+ * On deactivation: tell Koalab, so it goes back to WooCommerce's own webhooks at once instead of waiting
+ * for a heartbeat that will not come. See includes/signals.php.
+ */
+register_deactivation_hook( __FILE__, 'koalab_sync_on_deactivate' );
+
+add_action( KOALAB_SYNC_HEARTBEAT_HOOK, 'koalab_sync_heartbeat' );
+add_action( 'init', 'koalab_sync_schedule_heartbeat' );
+add_action( 'admin_init', 'koalab_sync_heartbeat_fallback' );
 
 /**
@@ -81 +109 @@
                         'domain'     => rawurlencode( home_url() ),
                 ),
-                KOALAB_SYNC_APP_URL . '/apps/sync/credentials'
+                KOALAB_SYNC_APP_URL . '/channels'
         );
 }
@@ -214 +242 @@
                                 'utm_source' => 'wp-plugin',
                         ),
-                        KOALAB_SYNC_APP_URL . '/apps/sync/credentials'
+                        KOALAB_SYNC_APP_URL . '/channels'
                 );
                 // External redirect to the Koalab app: whitelist its host so wp_safe_redirect() allows it.
@@ -237 +265 @@
                 $redirect = add_query_arg( 'koalab_paired', $res['ok'] ? '1' : 'pending', $redirect );
         } elseif ( 'disconnect' === $action ) {
+                // Up to 1.2.0 Koalab never heard about this and kept ignoring WooCommerce's own webhooks.
+                koalab_sync_signal_off( 'disconnected' );
                 koalab_sync_clear_connection();
+                wp_clear_scheduled_hook( KOALAB_SYNC_HEARTBEAT_HOOK );
                 delete_option( 'koalab_sync_pair_nonce' );
                 $redirect = add_query_arg( 'koalab_disconnected', '1', $redirect );
@@ -279 +310 @@
                 </h2>
                 <p style="font-size:14px;color:#50575e;max-width:620px;">
-                        <?php esc_html_e( 'Capture the price and stock changes that happen directly in your store — sales, returns, manual edits and third-party plugins — so they all show up in Koalab\'s Movements screen. Koalab keeps working without this; the plugin just adds deeper tracking.', 'koalab-sync' ); ?>
+                        <?php esc_html_e( 'Koalab keeps working without this: WooCommerce\'s own webhooks already tell it about sales and price and stock edits within minutes. With movement sync, every change made in your store arrives in seconds, labelled with its exact time and cause — sale, refund, hand edit, import or another plugin — and SKU, name, status and weight changes are recorded too.', 'koalab-sync' ); ?>
                 </p>
 
@@ -309 +340 @@
                                         <h3 style="font-size:1em;margin:0 0 8px;"><?php esc_html_e( 'Option A — Enter a code', 'koalab-sync' ); ?></h3>
                                         <p style="font-size:13px;color:#50575e;margin:0 0 8px;">
-                                                <?php esc_html_e( 'In Koalab → your store → Movements, generate a connection code and paste it here.', 'koalab-sync' ); ?>
+                                                <?php esc_html_e( 'In Koalab, go to Channels → Configure → Plugin tab, generate a connection code and paste it here.', 'koalab-sync' ); ?>
                                         </p>
                                         <form method="post" action="<?php echo esc_url( admin_url( 'admin.php?page=koalab-sync' ) ); ?>">

koalab-sync/trunk/readme.txt

@@ -1 @@
-=== Koalab Sync — Bulk Price & Stock Updates for WooCommerce ===
+=== Koalab Sync for WooCommerce ===
 Contributors: koalabtech
-Tags: bulk edit, prices, stock, woocommerce, excel
+Tags: multichannel, inventory sync, stock sync, price sync, woocommerce
 Requires at least: 6.0
-Tested up to: 7.0
+Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 1.1.0
+Stable tag: 1.3.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
-Update prices and stock of your entire WooCommerce catalog from your supplier's Excel/CSV price list — with markup rules and one-click revert.
+Optional companion for Koalab Sync: sends your store's price and stock changes to Koalab in seconds, each with its cause.
 
 == Description ==
 
-**Koalab Sync** connects your WooCommerce store to [Koalab](https://koalab.tech), a cloud tool that turns your supplier's price list into an updated catalog in minutes.
+[Koalab Sync](https://koalab.tech) is a cloud service that keeps your product catalog in one place and syncs prices, stock and sale prices to your sales channels — your WooCommerce store, and also Mercado Libre, Shopify or Tiendanube if you sell there. It can also update the whole catalog from a supplier's Excel/CSV price list, with markup rules, a preview and one-click revert.
 
-If you run a store that resells products from distributors — hardware, auto parts, pharmacies, electronics, cosmetics — you know the routine: your supplier sends a new price list in Excel, and you spend hours updating products one by one, or fighting with CSV imports that break your catalog.
+**You do not need this plugin to use Koalab Sync.** You connect your store from Koalab with WooCommerce's own authorization screen, and Koalab subscribes to WooCommerce's webhooks: your sales and your price and stock edits reach Koalab within a few minutes, with nothing installed in WordPress.
 
-Koalab Sync fixes that:
+This plugin is an optional companion for two cases:
 
-* **Upload the Excel/CSV your supplier sends you** — no reformatting needed. Column names are detected automatically and products are matched by SKU or ID.
-* **Apply your profit margin automatically** — markup, rounding and min/max price rules per store.
-* **Preview every change before it happens** — see old price → new price for every product, with alerts for suspicious changes (price zero, sale price above regular price, sudden drops).
-* **Revert with one click** — every update creates a snapshot. If something goes wrong, undo it entirely.
-* **Schedule updates** — leave the update ready and let it run at night.
-* **Zero load on your site** — everything runs in Koalab's cloud through the official WooCommerce REST API. This plugin adds no queries, no cron jobs and no tables to your WordPress.
+* **You want the detail.** With movement sync connected, each change made in your store reaches Koalab within seconds of the request that made it, labeled with its exact time and its cause — sale, return, refund, hand edit, REST API, import or scheduled sale. Changes to SKU, name, status, stock management and weight are recorded too, not only price and stock.
+* **WooCommerce's notices are not reaching Koalab.** WooCommerce sends its webhooks from its task queue, which depends on WP-Cron. If WP-Cron is disabled on your site, or a security plugin blocks outgoing requests, Koalab only learns about your store with its periodic import. The plugin delivers changes itself at the end of each request, without waiting for WP-Cron (on PHP-FPM hosts), and retries when Koalab cannot be reached.
 
-**Free plan available** — connect 1 store and run up to 5 updates per month at no cost, no credit card required.
+While movement sync is connected, Koalab stops using WooCommerce's webhooks for that store, so no change is counted twice. If you deactivate, delete or disconnect the plugin, it tells Koalab, and Koalab goes back to WooCommerce's webhooks on its own. The plugin also checks in once a day, so Koalab notices when it has stopped reporting for any other reason.
 
-= What this plugin does =
+= What the plugin adds to your WordPress =
 
-This plugin adds a page under your WooCommerce menu that connects your store to Koalab using WooCommerce's official authorization flow (`wc-auth`). You approve access with one click — no copying API keys, and Koalab never sees your WordPress password. All the heavy lifting happens in the cloud.
+* A page under **WooCommerce → Koalab Sync** with links to create your Koalab account or connect your store (through WooCommerce's official `wc-auth` authorization flow: you approve access with one click, and Koalab never sees your WordPress password).
+* The optional movement sync described above, off until you pair the plugin with your store in Koalab.
+
+The plugin adds no database tables and does not write to your products: everything Koalab writes to your store goes through the WooCommerce REST API keys you authorized.
 
 = Disponible en español =
 
-Koalab está completamente disponible en español (y portugués). Sube la lista de precios de tu proveedor en Excel, aplica tu margen de ganancia automáticamente, revisa los cambios antes de aplicarlos y actualiza cientos de productos en minutos — con reversión de un clic si algo sale mal. Plan gratuito disponible: 1 tienda y 5 actualizaciones al mes, sin tarjeta de crédito.
+Koalab Sync está disponible en español y portugués. Este plugin es opcional: sin él, los avisos de la propia WooCommerce ya traen a Koalab tus ventas y tus cambios de precio y stock en unos minutos. Con él llegan en segundos, con su hora exacta y su causa, y funciona también en tiendas donde esos avisos no salen.
 
 == External services ==
@@ -43 +42 @@
 
 * **When you connect your store** (clicking the connect button): you are redirected to Koalab and your store's site URL (domain) is sent so Koalab can pair with your store. Access to your products is then granted through WooCommerce's official authorization flow (`wc-auth`), which issues REST API keys you explicitly approve.
-* **During synchronization** (performed by Koalab, not by this plugin): Koalab reads and writes your WooCommerce **products** (names, SKUs, prices, stock) through those authorized REST API keys. Koalab does not access your WordPress admin, customers or orders.
-* **Optional movement tracking** (off unless you enable it): when a product's price or stock changes in your store, the plugin sends the change event (product ID, SKU, changed field, old/new value and timestamp) to Koalab's API so it appears on Koalab's Movements screen.
+* **During synchronization** (performed by Koalab, not by this plugin): Koalab reads and writes your WooCommerce **products** (names, SKUs, prices, stock) through those authorized REST API keys, and reads your store's status report to know your currency, your WooCommerce version and whether this plugin is active.
+* **Store notifications** (performed by Koalab, not by this plugin): unless movement sync is connected and reporting, Koalab subscribes your store to WooCommerce's own webhooks for product updates, product deletions and orders, so it learns about sales and edits without waiting for its periodic import. From an order Koalab keeps only its number, status, dates and the products and quantities sold — never the buyer's name, address or contact details. Koalab does not access your WordPress admin.
+* **Optional movement sync** (off unless you pair the plugin with your store in Koalab): when a product's price, stock, SKU, name, status, stock management or weight changes in your store, the plugin sends the change event (product ID, SKU, product name, changed field, old and new value, cause, order number when there is one, and timestamp) to Koalab's API so it appears on Koalab's Movements screen.
+* **Connection check** (only while movement sync is connected): once a day, and when the plugin is deactivated, deleted or disconnected from its page, the plugin sends your Koalab store ID, your site URL, the plugin version and a timestamp, so Koalab knows whether the plugin is still reporting and can go back to WooCommerce's webhooks when it is not. No product, order or customer data is included.
+
+Every request the plugin makes to Koalab is signed with a secret shared only when you pair the plugin.
 
 This service is provided by Koalab. By connecting your store you agree to Koalab's Terms of Service (https://koalab.tech/terms) and Privacy Policy (https://koalab.tech/privacy).
@@ -50 +53 @@
 == Installation ==
 
+You do not need the plugin to connect your store: in Koalab, go to **Channels**, connect a channel and choose WooCommerce. Install the plugin only if you want movement sync:
+
 1. Install and activate the plugin from the WordPress plugin directory.
-2. Go to **WooCommerce → Koalab Sync**.
-3. Click **"Create free account & connect"** (or "I already have an account").
-4. Approve access on the WooCommerce authorization screen — that's it.
+2. In Koalab, go to **Channels → Configure** on your WooCommerce store, open the **Plugin** tab and generate a connection code.
+3. In WordPress, go to **WooCommerce → Koalab Sync**, paste the code under **Movement sync (optional)** and click **Connect** — or click **Open Koalab** and confirm the store there.
 
 Requirements: WooCommerce 7.0+, your store must be served over HTTPS, and pretty permalinks must be enabled (Settings → Permalinks).
@@ -59 +63 @@
 == Frequently Asked Questions ==
 
-= Is it free? =
+= Do I need this plugin to use Koalab Sync? =
 
-Yes — the free plan includes 1 store and 5 bulk updates per month, with no credit card. Paid plans add more updates, scheduled syncs, price rules and longer history.
+No. Without it, WooCommerce's own webhooks already bring your sales and price and stock edits to Koalab within minutes. The plugin makes them arrive in seconds, labels each change with its exact time and cause, records SKU, name, status and weight changes too, and keeps working where WooCommerce's webhooks do not go out.
+
+= What happens if I deactivate or delete the plugin? =
+
+The plugin tells Koalab, and Koalab subscribes your store to WooCommerce's own webhooks again: your sales keep arriving, within minutes instead of seconds. If you activate it again, Koalab uses it again on its own. If the plugin stops reporting without saying so (for example, it was removed over FTP), Koalab notices when its daily check-in stops arriving and does the same.
+
+= Is Koalab Sync free? =
+
+There is a free plan, with no credit card. Paid plans add more updates, more channels, scheduled syncs and price rules. See https://koalab.tech for the current plans.
 
 = Does this plugin slow down my store? =
 
-No. The plugin only adds an admin page with a connect button. Synchronization runs in Koalab's cloud and talks to your store through the standard WooCommerce REST API, the same one used by mobile apps and integrations.
+No. Without movement sync the plugin only adds an admin page. With it, the plugin notes which fields changed when a product is saved and sends them once, after the page has been served, plus one small check-in a day. Synchronization runs in Koalab's cloud and talks to your store through the standard WooCommerce REST API.
 
 = What data does Koalab access? =
 
-Only your WooCommerce products (names, SKUs, prices, stock), through the API keys you explicitly authorize. Credentials are stored encrypted (AES-256). Koalab never accesses your WordPress admin, customers or orders.
+Your WooCommerce products (names, SKUs, prices, stock) and your store's status report, through the API keys you explicitly authorize, and — through WooCommerce's webhooks — the status and the lines (products and quantities) of your orders, so a sale reaches your other channels. Nothing about the buyer is kept. Credentials are stored encrypted (AES-256). Koalab never accesses your WordPress admin.
 
 = Does it work with product variations? =
 
-Yes — variations are matched and updated just like simple products.
+Yes — variations are captured and synced just like simple products.
 
-= Can I undo an update? =
+= Can I update my catalog from a supplier's price list? =
 
-Yes. Every update creates a snapshot of the previous values. You can revert the entire update with one click from the history.
-
-= My supplier's Excel has different column names. Will it work? =
-
-Yes. Koalab detects common column names automatically (SKU, price, stock, etc. — in English, Spanish and Portuguese) and lets you map any column manually.
+Yes, in Koalab: upload the Excel or CSV your supplier sends you, map its columns, apply your markup rules, preview every change and revert it with one click. That runs in Koalab, with or without this plugin.
 
 == Screenshots ==
@@ -91 +99 @@
 
 == Changelog ==
+
+= 1.3.0 =
+* New: while movement sync is connected, the plugin checks in with Koalab once a day and tells it when it is deactivated, deleted or disconnected from its page. Koalab then goes back to WooCommerce's own webhooks instead of waiting for movements that will not come. Up to 1.2.0, a plugin switched off without disconnecting it left Koalab unaware of the store's changes until its next catalog import.
+* The description now says what the plugin is today: an optional companion of Koalab Sync. Koalab works without it.
+* New: movement sync reports when a product stops (or starts again) tracking inventory, so Koalab marks it as "no inventory control" instead of reading it as sold out.
+* Fixed: stock changes made with WooCommerce's bulk edit, when editing an order's items in the admin, or by ERPs and stock plugins that use `wc_update_product_stock()` were not captured.
+* Fixed: a refund that restocks items now carries its order number, and a refund with several items is no longer reported twice.
+* Fixed: an order moved back to pending, or a held order whose payment fails (WooCommerce 11.0+), is reported as a return.
+* Fixed: the retry of a large batch was never scheduled, so those changes were lost if Koalab could not be reached.
+* The setup text points at Koalab's current screens (Channels → Configure → Plugin tab).
+* Tested with WordPress 7.1 and WooCommerce 11.2.
+
+= 1.2.0 =
+* Movement sync now also captures SKU, name, status, stock management and weight changes — not just prices and stock.
+* Fixed: "Open Koalab" and the connect link pointed at a page that no longer exists, so they landed on a 404. Both now open the Channels screen.
+* Fixed: the setup text sent you to Movements to generate the connection code. It is generated in Channels → your store → Plugin.
+* Tested with WordPress 7.1.
 
 = 1.1.0 =
@@ -102 +127 @@
 == Upgrade Notice ==
 
+= 1.3.0 =
+Koalab now notices when the plugin is deactivated or stops reporting. Also captures stock changes from bulk edits and other plugins, reports "no inventory control", and no longer loses retries of large batches.
+
+= 1.2.0 =
+Captures more product changes, and fixes the two connection links that led to a missing page.
+
 = 1.1.0 =
 Adds optional movement sync (sales, returns and manual edits) plus low-stock alerts.

koalab-sync/trunk/uninstall.php

@@ -12 +12 @@
 }
 
+// Tell Koalab before the secret goes (1.3.0): the connection ends here, and Koalab goes back to
+// WooCommerce's own webhooks. Nothing is sent if movement sync was never connected.
+require_once __DIR__ . '/includes/signals.php';
+koalab_sync_signal_off( 'uninstalled' );
+wp_clear_scheduled_hook( KOALAB_SYNC_HEARTBEAT_HOOK );
+
 $koalab_sync_options = array(
         'koalab_sync_show_notice',
@@ -21 +27 @@
         'koalab_sync_pair_nonce',
         'koalab_sync_last_error',
+        'koalab_sync_last_beat',
 );
 
@@ -26 +33 @@
         delete_option( $koalab_sync_option );
 }
+
+// Batches parked for a retry (1.3.0+), and their scheduled actions.
+global $wpdb;
+$koalab_sync_parked = $wpdb->get_col( $wpdb->prepare( "SELECT option_name FROM {$wpdb->options} WHERE option_name LIKE %s", $wpdb->esc_like( 'koalab_sync_retry_' ) . '%' ) ); // phpcs:ignore WordPress.DB.DirectDatabaseQuery
+foreach ( $koalab_sync_parked as $koalab_sync_option ) {
+        delete_option( $koalab_sync_option );
+}
+if ( function_exists( 'as_unschedule_all_actions' ) ) {
+        as_unschedule_all_actions( 'koalab_sync_deliver_parked' );
+        as_unschedule_all_actions( 'koalab_sync_deliver' );
+}