Урок 1.2. CRUD і data stores

Мета

Працювати з товарами і замовленнями лише через CRUD-об'єкти і розуміти, навіщо потрібен шар data store.

Ключові поняття

• WC_Data — базовий клас для WC_Product, WC_Order, WC_Customer, WC_Coupon
• Getters / setters: get_price(), set_regular_price(); зміни застосовуються на save()
• Мета: get_meta(), update_meta_data(), delete_meta_data() + save()
• Data store — клас, що знає, де і як зберігати об'єкт (пости, HPOS, власні таблиці)
• wc_get_product(), wc_get_order(), wc_get_products(), wc_get_orders() — точки входу
• Хуки woocommerce_before_{object}_object_save / woocommerce_after_{object}_object_save

Схема

flowchart LR
  CODE["Ваш код"] -->|"set_*(), save()"| OBJ["WC_Order / WC_Product"]
  OBJ --> DS{"Data store"}
  DS -->|HPOS увімкнено| HPOS[("wc_orders ...")]
  DS -->|HPOS вимкнено| POSTS[("wp_posts + wp_postmeta")]
  DS --> CACHE["Кеш, lookup-таблиці,<br/>хуки, інвалідація"]

Код

Правильно: зміни через CRUD.

<?php
$product = wc_get_product( $product_id );
if ( ! $product ) {
	return;
}
$product->set_regular_price( '499' );
$product->set_sale_price( '399' );
$product->update_meta_data( '_supplier_code', 'SUP-1042' );
$product->save(); // оновить lookup-таблицю, кеш і викличе хуки

$order = wc_get_order( $order_id );
$order->update_meta_data( '_erp_id', 'ERP-778' );
$order->add_order_note( 'Синхронізовано з ERP' );
$order->save();

Неправильно: обхід CRUD.

<?php
update_post_meta( $product_id, '_price', 399 );   // lookup-таблиця і кеш застаріли
update_post_meta( $order_id, '_erp_id', 'ERP-778' ); // з HPOS не потрапить у wc_orders_meta

Типові помилки

Слабка і сильна відповідь

Питання: Як змінити ціну товару програмно?

Слабка відповідь. update_post_meta( $id, '_price', 100 ).

Сильна відповідь. Через CRUD: $product = wc_get_product( $id ); $product->set_regular_price( '100' ); $product->save();. save() проходить через data store: оновлює lookup-таблицю, кеш, викликає хуки. Для варіативного товару ціна задається на кожній варіації.

Чому друга сильніша: Кандидат пояснює, що саме ламається в обхід CRUD, і згадує нюанс з варіаціями.

Практичне завдання

Напишіть WP-CLI eval або невеликий плагін: знайдіть товар за SKU (wc_get_product_id_by_sku()), змініть ціну зі знижкою 10% і додайте мета-поле _last_price_update з датою. Перевірте, що ціна в каталозі з фільтром оновилась.

Питання з інтерв'ю