WP Manifestindependent plugin directory
manifest / ecommerce / wp-simple-stock-checkout

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

0stars
0forks

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.zip

WP 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_total
    • stock_reserved
    • stock_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ó

  1. Copia la carpeta wp-simple-stock-checkout a wp-content/plugins/
  2. Activa el plugin des del panell d'administració
  3. 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.