WP Simple Stock Checkout
Simple WordPress plugin for limited stock management with external checkout (no WooCommerce).
by Adrià Canal · github.com/adriacanal/wp-simple-stock-checkout
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/adriacanal/wp-simple-stock-checkout/archive/refs/heads/main.zipWP Simple Stock Checkout és un plugin de WordPress per gestionar estoc limitat amb reserves temporals i pagament extern (TPV, Stripe, Redsys, Bizum, etc.) sense WooCommerce.
Pensat per a AFAs, escoles, associacions i entitats que necessiten vendre productes simples amb control d'estoc i una operativa clara.
✨ Funcionalitats principals
- Gestió de variants amb SKU
- Control d'estoc:
stock_totalstock_reservedstock_sold
- Reserves temporals atòmiques (evita sobreventa)
- Expiració automàtica de reserves (WP-Cron cada 5 minuts)
- Redirecció a passarel·la de pagament externa
- Conciliació de pagaments via CSV
- Vendes manuals (parades físiques) amb log d'estoc
- Activació / desactivació de variants
- Internacionalització (ca / es / en)
🚫 Què NO fa aquest plugin
Aquest plugin no és un e-commerce complet. Intencionadament:
- ❌ No té carret
- ❌ No gestiona enviaments
- ❌ No calcula impostos
- ❌ No processa pagaments directament
- ❌ No substitueix WooCommerce
Si necessites un e-commerce complet → WooCommerce.\ Si vols una solució lleugera i controlada → aquest plugin.
🧠 Model d'estoc
Per cada variant:
Disponible = stock_total - stock_sold - stock_reserved
⚙️ Requisits
- WordPress 6.7+
- PHP 8.0 -- 8.4
- MySQL / MariaDB
📦 Instal·lació
- Copia la carpeta
wp-simple-stock-checkoutawp-content/plugins/ - Activa el plugin des del panell d'administració
- Configura les opcions a
Stock Checkout → Settings
El plugin utilitza un autoloader PSR-4 intern i no requereix Composer en producció.
🌐 Frontend -- Pàgines necessàries
Pàgina de reserva
[wpssc_reserve success_page="/reserve/"]
Pàgina de finalització
[wpssc_reservation]
📦 Importació de variants (CSV)
Header esperat:
sku,model,color,size,price,stock_total,is_active
💳 Conciliació de pagaments (CSV)
Ruta: Stock Checkout → Payment reconciliation
Plantilla recomanada:
paid_at;amount;currency;token;reference;payer_email;notes
📁 Carpeta examples/
Inclou: - variants-sample.csv - payments-sample.csv
🌍 Traduccions
Inclou: - Català (ca) - Castellà (es) - Anglès (en)
Ubicació: languages/
Textdomain: wp-simple-stock-checkout
🤝 Contribucions
Les contribucions són benvingudes:
- issues
- pull requests
- millores de documentació
🔐 Seguretat
- Capability checks
- Nonces en accions admin
- Tokens UUID validats
- Transaccions SQL per reserves i pagaments
📄 Llicència
Vegeu el fitxer LICENSE per a més informació.
📄 Changelog
Vegeu el fitxer CHANGELOG.md per l’historial de versions.