# HPOS în WooCommerce: ce este și compatibilitatea pluginurilor

> Ce este HPOS (High-Performance Order Storage) în WooCommerce, cum verifici pluginurile și cum treci în siguranță la stocarea comenzilor în tabele dedicate.

- Sursa: https://maxdev.ro/blog/hpos-woocommerce-compatibilitate-pluginuri/
- Versiunea în engleză: https://maxdev.ro/en/blog/woocommerce-hpos-plugin-compatibility/
- Autor: Daniel Florea
- Publicat: 2026-10-06
- Indexul site-ului pentru AI: https://maxdev.ro/llms.txt

---

**HPOS în WooCommerce: ce este și cum verifici dacă pluginurile tale sunt compatibile**

HPOS în WooCommerce explicat simplu: ce schimbă, cum verifici pluginurile incompatibile și cum treci în siguranță la stocarea comenzilor în tabele dedicate.

![Stocarea comenzilor în HPOS conectată la pluginuri, cu indicatori de compatibilitate și un plugin care necesită verificare.](https://maxdev.ro/assets/content/articles/hpos-woocommerce-compatibilitate-pluginuri/hero-0c432e4a.webp)

HPOS este prescurtarea de la High-Performance Order Storage, noul mod în care WooCommerce își păstrează comenzile: într-un set de tabele dedicate, în loc de tabelele generale ale WordPress. Dacă vinzi cu WooCommerce, ai văzut probabil măcar o dată mesajul „acest plugin nu este compatibil cu HPOS” și te-ai întrebat dacă trebuie să faci ceva. Răspunsul scurt este că trebuie să știi ce înseamnă, pentru că un plugin incompatibil poate bloca activarea HPOS sau, mai rău, poate citi și scrie comenzile în locul greșit.

Ghidul explică ce schimbă HPOS, cum verifici compatibilitatea pluginurilor, cum treci în siguranță la noul mod de stocare și ce trebuie să respecte codul propriu, dacă ai pluginuri scrise la comandă.

**Pe scurt:** HPOS mută comenzile din `wp_posts` și `wp_postmeta` în tabele proprii, făcute pentru comenzi. Se activează din WooCommerce, Setări, Avansat, Funcționalități, iar aceeași pagină îți arată pluginurile incompatibile. Un plugin este compatibil dacă accesează comenzile prin API-ul WooCommerce (`wc_get_order`, `$order->get_meta()`), nu direct din baza de date.

## Ce este HPOS și ce schimbă

La începuturile WooCommerce, comenzile s-au salvat ca înregistrări de tip „post” în tabelul `wp_posts`, iar datele lor (adresa, totalul, metoda de plată) în `wp_postmeta`. Era o soluție rapidă de implementat, dar are o limită: aceleași tabele găzduiesc paginile, articolele, produsele și comenzile, iar un magazin cu mii de comenzi îi încarcă în mod nepotrivit.

HPOS înlocuiește această structură cu tabele dedicate (printre ele `wc_orders`, `wc_order_addresses`, `wc_order_operational_data` și `wc_orders_meta`), proiectate pentru interogări pe comenzi. Beneficiile oficiale sunt interogări mai simple, mai puțină încărcare pe tabelul general de conținut și o bază mai bună pentru volume mari. Pentru un magazin mic efectul poate să nu se simtă în viteză, iar noi nu promitem cifre: beneficiul real este că ai o arhitectură pe care WooCommerce o dezvoltă în continuare.

HPOS este implicit pentru magazinele noi în versiunile recente de WooCommerce. Magazinele mai vechi au încă stocarea clasică, până când o schimbi tu.

## Cum verifici ce stocare folosești

În admin, deschide WooCommerce, apoi Setări, Avansat, Funcționalități (Features). Secțiunea „Stocarea datelor comenzilor” arată două opțiuni: stocarea clasică, prin posturări WordPress, și stocarea de mare performanță, adică HPOS. Tot acolo există o opțiune de mod de compatibilitate, care sincronizează comenzile în ambele locuri pe durata tranziției, și o listă cu pluginurile pe care WooCommerce le consideră incompatibile cu HPOS.

## Cum verifici dacă pluginurile tale sunt compatibile

Un plugin declară compatibilitatea în cod, printr-un apel către WooCommerce în momentul încărcării. Dacă pluginul nu face acest apel, WooCommerce îl tratează ca necunoscut. Pașii de verificare sunt:

1. Deschide pagina Funcționalități și citește lista de pluginuri incompatibile.
2. Pentru fiecare plugin care atinge comenzile (facturare, livrare, plată, export), verifică pagina lui sau documentația pentru mențiunea „HPOS compatible”.
3. Dacă un plugin nu declară compatibilitatea, scrie dezvoltatorului și cere o dată de lansare.
4. Testează pe staging fluxul real al pluginului, nu doar activarea: generează o factură, un AWB, o rambursare.

Pluginul nostru [MaxDev Facturare cu ANAF](https://maxdev.ro/blog/completare-automata-date-firma-cui-woocommerce/) salvează datele de facturare prin API-ul WooCommerce și declară compatibilitatea cu HPOS, exact pentru ca datele clientului să rămână corecte indiferent de modul de stocare ales.

## Cum treci în siguranță la HPOS

Trecerea se face în pași, iar ordinea contează:

1. **Backup complet** al bazei de date și al fișierelor.
2. **Staging:** copiază magazinul și fă toată tranziția acolo mai întâi.
3. **Activează modul de compatibilitate**, ca să se sincronizeze datele în ambele sisteme.
4. **Lasă sincronizarea să se termine** și verifică că numărul de comenzi coincide între cele două locuri.
5. **Alege HPOS ca stocare principală** și testează comenzi noi, cu fiecare metodă de plată și de livrare.
6. **Păstrează compatibilitatea activă** încă o perioadă, ca să poți reveni fără pierderi.
7. **Oprește sincronizarea** abia când ești sigur că totul merge, apoi rulează testele finale.

Dacă magazinul folosește și checkout cu blocuri sau îl migrezi în același timp, nu face ambele schimbări împreună: așa cum e descris în ghidul despre [checkout cu blocuri sau clasic](https://maxdev.ro/blog/checkout-blocks-sau-checkout-clasic-woocommerce/), fiecare schimbare merită testată separat, ca să știi care a produs o eventuală problemă.

## Ce trebuie să respecte codul tău

Dacă ai pluginuri sau cod personalizat care lucrează cu comenzi, regula este una: nu citi și nu scrie comenzile direct în baza de date, ci prin API-ul WooCommerce.

| Nu folosi | Folosește |
| --- | --- |
| get_post_meta( $order_id, ... ) | $order->get_meta( ... ) |
| update_post_meta( $order_id, ... ) | $order->update_meta_data( ... ) urmat de $order->save() |
| get_post( $order_id ) | wc_get_order( $order_id ) |
| WP_Query cu post_type shop_order | wc_get_orders( $args ) |
| Interogări SQL pe $wpdb->posts | Metodele WooCommerce sau tabelele HPOS prin API |

Pluginul trebuie să și declare compatibilitatea, la acțiunea `before_woocommerce_init`:

```php
add_action( 'before_woocommerce_init', function () {
    if ( class_exists( \Automattic\WooCommerce\Utilities\FeaturesUtil::class ) ) {
        \Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility(
            'custom_order_tables',
            __FILE__,
            true
        );
    }
} );
```

Declarația nu înlocuiește testele. Un plugin care declară compatibilitatea, dar folosește încă `get_post_meta` pe comenzi, va funcționa doar atunci când modul de compatibilitate e activ.

## Probleme frecvente după activare

- **Facturi sau AWB-uri care nu se mai generează.** Un plugin citește comanda din locul vechi, iar comanda nouă există doar în tabelele HPOS.
- **Exporturi goale sau incomplete.** Rapoartele scrise direct pe `wp_posts` nu mai văd comenzile noi.
- **Meta datele lipsesc.** Datele salvate prin `update_post_meta` nu apar în HPOS decât în modul de compatibilitate.
- **Rapoartele din alte tool-uri diferă.** Integrările cu programe de contabilitate sau de logistică trebuie testate după schimbare. Dacă ai o [integrare API](https://maxdev.ro/servicii/integrare-api/) construită la comandă, verific-o înainte, nu după.

## Cine ar trebui să activeze HPOS acum

Magazinele noi îl au deja. Magazinele existente, cu pluginuri cunoscute și compatibile, pot trece oricând, cu pașii de mai sus. Cele cu multe pluginuri la comandă sau cu integrări ERP, curieri și facturare ar trebui să-și facă întâi un audit al codului, iar dacă nu ai o echipă tehnică internă, un [serviciu de mentenanță WordPress](https://maxdev.ro/servicii/mentenanta-administrare-wordpress/) poate face tranziția și monitorizarea de după.

## Întrebări frecvente

### Ce se întâmplă cu comenzile vechi dacă activez HPOS?

Se copiază în tabelele noi prin sincronizare, iar cele vechi rămân în locul lor atunci cât modul de compatibilitate e activ. Nu se șterge nimic automat.

### Pot reveni la stocarea clasică?

Da, dacă ai păstrat sincronizarea activă și datele sunt la zi în ambele locuri. De aceea nu opri sincronizarea imediat.

### HPOS face magazinul mai rapid?

Poate ajuta la volume mari de comenzi, dar nu garantăm o viteză anume. Măsoară înainte și după, nu presupune.

### Un plugin fără declarație de compatibilitate nu funcționează?

Poate funcționa, dar WooCommerce îl consideră necunoscut. Testează-l pe staging înainte să treci magazinul pe HPOS.

### Trebuie să migrez și checkout-ul pe blocuri ca să folosesc HPOS?

Nu. HPOS și checkout-ul cu blocuri sunt două schimbări independente: poți folosi HPOS cu checkout clasic.

Dacă vrei să verificăm împreună magazinul înainte de trecerea pe HPOS, vezi cum lucrăm la [dezvoltarea WooCommerce](https://maxdev.ro/servicii/woocommerce-development/).

## Servicii conexe

- [Dezvoltare WooCommerce custom](https://maxdev.ro/servicii/woocommerce-development/)
- [Mentenanță și administrare WordPress](https://maxdev.ro/servicii/mentenanta-administrare-wordpress/)

## Citește și

E-commerce

### [Unde pierd bani magazinele WooCommerce, de la produs la checkout](https://maxdev.ro/blog/unde-pierd-bani-magazinele-woocommerce-produs-checkout/)

Ideile principale din prezentarea de la WordPress Meetup București: ce lipsește din pagina de produs, coș, checkout și pagina de mulțumire, plus un audit live pe un magazin real.

8 octombrie 2026 · 6 min de citit

E-commerce

### [Checkout Blocks sau checkout clasic în WooCommerce: ce se schimbă pentru câmpurile românești](https://maxdev.ro/blog/checkout-blocks-sau-checkout-clasic-woocommerce/)

Checkout cu blocuri sau clasic în WooCommerce: cum afli ce folosești, ce se strică la migrare și cum îți adaptezi câmpurile pentru CUI, județ și localitate.

6 octombrie 2026 · 7 min de citit

E-commerce

### [Persoană fizică sau juridică la checkout: ce câmpuri ceri și cum le validezi (CNP, CUI, IBAN)](https://maxdev.ro/blog/checkout-persoana-fizica-juridica-woocommerce/)

Cum faci checkout-ul WooCommerce pentru persoane fizice și firme: ce câmpuri ceri, cum validezi CNP, CUI și IBAN și ce date nu merită să ceri degeaba.

6 octombrie 2026 · 9 min de citit

---

## Contact

- Telefon: +40 735 343 355
- Email: contact@maxdev.ro
- WhatsApp: https://wa.me/40735343355
- Programează o discuție: https://cal.com/daniel.maxdev
- Adresă: Bd. Theodor Pallady 66A, Sector 3, București
