# Configurare WooCommerce su KapsuleHost

Source: https://support.kapsulehost.com/it-it/wordpress-woocommerce

KapsuleHost dispone di un tipo di sito WooCommerce dedicato che installa WordPress, WooCommerce e una serie di gateway di pagamento neozelandesi, aggiungendo poi strumenti specifici per il negozio al menu del sito. Questa guida illustra come creare il negozio, collegare i pagamenti, le impostazioni rilevanti per un negozio sotto carico e come apportare modifiche senza perdere ordini.

## Creazione di un Sito WooCommerce

1. Accedi a [KPanel](https://kpanel.kapsulehost.com) e clicca su **Siti web** nella barra laterale sinistra.
2. Clicca su **Aggiungi Sito Web**, poi su **Nuovo Sito Web**.
3. Scegli **WooCommerce** come tipo di sito.
4. Assegna un nome al negozio e completa la procedura guidata.

KapsuleHost crea l'installazione di WordPress, crea il database, installa e attiva WooCommerce e preinstalla i plugin dei gateway di pagamento elencati di seguito. Come runtime viene impostato PHP 8.3, con le estensioni necessarie a un negozio, inclusa la gestione delle immagini.

Se hai già un sito WordPress e vuoi aggiungervi un negozio, installa WooCommerce nel modo consueto da **Plugins**, poi **Add New** in wp-admin. Il sito mantiene il suo tipo di sito WordPress, il che significa che le schede specifiche per il negozio descritte qui non compariranno.

> **Note:** Stai migrando un negozio esistente anziché partire da zero? Non ricostruirlo manualmente. Usa **Migrazioni** nella barra laterale sinistra, che copia file e database mentre il tuo negozio attuale resta online per tutto il tempo. Vedi [Migrazione di un sito web da cPanel](https://support.kapsulehost.com/it-it/sites-migrate-cpanel).

## Gateway di Pagamento

Apri il negozio, poi la scheda **WordPress**, poi **Pagamenti**. Questa è una scheda esclusiva di WooCommerce e non compare sui normali siti WordPress.

![Pannello dei gateway di pagamento per un negozio WooCommerce](https://support.kapsulehost.com/help/screenshots/wordpress-woocommerce.475328e2.webp)

Sono trattati cinque gateway, con quelli rilevanti per la Nuova Zelanda contrassegnati:

| Gateway | Copre | Stato su un nuovo negozio |
|---|---|---|
| Stripe | Carte, Apple Pay e Google Pay | Preinstallato, inattivo |
| Afterpay | Compra ora, paga dopo | Preinstallato, inattivo |
| POLi | Bonifico bancario neozelandese | Preinstallato, inattivo |
| PayPal | PayPal e carte | Preinstallato, inattivo |
| Windcave | Elaborazione carte neozelandese ed EFTPOS | Disponibile, da installare dal fornitore |

Apple Pay e Google Pay sono inclusi con Stripe: non c'è nulla di separato da installare per nessuno dei due.

I gateway vengono installati deliberatamente **inattivi**. Un gateway abilitato senza credenziali blocca il checkout, quindi nulla va online finché non fornisci i dettagli del tuo account merchant:

1. Clicca su **Enable** sul gateway che utilizzi.
2. Clicca su **Configure**, che apre le impostazioni di quel gateway all'interno di wp-admin.
3. Inserisci le tue chiavi API o credenziali merchant e salva.
4. Effettua un ordine di prova prima di annunciare il negozio.

Windcave è distribuito dal fornitore anziché dalla directory dei plugin, quindi il pannello mostra un link **Ottieni il plugin**. Scaricalo, caricalo da **Plugins**, poi **Add New** in wp-admin, quindi torna qui per configurarlo.

> **Note:** La scheda **Pagamenti** fa parte di Managed WooCommerce. Sugli altri piani mostra invece un pannello di upgrade. Puoi comunque installare e configurare qualsiasi gateway direttamente in wp-admin su qualunque piano: la scheda è una scorciatoia, non l'unica via.

## Prestazioni del Negozio

Un negozio esegue molto più lavoro sul database per ogni visualizzazione di pagina rispetto a un sito vetrina, quindi è nella cache che si ottengono i maggiori vantaggi.

**Cache dell'intera pagina.** Nella scheda **WordPress** del sito, poi **Cache**, la cache dell'intera pagina serve l'HTML già pronto ai visitatori anonimi senza eseguire PHP né toccare il database. Il carrello, il checkout, le pagine my-account e gli endpoint AJAX di WooCommerce vengono esclusi automaticamente, e a qualsiasi visitatore con un cookie di carrello attivo viene sempre servita una pagina generata al momento. La cache velocizza le pagine di prodotto e categoria senza mai mostrare a un cliente il carrello di un altro cliente.

**Cache degli oggetti.** Nella stessa schermata, la cache degli oggetti mantiene in memoria i risultati delle query al database e i transient. È questa a rendere utilizzabile l'area amministrativa di WooCommerce su un catalogo di grandi dimensioni.

**CDN.** Attivala da **Prestazioni**, poi **Kapsule CDN** per servire immagini di prodotto e risorse statiche dall'edge, con ottimizzazione delle immagini e conversione in WebP sui piani con Kapsule CDN+. Vedi [Attivare la CDN](https://support.kapsulehost.com/it-it/cdn-enabling). Svuotala dopo una modifica massiva alle immagini dei prodotti: [Svuotare la cache della CDN](https://support.kapsulehost.com/it-it/cdn-cache-purge).

> **Tip:** La cache dell'intera pagina e la cache degli oggetti sono incluse con Managed WooCommerce. Se il tuo negozio è su un altro piano, la scheda Caching mostra cosa aggiunge l'upgrade. In entrambi i casi, attiva prima la CDN: è inclusa in ogni piano Web Hosting, WordPress, Managed WordPress, Managed WooCommerce e Concierge, ed è il miglioramento delle prestazioni più economico disponibile su un negozio ricco di immagini.

## Impostazioni PHP per un Negozio

I negozi sono il motivo più comune per abbandonare i valori predefiniti. Nella scheda **Impostazioni**, poi **PHP** del sito:

- **Limite di memoria**: aumentalo da 256M a 512M se il catalogo è ampio o se gestisci abbonamenti.
- **Tempo massimo di esecuzione**: aumentalo da 30 a 120 o 300 secondi se le importazioni di prodotti o la generazione di report vanno in timeout.
- **Variabili di input massime**: aumentale rispetto a 3000 se hai prodotti con molte varianti, o una schermata di impostazioni che scarta silenziosamente dei campi quando salvi.

I dettagli completi sono in [Aumentare il limite di memoria di WordPress](https://support.kapsulehost.com/it-it/wordpress-memory-limit).

## Attività Pianificate

WooCommerce esegue moltissime operazioni in background: transizioni di stato degli ordini, rinnovi degli abbonamenti, email, sincronizzazione dello stock. Utilizza lo scheduler integrato di WordPress, che per impostazione predefinita si attiva solo quando qualcuno visita il sito. Su un negozio poco frequentato questo significa che rinnovi ed email vengono eseguiti in ritardo o non vengono eseguiti affatto.

Sostituiscilo con una pianificazione reale lato server. La scheda **WordPress**, poi la sezione **WP-Cron** dispone di un'azione **Abilita cron di sistema** che aggiunge la pianificazione e disattiva la versione attivata dal visitatore nello stesso passaggio. La spiegazione completa e l'alternativa manuale si trovano in [Configurare e gestire i cron job](https://support.kapsulehost.com/it-it/cron-jobs).

Puoi monitorare la coda in **WooCommerce**, poi **Status**, poi **Scheduled Actions** in wp-admin.

## Apportare Modifiche Senza Perdere Ordini

Ogni negozio è un database attivo su cui i clienti scrivono continuamente, il che cambia il modo in cui dovresti gestire gli aggiornamenti.

> **Important:** Non effettuare mai il push di un database di staging su un negozio in produzione. Ordini, clienti, abbonamenti, coupon e livelli di stock risiedono tutti nel database, quindi un push del database elimina ogni ordine effettuato dopo l'ultimo reset dalla produzione. Esegui il push **solo file**, il che è sufficiente per modifiche a tema, plugin e codice. Vedi [Utilizzo dello staging: push e pull](https://support.kapsulehost.com/it-it/wordpress-staging-workflow).

Una routine di aggiornamento sicura per un negozio:

1. Esegui un backup: [Eseguire un backup](https://support.kapsulehost.com/it-it/taking-a-backup).
2. Resetta lo staging dalla produzione in modo che corrisponda al negozio live.
3. Applica gli aggiornamenti di plugin, tema o WooCommerce sullo staging.
4. Effettua un ordine di prova completo sullo staging, fino alla pagina di conferma.
5. Esegui il push **solo file** verso la produzione.
6. Effettua un piccolo ordine reale in produzione e rimborsalo.

Sui piani gestiti, l'azione **Aggiorna plugin** in **Azioni rapide** diventa **Aggiornamento intelligente**: esegue un backup, aggiorna un plugin alla volta, esegue un controllo di integrità del sito dopo ciascuno e ripristina automaticamente qualsiasi cosa comprometta il sito. Su un negozio in cui un checkout non funzionante costa denaro, questo vale la pena averlo.

## Ripristino Temporale

I backup giornalieri ripristinano un negozio allo stato in cui si trovava quando è stato eseguito quel backup, il che su un negozio molto frequentato può significare perdere un giorno di ordini. I siti WooCommerce possono abilitare il ripristino temporale da **Backup**, poi **Ripristino temporale**, e ripristinare a un minuto scelto, con una conservazione fino a 30 giorni. Su qualsiasi negozio che incassa denaro reale, attivalo. Vedi [Eseguire un backup](https://support.kapsulehost.com/it-it/taking-a-backup).

## Risoluzione dei Problemi

**Il checkout fallisce senza alcun errore.** Quasi sempre si tratta di un gateway abilitato con credenziali mancanti o errate. Disabilita i gateway uno alla volta dalla scheda **Pagamenti** finché il checkout non funziona, quindi riconfigura quello che l'ha compromesso.

**Le email degli ordini non arrivano.** WordPress invia la posta tramite PHP per impostazione predefinita e la maggior parte delle reti la rifiuta. Controlla l'avviso di consegna nella scheda **WordPress**, poi **Integrità del sito**, e configura un invio autenticato corretto.

**Le pagine di amministrazione sono lente o vanno in timeout.** Aumenta la memoria e il tempo di esecuzione nella scheda **PHP**, quindi attiva la cache degli oggetti. Un negozio con decine di migliaia di ordini beneficia anche della pulizia delle vecchie azioni pianificate.

**Le modifiche ai prodotti non compaiono sul front end.** Svuota la cache da **WordPress**, poi **Azioni rapide**, poi **Svuota cache**, e svuota anche la CDN.