WP Manifestindependent plugin directory
manifest / ecommerce / oxysuppliers-for-woocommerce

OxySuppliers – Suppliers & Purchase Orders for WooCommerce

Know what to reorder, from which supplier and how much. Suppliers, purchase orders, goods receipts and stock updates, inside WooCommerce.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/morfeoit/oxysuppliers-for-woocommerce/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Ciclo di approvvigionamento nativo dentro WooCommerce: anagrafica fornitori, associazione prodotto-fornitore, fabbisogni, ordini di acquisto, PDF, invio al fornitore, ricezione merce e aggiornamento di stock e costi.

Risponde a una domanda sola: cosa devo ordinare, a quale fornitore e in quale quantità?

Identità tecnica (bloccata)

Slug / text domain oxysuppliers-for-woocommerce
Namespace PHP Oxysoft\OxySuppliers
Prefisso (tabelle, opzioni, hook, capability, cron) oxysuppliers_
Costanti OXYSUPPLIERS_
REST /wp-json/oxysuppliers/v1/
Lingua del codice e delle stringhe inglese; l'italiano è una traduzione (languages/)

Mai oxy_: è troppo corto, si confonde con l'ecosistema Oxygen Builder e collide con gli altri plugin della famiglia. La specifica originale (docs/00_SPEC_ORIGINALE.md) usa oxy_: è stata corretta ovunque nei documenti di progetto.

Famiglia

Fa parte di OxyWP insieme a OxyProfit, OxyArea, OxyWait e Easy Mobile Product Upload. Nessun dominio dedicato: la pagina prodotto vive su oxywp.com/plugins/oxysuppliers-for-woocommerce/.

Due plugin separati, due repository:

  • oxysuppliers-for-woocommerce — FREE, privato oggi, pubblico al rilascio;
  • oxysuppliers-for-woocommerce-pro — PRO, privato sempre.

Nel FREE non deve esistere codice PRO dormiente sbloccato da una licenza: è la linea guida 5 di WordPress.org sul trialware.

Documenti

File Cosa contiene
docs/00_SPEC_ORIGINALE.md la specifica di partenza, com'è arrivata
docs/00_NAMING_CLEARANCE.md verifica del nome e rischio marchio
docs/01_ARCHITETTURA.md strati, dipendenze, regole di scrittura
docs/02_MODELLO_DATI.md tabelle, indici, migrazioni
docs/03_FREE_VS_PRO.md confine commerciale e tecnico fra i due plugin
docs/04_SICUREZZA.md capability, nonce, race condition, integrità stock
docs/05_INTEGRAZIONE_OXYPROFIT.md come il costo arriva a OxyProfit
docs/06_PIANO_TEST.md banco di prova e cosa si prova dove
docs/07_PIANO_SPRINT.md gli otto sprint e i criteri di uscita

Stato

13/08/2026 — Sprint 1, 2, 3 e 4 chiusi, verdi in CI e provati su un negozio vero.

Sprint 1 fondamenta, otto tabelle, capability, anagrafica fornitori, audit log
Sprint 2 listini prodotto-fornitore, arrotondamento delle quantità, fornitore preferenziale, pannello sulla scheda prodotto
Sprint 3 schermata dei fabbisogni, vendite 7/30/90, merce in arrivo, esportazione CSV
Sprint 4 ordini fornitore, numerazione unica, macchina a stati, proposte raggruppate per fornitore
Sprint 5 PDF dell'ordine con template sovrascrivibile, invio al fornitore, storia dell'ordine
Sprint 6 ricezioni totali, parziali e per riga; quattro difese contro la doppia ricezione; annullamento come movimento inverso
Prove 89 unit su PHP 8.1→8.4, 74 dentro WordPress 7.0.4, 93 via HTTP, 115 sul negozio seminato
Qualità PHPCS, PHPStan livello 8 e Plugin Check puliti
Pacchetto ~11 MB, di cui 8 sono Dompdf e i suoi font

Due numeri che vale la pena tenere d'occhio: la schermata dei fabbisogni costa sette query, che siano cinque righe o duecento, e due ordini salvati nello stesso istante ottengono due numeri diversi, perché a deciderlo è l'indice unico e non un contatore.

Banco di prova: https://test.44123.it/oxysuppliers (WooCommerce 11, HPOS attivo). Deploy con scripts\deploy-test-site.ps1.

Prossimo passo: Sprint 7 (merce in arrivo sul prodotto, report, REST, import CSV) e Sprint 8 (prontezza al rilascio).

Come si costruisce il pacchetto

bash scripts/build-package.sh

Quello che si distribuisce è quello che produce git archive (quindi le regole export-ignore in .gitattributes sono la distinta) più l'unica dipendenza di runtime, installata lì e non tenuta nel repository. Va eseguito su Linux: Compress-Archive di PowerShell scrive i separatori con la barra rovescia e WordPress si ritrova un file solo chiamato plugin\src\Plugin.php.