Estensioni
WCPOS supporta estensioni che aggiungono nuove funzionalità al tuo punto vendita. La directory delle estensioni consente di sfogliare le estensioni disponibili, installarle direttamente dalle impostazioni POS e gestire gli aggiornamenti.
L'installazione e la gestione delle estensioni richiedono WCPOS Pro. La versione gratuita mostra il catalogo delle estensioni, ma disattiva i controlli di installazione e attivazione.
Estensioni disponibili
Gateway di pagamento
Gateway di checkout personalizzati progettati per l'uso POS in presenza.
Vuoi crearne uno personalizzato? Inizia dal modello di gateway — oppure consulta la panoramica dei gateway personalizzati per l'elenco completo.
Multilingua
Filtra i prodotti POS per lingua, in modo che i duplicati tradotti non compaiano nella ricerca del cassiere e nella griglia del catalogo.
Coupon e credito del negozio
Inventario
Sfogliare le estensioni
Apri la directory delle estensioni da POS Settings > Estensioni (indicata anche come Plugin in alcune versioni).
La directory mostra una griglia di schede con le estensioni disponibili. Ogni scheda mostra:
- Icona (o un fallback a forma di pezzo di puzzle se l'estensione non ne fornisce una)
- Nome e versione
- Descrizione
- Badge categoria
- Stato — attiva, inattiva, aggiornamento disponibile o non installata
Filtri e ricerca
Usare i pulsanti pillola delle categorie in alto per filtrare le estensioni per categoria. È inoltre possibile usare il campo di ricerca per trovare le estensioni per nome, descrizione o tag.
Installare un'estensione
- Aprire
POS Settings > Estensioni. - Trovare l'estensione desiderata e fare clic su Installa.
- L'estensione viene scaricata e installata tramite il programma di installazione dei plugin di WordPress.
- Una volta installata, fare clic su Attiva per abilitarla.
Dietro le quinte, WCPOS usa il Plugin_Upgrader nativo di WordPress per gestire l'installazione, quindi le estensioni seguono lo stesso processo di qualsiasi plugin WordPress.
Attivazione e disattivazione
Ogni estensione installata dispone dei pulsanti Attiva e Disattiva nella propria scheda.
- Attiva abilita l'estensione in modo che possa essere eseguita nel POS.
- Disattiva la disabilita senza disinstallarla. I file dell'estensione restano sul server e possono essere riattivati in qualsiasi momento.
Aggiornamento delle estensioni
Quando è disponibile una versione più recente di un'estensione installata, la scheda mostra un badge Aggiornamento disponibile e un pulsante Aggiorna.
Aggiornamenti automatici
Le estensioni installate dalla directory hanno gli aggiornamenti automatici abilitati per impostazione predefinita. È possibile attivare o disattivare gli aggiornamenti automatici per ogni estensione dalla sua scheda nella directory. Quando l'aggiornamento automatico è attivo, WordPress applicherà automaticamente le nuove versioni, proprio come fa per i plugin con gli aggiornamenti automatici abilitati.
Risoluzione dei problemi
Messaggio "Richiede Pro" sui pulsanti
I pulsanti di installazione, attivazione e aggiornamento sono disabilitati nella versione gratuita di WCPOS. Passa a WCPOS Pro per gestire le estensioni.
L'estensione non si installa
- Verificare che il server WordPress disponga dei permessi di scrittura per la directory
wp-content/plugins. - Verificare che il server possa effettuare richieste HTTPS in uscita (alcuni provider bloccano i download esterni).
- Controllare i dettagli dell'errore in
WP Admin > POS > Supporto > Log.
L'estensione non compare dopo l'installazione
- Aggiornare il POS: l'elenco delle estensioni viene memorizzato nella cache per un massimo di 12 ore.
- Confermare che l'estensione sia attivata (le estensioni installate ma inattive non vengono eseguite).
Il catalogo non si carica
Il catalogo delle estensioni viene recuperato da un'origine remota e memorizzato localmente nella cache per 12 ore. Se il catalogo non si carica:
- Verificare la connettività Internet del server.
- Riprovare dopo la scadenza della cache oppure cancellare la cache dei transient del server.
Per sviluppatori
Creare un'estensione POS
Un'estensione WCPOS è un plugin WordPress standard che si integra con il POS tramite hook e API WCPOS. Per crearne una:
- Inizia con un plugin WordPress. L'estensione richiede un'intestazione plugin standard e un file di ingresso, proprio come qualsiasi plugin WooCommerce o WordPress.
- Integra con WCPOS. Usa gli hook e i filtri forniti da WCPOS per aggiungere funzionalità all'interfaccia POS o al backend.
- Ospita le release su GitHub. La directory delle estensioni usa GitHub Releases per tenere traccia delle versioni e distribuire gli aggiornamenti.
Invio alla directory
Il catalogo delle estensioni è mantenuto nel repository GitHub wcpos/extensions. Per elencare la tua estensione:
- Consulta il formato del catalogo e i requisiti dei metadati nel README del repository.
- Apri una pull request per aggiungere i metadati della tua estensione a
catalog.json. - Una volta effettuato il merge, la tua estensione apparirà nella directory per tutti gli utenti WCPOS Pro.
Convenzioni per le release GitHub
Il ciclo di vita degli aggiornamenti si basa su GitHub Releases:
- Assegna tag alle versioni usando il versionamento semantico (ad es.,
v1.0.0,v1.2.3). - Allega il file zip del plugin come asset della release — questo è il file che viene scaricato quando un utente installa o aggiorna.
- Pubblica la release (non come bozza) in modo che la directory possa rilevarla.
Quando pubblichi una nuova release, gli utenti che hanno installato la tua estensione vedranno l'aggiornamento disponibile nella loro directory delle estensioni. Se l'aggiornamento automatico è abilitato, verrà applicato automaticamente.
Per tutti i dettagli sullo schema del catalogo e sul processo di invio, consulta il repository wcpos/extensions.