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

Funzionalità Pro

L'installazione e la gestione delle estensioni richiedono [WCPOS Pro](/it/getting-started/pro-license.md). La versione gratuita mostra il catalogo delle estensioni, ma disattiva i controlli di installazione e attivazione.

## Estensioni disponibili[​](#available-extensions "Collegamento diretto a Estensioni disponibili")

### Gateway di pagamento[​](#payment-gateways "Collegamento diretto a Gateway di pagamento")

Gateway di checkout personalizzati progettati per l'uso POS in presenza.

[Terminale StripePagamenti con carta in presenza su hardware Stripe Terminal (S700, WisePOS E). Supporta MOTO e la modalità simulatore.](/it/payment/gateways/stripe-terminal.md)

[Terminale SumUpAccetta pagamenti con carta tramite i lettori di carte SumUp.](/it/payment/gateways/sumup-terminal.md)

[Pagamenti Vipps MobilePayPagamenti da telefono tramite codice QR o notifica push. Vipps (Norvegia), MobilePay (Danimarca, Finlandia).](/it/payment/gateways/vipps-mobilepay.md)

[Fattura via emailInvia al cliente via email un link di pagamento per saldare l'ordine online.](/it/payment/gateways/email-invoice.md)

Vuoi crearne uno personalizzato? Inizia dal [modello di gateway](/it/reference/gateway-template.md) — oppure consulta la [panoramica dei gateway personalizzati](/it/payment/gateways/.md) per l'elenco completo.

### Multilingua[​](#multilingual "Collegamento diretto a Multilingua")

Filtra i prodotti POS per lingua, in modo che i duplicati tradotti non compaiano nella ricerca del cassiere e nella griglia del catalogo.

[Integrazione WCPOS PolylangIntegrazione Polylang — sincronizzazione dei prodotti in base alla lingua e selezione della lingua per negozio per WCPOS Pro.](/it/extensions/polylang.md)

[Integrazione WCPOS WPMLIntegrazione WPML: filtra i prodotti POS in una sola lingua.](/it/extensions/wpml.md)

[Integrazione WCPOS WP MultilangIntegrazione WP Multilang: filtra i prodotti POS in una sola lingua.](/it/extensions/wp-multilang.md)

### Coupon e credito del negozio[​](#coupons-and-store-credit "Collegamento diretto a Coupon e credito del negozio")

[Integrazione WCPOS StoreApps Smart CouponsRiscatta il credito del negozio di StoreApps Smart Coupons in WCPOS, con etichette del saldo sulla ricevuta e cronologia di audit nelle note dell'ordine.](/it/extensions/storeapps-smart-coupons.md)

### Inventario[​](#inventory "Collegamento diretto a Inventario")

[Integrazione WCPOS ATUMCollega i negozi WCPOS Pro alle sedi ATUM Multi-Inventory per gestire scorte, prezzi e SKU per sede.](/it/extensions/atum.md)

## Sfogliare le estensioni[​](#browsing-extensions "Collegamento diretto a 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[​](#filtering-and-search "Collegamento diretto a 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[​](#installing-an-extension "Collegamento diretto a Installare un'estensione")

1. Aprire `POS Settings > Estensioni`.
2. Trovare l'estensione desiderata e fare clic su **Installa**.
3. L'estensione viene scaricata e installata tramite il programma di installazione dei plugin di WordPress.
4. 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[​](#activating-and-deactivating "Collegamento diretto a 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[​](#updating-extensions "Collegamento diretto a 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[​](#auto-updates "Collegamento diretto a 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[​](#troubleshooting "Collegamento diretto a Risoluzione dei problemi")

### Messaggio "Richiede Pro" sui pulsanti[​](#requires-pro-message-on-buttons "Collegamento diretto a Messaggio \"Richiede Pro\" sui pulsanti")

I pulsanti di installazione, attivazione e aggiornamento sono disabilitati nella versione gratuita di WCPOS. Passa a [WCPOS Pro](/it/getting-started/pro-license.md) per gestire le estensioni.

### L'estensione non si installa[​](#extension-fails-to-install "Collegamento diretto a 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[​](#extension-not-appearing-after-install "Collegamento diretto a 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[​](#catalog-not-loading "Collegamento diretto a 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[​](#for-developers "Collegamento diretto a Per sviluppatori")

### Creare un'estensione POS[​](#creating-a-pos-extension "Collegamento diretto a 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:

1. **Inizia con un plugin WordPress.** L'estensione richiede un'intestazione plugin standard e un file di ingresso, proprio come qualsiasi plugin WooCommerce o WordPress.
2. **Integra con WCPOS.** Usa gli hook e i filtri forniti da WCPOS per aggiungere funzionalità all'interfaccia POS o al backend.
3. **Ospita le release su GitHub.** La directory delle estensioni usa GitHub Releases per tenere traccia delle versioni e distribuire gli aggiornamenti.

### Invio alla directory[​](#submitting-to-the-directory "Collegamento diretto a Invio alla directory")

Il catalogo delle estensioni è mantenuto nel repository GitHub [`wcpos/extensions`](https://github.com/wcpos/extensions). Per elencare la tua estensione:

1. Consulta il formato del catalogo e i requisiti dei metadati nel README del repository.
2. Apri una pull request per aggiungere i metadati della tua estensione a `catalog.json`.
3. Una volta effettuato il merge, la tua estensione apparirà nella directory per tutti gli utenti WCPOS Pro.

### Convenzioni per le release GitHub[​](#github-release-conventions "Collegamento diretto a 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`](https://github.com/wcpos/extensions).