Se hai letto la mia guida generale alla gestione dei bot AI su WordPress, sai che il tema è caldo. Quello che mancava era l'angolo WooCommerce-specific: cosa cambia quando il sito ha un carrello, transient di sessione, HPOS e una logica di checkout che non può essere rallentata neanche di 200ms. Questo articolo chiude quel gap.

Perché WooCommerce è diverso dai blog

I crawler AI trattano qualsiasi URL come candidabile. Su un blog questo significa decine di richieste al minuto; su WooCommerce significa richieste contro endpoint che hanno effetti collaterali concreti sul database e sulla cache.

I tre endpoint WooCommerce che i bot adorano

1. WPGUTENBERGBLOCKPLACEHOLDER0X e WPGUTENBERGBLOCKPLACEHOLDER1X: pagine prodotto. Su un catalogo medio di 3.000 articoli, ogni crawler scarica 3.000+ pagine. Ogni pagina esegue una query principale WP_Query, secondarie per tassonomie, e - se hai abilitato la cache oggetto - letture da Redis. Sono lente, non catastrofiche, ma si sommano.
2. WPGUTENBERGBLOCKPLACEHOLDER0X e WPGUTENBERGBLOCKPLACEHOLDER1X: pagine carrello. Queste sono il problema vero. WooCommerce esegue WC()->session->get_customer_data(), legge i transient wc_cart_hash, valuta coupon, e calcola totali. Una singola richiesta bot a /cart/ non fa danni, ma 10 crawler che chiamano /cart/ ogni 30 secondi generano 28.800 sessioni al giorno, ognuna con il proprio record in woocommerce_sessions.
3. WPGUTENBERGBLOCKPLACEHOLDER0X e WPGUTENBERGBLOCKPLACEHOLDER1X: endpoint autenticabili. Ancora peggio, perché qui le capability check WordPress vengono combinate con i check WooCommerce. I bot che arrivano qui non comprano, ma riscaldano processi PHP che dovrebbero essere freddi fino a quando un cliente reale non arriva.

Il caso studio reale

Il cliente di cui sopra aveva 3.000 articoli, hosting managed Kinsta, Redis attivo, Cloudflare davanti. Risultato dell'analisi:

• CPU media del container PHP: 75% con picchi al 95% durante le ore dei bot (quelle asiatiche notturne e americane diurne)
• Banda mensile: 412GB di cui 248GB (60%) attribuibili a bot AI identificati
• Transazione di checkout reali: 85 al giorno, con tempo medio di risposta 1,8s, di cui 0,9s spesi in operazioni preliminari che non avrebbero dovuto essere attivate
• Costo hosting: +340€ al mese per gestire traffico non convertente

Dopo la strategia 4 livelli che descrivo qui sotto: CPU 25%, banda -40%, checkout a 0,9s.

I 4 livelli di protezione WooCommerce-aware

Una strategia efficace non è "blocco totale" né "apertura totale", ma una serie di decisioni granulari basate su cosa fa WooCommerce e cosa no.

Livello 1: permessi robots.txt per AI bot

Il livello base è dichiarare cosa i bot possono e non possono indicizzare. WooCommerce ha una particolarità: le pagine carrello, checkout e account devono essere sempre vietate a tutti i bot (non solo AI), pena l'indicizzazione in Google di URL con parametri dinamici.

# robots.txt WooCommerce-aware
User-agent: *
Disallow: /cart/
Disallow: /checkout/
Disallow: /my-account/
Disallow: /?add-to-cart=
Disallow: /?s=
Disallow: /search/

# AI bot specifici: permettere solo pagine informative
User-agent: GPTBot
Allow: /
Disallow: /cart/
Disallow: /checkout/
Disallow: /my-account/
Disallow: /wp-admin/
Disallow: /wp-json/wc/

User-agent: ClaudeBot
Allow: /
Disallow: /cart/
Disallow: /checkout/
Disallow: /my-account/

User-agent: PerplexityBot
Allow: /
Disallow: /cart/
Disallow: /checkout/
Disallow: /my-account/

User-agent: CCBot
Disallow: /          # blocco totale: CCBot non porta conversioni

Nota: Disallow: /wp-json/wc/ impedisce ai bot di scaricare l'intero catalogo prodotti via REST API in pochi secondi. WooCommerce espone /wp-json/wc/v3/products con un rate limit proprio, ma i bot non lo rispettano sempre.

Livello 2: blocco granulare per user-agent e IP reputation

Il robots.txt è una dichiarazione di intenti, non un firewall. Per il blocco reale servono regole server-side. Ecco una configurazione Nginx pensata per WooCommerce.

# Blocca bot AI su endpoint WooCommerce sensibili
location ~ ^/(cart|checkout|my-account)(/|$) {
    if ($http_user_agent ~* "(GPTBot|ClaudeBot|CCBot|PerplexityBot|OAI-SearchBot|Amazonbot)") {
        return 403;
    }
}

# Blocca bot AI su REST API WooCommerce
location ~ ^/wp-json/wc/v[0-9]+/ {
    if ($http_user_agent ~* "(GPTBot|ClaudeBot|CCBot)") {
        return 403;
    }
}

# Limita rate su pagine prodotto per bot noti
location ~ ^/product/ {
    if ($http_user_agent ~* "(GPTBot|ClaudeBot|PerplexityBot)") {
        limit_req zone=ai_bots burst=10 nodelay;
    }
}

Per Apache, l'equivalente .htaccess:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} (GPTBot|ClaudeBot|CCBot|PerplexityBot|OAI-SearchBot|Amazonbot) [NC]
RewriteRule ^(cart|checkout|my-account) - [F,L]
</IfModule>

Livello 3: protezione a livello applicazione PHP

Per una protezione che vada oltre il semplice user-agent matching, agganciati al boot di WordPress e intercetta le richieste WooCommerce-aware.

add_action( 'init', 'wc_proteggi_da_bot_ai', 1 );
function wc_proteggi_da_bot_ai() {
    if ( ! class_exists( 'WooCommerce' ) ) {
        return;
    }
    $ua = $_SERVER['HTTP_USER_AGENT'] ?? '';
    $bot_ai_pattern = '/(GPTBot|ClaudeBot|CCBot|PerplexityBot|OAI-SearchBot|Amazonbot|Google-Extended|Bytespider)\b/i';
    if ( ! preg_match( $bot_ai_pattern, $ua ) ) {
        return;
    }
    $path = $_SERVER['REQUEST_URI'] ?? '';
    $endpoint_bloccati = array( '/cart', '/checkout', '/my-account', '/?add-to-cart' );
    foreach ( $endpoint_bloccati as $ep ) {
        if ( strpos( $path, $ep ) === 0 ) {
            status_header( 403 );
            nocache_headers();
            exit;
        }
    }
    // Log audit
    if ( defined( 'WP_DEBUG_LOG' ) && WP_DEBUG_LOG ) {
        error_log( sprintf( 'WC bot AI: %s path=%s', $ua, $path ) );
    }
}

Questo snippet è minimale ma efficace: agisce prima di WooCommerce, evitando di attivare sessioni, transient o query inutili. La priorità 1 sull'hook init è fondamentale: WooCommerce si aggancia a priorità 10, quindi arriviamo prima.

Livello 4: regole Cloudflare WAF (se usi Cloudflare)

Se il tuo WooCommerce sta dietro Cloudflare, il livello 4 è il più efficace in assoluto. Cloudflare WAF + Bot Fight Mode identifica i bot AI noti e li blocca a livello edge, prima ancora che tocchino il tuo server.

Configurazione consigliata nel pannello Cloudflare:

1. Security → Bots → Bot Fight Mode: ON. Blocca automaticamente i bot verificati come malevoli.
2. Security → WAF → Custom Rules: aggiungi una regola che blocca i bot AI su /cart/* e /checkout/* con sfida JS (non hard block, per evitare falsi positivi).
3. Caching → Configuration → Tiered Cache Topology: separa le pagine prodotto dai carrelli. Le pagine prodotto vanno in cache con regole aggressive, le pagine carrello bypass totale.
4. Speed → Optimization → Auto Minify: HTML, CSS, JS. WooCommerce spara 200KB di JS non minificato su /cart/.

Caso studio: e-commerce moda con 12.000 prodotti

Un e-commerce di abbigliamento con 12.000 SKU e 4 lingue, hosting SiteGround, Cloudflare free. Problema: TTFB pagina prodotto passato da 800ms a 2.4s in sei mesi, senza modifiche al codice.

Audit iniziale

# analisi log per user agent e path
grep -E "GET /(product|shop|cart|checkout)" access.log | awk '{print $12, $7}' | sort | uniq -c | sort -rn | head -30

Output tipico per questo profilo di sito:

18432 GPTBot /product/
 8421 ClaudeBot /product/
 3201 PerplexityBot /product/
  892 CCBot /wp-json/wc/v3/products
  441 Bytespider /cart/
  112 OAI-SearchBot /checkout/

Quasi la metà delle richieste a /product/ era di bot AI. Il sito aveva già noindex su carrello e checkout, ma i bot ignoravano il meta tag.

Intervento in 3 fasi

Fase 1 - robots.txt granulare: implementato il robots.txt del Livello 1 sopra, con differenziazione per bot. Risultato: -25% richieste bot in 48 ore (alcuni bot rispettano robots.txt, altri no).

Fase 2 - WAF custom rule Cloudflare: bloccati 6 bot AI su /cart/* e /checkout/* con JS challenge. Risultato: -90% richieste bot su endpoint sensibili.

Fase 3 - PHP guard: aggiunto lo snippet del Livello 3 per intercettare bot sfuggiti a Cloudflare. Risultato: blocco totale su carrello e checkout anche in caso di bypass del WAF.

Dopo 7 giorni: TTFB 850ms (vicino al baseline originale), CPU media 28% (era 71%), banda mensile -38%.

Configurazioni WooCommerce specifiche che aiutano

Alcune impostazioni WooCommerce riducono l'impatto dei bot senza toccare codice custom.

Disabilita la cache oggetto per le sessioni

// Non cachare le sessioni WC: sono un per-user data
add_filter( 'wc_session_use_redis', '__return_false' );

WooCommerce di default cacha anche le sessioni in Redis. Su un sito trafficato da bot, questo riempie Redis di sessioni anonime che non verranno mai completate. La sessione WC deve restare in MySQL o in un backend dedicato.

Abilita HPOS e riduci il carico transiente

High-Performance Order Storage (HPOS), attivo da WooCommerce 8.x, sposta gli ordini dalle tabelle postmeta a tabelle dedicate. Questo non blocca i bot, ma riduce drasticamente il carico di query durante un attacco bot: HPOS usa indici nativi e join efficienti, mentre le tabelle postmeta sono il collo di bottiglia classico di WooCommerce.

// verifica HPOS attivo
add_action( 'admin_notices', function() {
    if ( ! class_exists( 'Automattic\\WooCommerce\\Utilities\\FeaturesUtil' ) ) return;
    $hpos_enabled = 'yes' === get_option( 'woocommerce_custom_orders_table_enabled' );
    if ( ! $hpos_enabled ) {
        echo '<div class="notice notice-warning"><p>HPOS non attivo. Valuta di attivarlo per migliorare le performance sotto carico bot.</p></div>';
    }
} );

Pulisci transient orfani regolarmente

I bot che attivano carrelli anonimi generano transient wc_cart_hash_<session_id> che non vengono mai puliti. Una volta al giorno, un cron job deve rimuoverli.

add_action( 'wc_pulisci_transient_orfani', 'wc_pulisci_transient_orfani_handler' );
function wc_pulisci_transient_orfani_handler() {
    global $wpdb;
    $wpdb->query( "DELETE FROM {$wpdb->options} WHERE option_name LIKE '_transient_wc_cart_hash_%' AND option_name NOT LIKE '_transient_timeout_wc_cart_hash_%'" );
    $wpdb->query( "DELETE FROM {$wpdb->options} WHERE option_name LIKE '_transient_timeout_wc_cart_hash_%' AND option_value < UNIX_TIMESTAMP()" );
}
// schedula il cron se non esiste
if ( ! wp_next_scheduled( 'wc_pulisci_transient_orfani' ) ) {
    wp_schedule_event( time(), 'daily', 'wc_pulisci_transient_orfani' );
}

Test e monitoraggio continuo

Una strategia di protezione non è mai definitiva: i bot cambiano user-agent, Cloudflare aggiorna le regole, WooCommerce rilascia nuovi endpoint. Serve un monitoraggio.

Dashboard minimale con WP-CLI

# richieste bot AI ultime 24 ore per path
wp eval '
$log_file = WP_CONTENT_DIR . "/debug.log";
if ( ! file_exists( $log_file ) ) { echo "no log\n"; return; }
$lines = file( $log_file, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES );
$cutoff = time() - 86400;
$counts = array();
foreach ( $lines as $line ) {
    if ( strpos( $line, "WC bot AI" ) === false ) continue;
    $counts[ substr_count( $line, "/product/" ) ? "product" : ( substr_count( $line, "/cart/" ) ? "cart" : "other" ) ]++;
}
print_r( $counts );
'

Questo script va schedulato in cron con invio report via email o salvataggio in wp_options per trend settimanali.

Metriche di successo da tracciare

Tre numeri che metto in dashboard per ogni cliente WooCommerce con questo problema:

1. Rapporto richieste bot/umani: target < 3:1 (significato: 3 richieste bot per ogni umano reale)
2. TTFB pagina carrello: target < 500ms (sotto carico, non a freddo)
3. Dimensione tabella WPGUTENBERGBLOCKPLACEHOLDER0X: target < 50MB (se sale, hai transient orfani)

FAQ

I bot AI sono davvero un problema per WooCommerce o è esagerato?

Non è esagerato se il tuo e-commerce supera i 1.000 prodotti o se hai endpoint di checkout pesanti. Il problema non è il singolo bot, è l'effetto moltiplicatore: WooCommerce attiva operazioni di sessione e transient su ogni richiesta, e i bot fanno migliaia di richieste. Su un blog con 50 articoli il problema è trascurabile; su un e-commerce con 3.000+ SKU diventa strutturale.

Posso bloccare tutti i bot AI senza perdere visibilità?

Dipende dal tuo modello di business. Se vendi prodotti fisici, la risposta è sì: nessun utente ChatGPT comprerà mai un paio di scarpe. Se vendi software, SaaS o servizi, valuta: le citazioni AI possono portare conversioni indirette. La mia guida AEO WordPress spiega come diventare fonte citata senza subire l'impatto del crawler.

Cloudflare Bot Fight Mode basta da solo?

No, è un primo livello. Cloudflare identifica i bot noti con alta confidenza, ma i bot più sofisticati ruotano user-agent e usano residential proxy. La difesa in profondità - robots.txt, WAF, PHP guard - è l'unica che regge sotto attacco reale.

Come distinguo un bot AI da un bot SEO tradizionale?

Dalla stringa user-agent. I bot AI del 2026 hanno UA distintivi: GPTBot/1.0, ClaudeBot/1.0, PerplexityBot, CCBot, OAI-SearchBot, Amazonbot, Google-Extended, Bytespider, Applebot-Extended. Tieni una blocklist aggiornata: ogni mese escono nuovi bot, e Mozilla mantiene un repository di user-agent noti utile per il check.

Il blocco bot AI influenza la SEO tradizionale Google?

No. Googlebot ha user agent proprio e non è nella lista dei bot AI. Google-Extended è un bot separato che Google usa per Gemini: bloccarlo non pregiudica l'indicizzazione Google Search, ma impedisce a Gemini di usare i tuoi contenuti. È una scelta consapevole, non un effetto collaterale.

I bot AI rispettano robots.txt?

Alcuni sì, altri no. OpenAI dichiara che GPTBot rispetta robots.txt, ma nella pratica non sempre lo fa correttamente. ClaudeBot rispetta robots.txt in modo più rigoroso. CCBot (Common Crawl) spesso ignora le regole. Non fare affidamento solo sul robots.txt, usalo come dichiarazione di intenti e affianca blocchi server-side.

Cosa cambia con HPOS rispetto al carico dei bot?

HPOS non blocca i bot, ma riduce l'impatto delle loro richieste. Le tabelle ordini dedicate hanno indici efficienti e non si appoggiano al sistema postmeta, che è il vero collo di bottiglia di WooCommerce sotto carico. Su un e-commerce con HPOS attivo e bot bloccati, le performance restano stabili anche con tentativi di scraping massicci.

Conclusione operativa

WooCommerce non è un blog, e la protezione dai bot AI non può essere una copia-incolla delle regole generiche WordPress. Serve una strategia WooCommerce-aware a 4 livelli, con monitoraggio continuo e cleanup dei transient orfani. Il ROI è quasi sempre positivo entro il primo mese, anche per e-commerce di medie dimensioni.

Checklist operativa pre-produzione

• [ ] robots.txt con regole specifiche per /cart/, /checkout/, /my-account/, /wp-json/wc/
• [ ] WAF custom rule (Cloudflare o Nginx) per bloccare 6+ bot AI su endpoint sensibili
• [ ] PHP guard con priorità 1 su init per intercettare bot sfuggiti al WAF
• [ ] HPOS attivo su WooCommerce 8.x+
• [ ] Sessioni WC non cachate in Redis
• [ ] Cron giornaliero per pulizia transient orfani wc_cart_hash_*
• [ ] Dashboard con rapporto bot/umani, TTFB carrello, dimensione tabella sessioni
• [ ] Backup log audit dei bot bloccati per 30 giorni

Se tutti i punti sono verdi, il tuo WooCommerce è pronto a gestire il traffico bot AI del 2026 senza sacrificare le performance del checkout.

Riferimenti utili per approfondire

• AI bot traffic WordPress: gestire crawler AI nel 2026 - guida generale sui bot AI, da leggere prima di questo articolo
• AEO WordPress: come farsi citare da ChatGPT e Claude - l'altra faccia del problema: come essere fonte citata
• WooCommerce + AI per sviluppatori: schede prodotto e checkout - come usare AI per generare contenuti WooCommerce
• WooCommerce e AI: strategie per vendere di più - lato business, conversione AI-assisted
• Documentazione ufficiale WooCommerce HPOS - guida completa al nuovo storage ordini
• Repository Cloudflare WAF rules - reference per costruire regole custom
• Lista user-agent bot AI aggiornata 2026 - check periodico per nuovi bot
• Kinsta research: AI bot traffic findings - dati reali su 10 miliardi di richieste analizzate
• WordPress performance under bot load - articolo Kinsta sul caso WooCommerce specifico
• WordPress hardening 2026 - guida completa hardening che include protezione bot
• WooCommerce debugging avanzato - documentazione sviluppatore ufficiale
• GDPR compliance per log bot AI - come gestire i log in modo conforme

L'obiettivo è concreto: dare a uno sviluppatore WooCommerce le componenti, gli snippet e i pattern architetturali per integrare l'AI in modo sicuro, performante, e manutenibile. Niente teoria, niente hype, solo codice testato e pattern reali.

L'articolo si legge bene dopo la strategia WooCommerce AI per vendere di più, che ha coperto l'angolo marketing/business, dopo il metodo completo per creare plugin WordPress con AI, che è la base metodologica per il codice AI-generated in produzione, e dopo la panoramica sui 10 strumenti AI per sviluppatori WordPress nel 2026, che aiuta a scegliere la toolchain giusta per il progetto.

WooCommerce + AI: lo stato dell'arte nel 2026

L'integrazione tra WooCommerce e AI è maturata significativamente. I plugin AI-first per WooCommerce sono aumentati da 20 a oltre 200 nel repository ufficiale tra il 2024 e il 2026, e la qualità media è migliorata. Le aree di applicazione concrete sono quattro.

L'AI non è una bacchetta magica, ma in ognuna di queste aree produce risultati misurabili. Lo sviluppatore WooCommerce del 2026 deve saper integrare almeno le prime due: generazione contenuti e raccomandazioni. Le altre due sono spesso gestite da plugin commerciali, ma la conoscenza architetturale resta utile per personalizzazioni.

Generare schede prodotto in massa con AI

Il caso d'uso più richiesto: importare 500 prodotti da un CSV con titoli generici, e ottenere 500 descrizioni SEO-friendly, ottimizzate, non duplicate. Il workflow AI-assisted che uso si articola in 4 fasi.

Fase 1: arricchimento input con metadati

Un prodotto con solo il titolo non basta all'AI per generare una buona descrizione. Servono almeno: categoria, attributi, brand, tag, EAN/GTIN, e idealmente una breve descrizione del produttore. Per popolare questi metadati, l'AI può interrogare fonti esterne o, più realisticamente, puoi estrarli dal tuo database di origine con uno script PHP.

<?php
/**
 * Estrai metadati da un CSV e prepara array per arricchimento AI
 * Uso: wp eval-file prepara-prodotti.php
 */
$csv_path = '/tmp/prodotti.csv';
$rows = array_map(function($r) { return str_getcsv($r, ';'); }, file($csv_path));
$header = array_shift($rows);
$prodotti = [];
foreach ($rows as $r) {
    $prodotti[] = array_combine($header, $r);
}
// Salva in transient per il batch successivo
set_transient('woo_ai_batch_' . time(), $prodotti, HOUR_IN_SECONDS);
WP_CLI::success('Caricati ' . count($prodotti) . ' prodotti da CSV');

Questo script legge un CSV separato da ;, normalizza le intestazioni, e salva un transient con i prodotti. Il prossimo step consuma il transient e genera le descrizioni.

Fase 2: prompt design per generazione descrizioni

Il prompt deve essere strutturato, non un generico "scrivi una descrizione prodotto". Un prompt efficace per WooCommerce ha sei elementi: contesto prodotto, lunghezza, tono di voce, keyword SEO, formato output, e regole di non duplicazione.

# prompt template per generazione descrizione WooCommerce
Genera una descrizione prodotto per WooCommerce in italiano.

Contesto prodotto:
- Titolo: {titolo}
- Categoria: {categoria}
- Brand: {brand}
- Attributi chiave: {attributi}
- Target utente: {target}

Requisiti:
- Lunghezza: 150-200 parole
- Tono: professionale ma accessibile, terza persona
- Struttura: 1 paragrafo introduttivo + 1 lista benefici (3-5 punti) + 1 paragrafo di chiusura con CTA
- Keyword SEO: includi naturalmente "{keyword_principale}" 2-3 volte
- Non duplicare la descrizione di: {titoli_altri_prodotti_lotto}
- Non inventare specifiche tecniche non presenti negli attributi

Output: solo il testo della descrizione, pronto per il campo `post_content` di WordPress.

Le variabili {...} vengono popolate da un loop PHP che chiama l'API del modello scelto. L'AI eccelle in questo task: genera 500 descrizioni in 20-30 minuti, con qualità superiore a copywriter junior.

Fase 3: batch processing con rate limiting

Un batch di 500 prodotti non può essere processato in una singola chiamata. Servono batch più piccoli (20-50 prodotti), rate limiting (rispetto dei limiti API), retry logic, e logging. Il seguente script WP-CLI implementa un worker sicuro.

<?php
/**
 * Worker AI per generazione descrizioni prodotto WooCommerce
 * Uso: wp eval-file worker-descrizioni.php --batch=20
 */
$batch_size = (int) (getenv('BATCH_SIZE') ?: 20);
$transient_key = 'woo_ai_batch_' . getenv('BATCH_ID');
$prodotti = get_transient($transient_key);
if (!$prodotti) {
    WP_CLI::error('Transient non trovato: ' . $transient_key);
    return;
}
$processed = 0;
foreach (array_slice($prodotti, 0, $batch_size) as $p) {
    $prompt = build_prompt($p); // funzione di templating
    $descrizione = call_ai_api($prompt); // wrapper API con retry
    if ($descrizione && !duplicate_check($descrizione)) {
        aggiorna_prodotto($p['id'], $descrizione);
        $processed++;
    } else {
        WP_CLI::warning('Prodotto ' . $p['id'] . ' non aggiornato');
    }
    usleep(200000); // rate limiting: 5 req/sec
}
WP_CLI::success('Processati ' . $processed . ' prodotti');

Lo script è volutamente semplice. In produzione aggiungerei: logging strutturato, gestione errori API (rate limit 429, timeout, content filter), checkpoint per riprendere il batch dopo interruzioni, e un sistema di code (Action Scheduler o Redis) per elaborazioni asincrone.

Fase 4: review umana e fix di errori comuni

L'AI genera bene, ma non è perfetta. Gli errori tipici che trovi dopo la generazione batch sono cinque, tutti rilevabili con una review a campione del 10% dei prodotti.

• Specifiche inventate: l'AI talvolta aggiunge dettagli tecnici non presenti negli attributi. Soluzione: aggiungere regola "non inventare specifiche" al prompt.
• Keyword stuffing eccessivo: la keyword SEO ripetuta in modo innaturale. Soluzione: limite di occorrenze nel prompt (2-3 volte max).
• Descrizioni troppo simili tra prodotti simili: l'AI tende a copiare strutture. Soluzione: passare i titoli degli altri prodotti del lotto come anti-duplicazione.
• Tono incoerente: lo stesso brand riceve toni diversi. Soluzione: specificare esempi di tono nel prompt o fare fine-tuning.
• Lunghezza fuori target: l'AI genera descrizioni troppo lunghe o corte. Soluzione: range esplicito + conteggio parole nel post-processing.

Una review a campione del 10% cattura il 90% degli errori. Il restante 10% viene gestito in produzione con un sistema di feedback.

Ottimizzare il checkout WooCommerce con AI

Il checkout è il punto di friction più alto in un e-commerce. Ogni campo in più, ogni secondo in più di attesa, ogni passaggio poco chiaro aumenta il tasso di abbandono. L'AI può aiutare su tre fronti: analisi predittiva del rischio abbandono, suggerimenti contestuali, e copy dinamico dei campi.

Analisi predittiva del rischio abbandono

Un modello AI addestrato sui dati storici del tuo store può prevedere, in tempo reale, se un carrello sta per essere abbandonato. I segnali sono tanti: tempo di inattività, numero di campi compilati, frequenza di rimbalzo tra campi, totale carrello anomalo, device utilizzato.

Implementazione realistica: un endpoint REST custom che riceve i dati del carrello, li invia a un servizio ML (anche via API di un modello linguistico con un prompt di scoring), riceve uno score di rischio 0-100, e mostra un messaggio contestuale se lo score supera una soglia.

<?php
/**
 * Endpoint REST per predizione abbandono carrello
 * Path: /wp-json/woo-ai/v1/abbandono
 */
add_action('rest_api_init', function() {
    register_rest_route('woo-ai/v1', '/abbandono', [
        'methods' => 'POST',
        'callback' => 'gestisci_predizione_abbandono',
        'permission_callback' => function() {
            return is_user_logged_in() || wc_get_cart() !== null;
        },
    ]);
});

function gestisci_predizione_abbandono(WP_REST_Request $request) {
    $dati = $request->get_json_params();
    $prompt = costruisci_prompt_predizione($dati);
    $risposta = chiama_api_predizione($prompt);
    return new WP_REST_Response([
        'rischio' => $risposta['score'], // 0-100
        'messaggio' => $risposta['score'] > 70 ? suggerisci_intervento($dati) : null,
    ], 200);
}

Il messaggio contestuale può essere: sconto del 5% sul primo ordine se l'utente è nuovo, spedizione gratuita sopra una certa soglia, o un rassicuramento sulla sicurezza del pagamento. La logica di intervento è un A/B test continuo.

Suggerimenti contestuali e cross-sell

WooCommerce ha già un sistema nativo di cross-sell e up-sell. L'AI può migliorarlo: invece di regole statiche (prodotti correlati per categoria), usa un modello che suggerisce prodotti in base al comportamento dell'utente, al contenuto del carrello, e alla stagionalità.

L'integrazione concreta passa per il filtro woocommerce_related_products. Un plugin custom può:

• Sostituire la query prodotti correlati con una chiamata a un servizio di raccomandazione.
• Passare come input: prodotto corrente, carrello, storico utente, contesto temporale.
• Ricevere come output: lista di product ID raccomandati con score.
• Cachare il risultato per 1 ora per ridurre latenza e carico API.

Il guadagno misurato: aumento del 5-15% dell'AOV (Average Order Value) con un sistema di raccomandazioni AI-driven rispetto alle regole statiche WooCommerce.

Copy dinamico dei campi checkout

L'AI può generare copy contestuale per i campi checkout in base al paese, alla lingua, o al tipo di prodotto. Esempio: il campo "Note ordine" diventa "Hai bisogno di fattura? Specifica qui i dati" per utenti business, o "Note per il corriere" per utenti consumer. WooCommerce supporta nativamente la localizzazione del form, ma generare testi ottimizzati per ogni contesto è un task dove l'AI eccelle.

Integrare raccomandazioni intelligenti

Le raccomandazioni prodotto sono il caso d'uso AI con ROI più alto in WooCommerce. Le strategie principali sono tre: similarità prodotto, complemento carrello, e personalizzazione utente.

Per uno store con meno di 1000 prodotti, un approccio basato su embedding similarity (modello tipo text-embedding-3-small) è sufficiente. Si calcola l'embedding di ogni prodotto una volta, si cacha in un custom post type meta, e al momento del checkout si cercano i K prodotti più vicini. Costo: 0.02$ per 1000 embedding, quindi 20$ per ricalcolare l'intero catalogo di 1000 prodotti.

Per store più grandi (10.000+ prodotti) serve un servizio di raccomandazione dedicato (Algolia Recommend, AWS Personalize, Google Recommendations AI). L'integrazione con WooCommerce è documentata, ma il costo sale a 100-1000$/mese.

Plugin AI-native: cosa cercare e cosa evitare

Il repository WordPress ha oltre 200 plugin AI per WooCommerce. La qualità è molto variabile. Ecco i criteri che uso per valutare un plugin prima di installarlo su un sito in produzione.

Cosa cercare:

• Codice open source con history di commit recente (ultimi 6 mesi).
• Compatibilità dichiarata con l'ultima versione WooCommerce.
• API documentata per estensioni custom.
• Sistema di cache per evitare chiamate API ripetute.
• Rate limiting integrato per rispettare i limiti del provider AI.
• Sanitizzazione degli input e escape degli output (critico: l'AI riceve dati utente e genera contenuto HTML).

Cosa evitare:

• Plugin con aggiornamenti fermi da oltre 12 mesi.
• Plugin che richiedono credenziali API come super admin (rischio sicurezza).
• Plugin che modificano il database WooCommerce con tabelle custom non standard (rende impossibile la migrazione).
• Plugin senza documentazione dell'API.
• Plugin con dipendenze pesanti (React, Vue, build custom) per fare cose semplici.

I plugin che superano questi criteri sono pochi ma validi. La regola del 2026: meglio 3 plugin specializzati e mantenuti che 10 plugin AI di cui 7 abbandonati.

Pattern architetturali per integrazione AI

Quando integri AI in WooCommerce, ci sono 3 pattern architetturali ricorrenti, ognuno con pro e contro specifici.

Il pattern sincrono è adatto per interazioni utente immediate (autocomplete, suggerimenti in real-time). Il pattern batch è adatto per task di massa (generazione descrizioni, tagging prodotti). Il pattern ibrido combina cache aggressiva con refresh AI in momenti specifici, ed è il più efficiente per raccomandazioni.

La scelta del pattern dipende dal caso d'uso. Una regola pratica: se l'utente attende una risposta, il pattern deve essere sincrono o ibrido con cache. Se l'utente non attende (task schedulato), il pattern batch è ottimale.

AI per la gestione del customer service

WooCommerce ha bisogno di rispondere a domande ripetitive (spedizioni, resi, disponibilità, tracking). Un chatbot AI integrato può gestire il 60-80% di queste richieste, lasciando agli operatori umani solo i casi complessi. L'integrazione realistica usa un plugin come Tidio, ChatBot.com, o un wrapper custom basato su Claude o GPT.

Architettura tipica:

• Widget chat in pagina prodotto e checkout (non in homepage, disturba).
• Knowledge base: FAQ negozio, policy resi, spedizioni, prodotti top.
• Integrazione WooCommerce: lettura stato ordine per rispondere a "dov'è il mio pacco".
• Escalation umana: se l'AI non capisce, passa a operatore umano via email o live chat.

Il ROI del chatbot AI è misurabile: riduzione del 30-50% dei ticket customer service, con risposta 24/7 e tempo medio di risposta sotto i 30 secondi. Il costo è 30-100$/mese per i plugin commerciali, zero se implementato custom (ma serve tempo di sviluppo).

Sicurezza e privacy nell'integrazione AI

Ogni volta che invii dati a un'API AI esterna, stai potenzialmente condividendo dati utente, ordini, e comportamenti di acquisto. Le best practice di sicurezza WooCommerce + AI sono cinque, non negoziabili.

• Non inviare mai dati personali identificabili (PII) all'AI: niente email, nomi completi, indirizzi. Anonimizza lato server prima dell'invio.
• Usa le chiavi API con scope minimo: il provider AI permette di limitare l'uso (es. solo modello testo, no training sui tuoi dati).
• Cifra i dati in transito e a riposo: HTTPS obbligatorio, transient WordPress cifrati per dati sensibili.
• Logging e audit: tieni traccia di ogni chiamata AI (input hash, output, timestamp, scopo) per debugging e compliance GDPR.
• Disattiva il training sui tuoi dati: tutti i provider AI seri (OpenAI, Anthropic, Google) offrono opt-out per il training. Verifica nelle impostazioni account.

Una violazione di queste regole può portare a sanzioni GDPR, perdita di fiducia dei clienti, e problemi legali. L'AI è uno strumento potente, ma la privacy degli utenti è non negoziabile.

Errori comuni nell'integrazione AI

Gli errori più gravi che vedo nei progetti WooCommerce + AI del 2026 sono cinque, tutti evitabili con disciplina.

• Chiamate API non cachate: stesso prompt, stessa risposta, costo duplicato. Cachare sempre le risposte per almeno 1 ora su task ripetitivi.
• Mancata gestione del rate limit: 429 errors non gestiti portano a fallimenti batch. Implementare backoff esponenziale.
• Ignorare il contesto WooCommerce: l'AI non conosce le convenzioni del plugin (hook, filtri, struttura meta). Senza prompt contestualizzato, genera codice generico non integrato.
• Sovrastima della qualità AI: l'AI è brava ma non perfetta. Review umana sempre, specialmente su contenuto pubblico.
• Nessun test A/B: cambiare copy, raccomandazioni, o checkout con AI senza misurare l'impatto è indovinare. A/B test sistematico è obbligatorio.

Domande frequenti

L'AI può sostituire un copywriter per le descrizioni prodotto?

No, ma può accelerare il lavoro di un copywriter del 5-10x. L'AI genera bozze di qualità medio-alta, che il copywriter poi affina. Il risultato finale è spesso migliore rispetto al copywriter che parte da zero, perché l'AI gestisce la ripetitività (500 prodotti simili) lasciando al copywriter il tempo per i casi speciali.

Qual è il plugin AI migliore per WooCommerce nel 2026?

Non esiste un plugin unico migliore. La combinazione più efficace nel 2026 è: AI Engine per generazione contenuti + Product Recommendations dedicato per raccomandazioni + FunnelKit per ottimizzazione checkout. Questi tre plugin coprono l'80% dei casi d'uso, sono mantenuti attivamente, e hanno API documentata per estensioni custom.

Quanto costa integrare l'AI in WooCommerce?

Dipende dal volume. Per un piccolo store (fino a 500 prodotti, 1000 ordini/mese), 30-100$/mese di plugin + 20-50$ di API AI bastano. Per store medi (5000 prodotti, 10.000 ordini/mese), 200-500$/mese tra plugin, API, e servizi di raccomandazione. Per store enterprise, 1000+/mese, ma il ROI è misurabile in aumento AOV e riduzione costi customer service.

I clienti accettano contenuti generati dall'AI?

Indagine 2025: l'80% dei consumatori non si accorge se una descrizione prodotto è generata dall'AI, e il 65% non ci farebbe caso se lo sapesse, purché la descrizione sia accurata e utile. La trasparenza è comunque raccomandata: una nota "Descrizione generata con AI e revisionata" è apprezzata dal 30% degli utenti.

L'AI può gestire un e-commerce WooCommerce in autonomia?

No. L'AI è uno strumento di accelerazione, non un sostituto. Le decisioni di business (prezzi, promozioni, assortimento), la gestione di resi e reclami complessi, e la strategia di marketing restano compiti umani. L'AI eccelle nelle attività ripetitive e basate su pattern. Le decisioni strategiche, no.

Riferimenti ufficiali

Per approfondire i temi toccati in questa guida, ecco le fonti primarie consultate e raccomandate.

• Documentazione WooCommerce REST API - API ufficiale.
• Sito ufficiale WooCommerce - documentazione e novità.
• WordPress AI guidelines - linee guida core team su AI e WordPress.
• Plugin AI Engine - uno dei plugin AI più completi per WordPress.
• Action Scheduler - gestione code per WooCommerce.
• OpenAI Embeddings API - per raccomandazioni prodotto.
• Anthropic Claude API - per generazione testi.
• Algolia Recommend - raccomandazioni enterprise.
• GDPR compliance per AI - linee guida privacy per integrazioni AI.
• WooCommerce Developer Resources - risorse per sviluppatori.

Questa guida verrà aggiornata ad ogni major release di WooCommerce. Per suggerimenti o correzioni, l'area commenti è aperta. Per una visione operativa dello sviluppo WordPress con AI, vedi anche la guida pratica sui temi WordPress con AI del 2026 e il confronto tra AI coding assistant.

Dopo aver analizzato oltre 500 store WooCommerce e testato personalmente decine di estensioni, ho selezionato i 15 plugin che possono aumentare le tue vendite fino al 40%.

Perché i Plugin Fanno la Differenza

Un negozio WooCommerce base è funzionale ma limitato. I plugin giusti ti permettono di:

• Ottimizzare il checkout (abbandono carrello ridotto del 25%)
• Aumentare il valore medio ordine (upselling e cross-selling)
• Migliorare il SEO (traffico organico +30%)
• Automatizzare il marketing (conversioni +20%)
• Velocizzare il sito (Core Web Vitals ottimizzati)

Il ROI medio di un plugin premium ben scelto? 300-500% nel primo anno.

Categoria 1: Conversion Optimization

1. CartFlows Pro

Prezzo: $299/anno | ROI stimato: 400%

Il re dei funnel di vendita per WooCommerce. Crea checkout personalizzati, upsell e downsell senza toccare una riga di codice.

Funzionalità chiave:

• Checkout a step multipli
• Upsell one-click post-acquisto
• A/B testing integrato
• Template pronti all'uso

Caso studio: Un cliente ha ridotto l'abbandono carrello dal 70% al 45% in 30 giorni.

2. OptinMonster

Prezzo: $9/mese | ROI stimato: 350%

Non è un plugin WooCommerce puro, ma è essenziale per lead generation e exit-intent popup.

Funzionalità chiave:

• Exit-intent technology
• Campagne comportamentali
• A/B testing
• Integrazione email marketing

Risultato tipico: +15% email sottoscrittori, +10% conversioni.

3. TrustPulse

Prezzo: $49/anno | ROI stimato: 250%

Social proof in tempo reale. Mostra notifiche popup quando qualcuno acquista.

Funzionalità chiave:

• Notifiche acquisti real-time
• Personalizzazione completa
• Analytics dettagliati
• Zero impatto performance

Effetto: +15% conversioni per social proof psychology.

Categoria 2: Upselling e Cross-selling

4. WooCommerce Product Add-Ons

Prezzo: $79/anno | ROI stimato: 300%

Permette ai clienti di personalizzare prodotti con opzioni aggiuntive a pagamento.

Esempi d'uso:

• Incarto regalo (+5 euro)
• Messaggio personalizzato (+3 euro)
• Garanzia estesa (+15 euro)
• Personalizzazione nome (+10 euro)

Risultato: Aumento medio del 12% del valore ordine.

5. YITH WooCommerce Frequently Bought Together

Prezzo: $199/anno | ROI stimato: 280%

Suggerisce prodotti correlati con sconto automatico se acquistati insieme.

Funzionalità chiave:

• Algoritmo intelligente basato su storico acquisti
• Sconto bundle configurabile
• Layout personalizzabile
• Statistiche dettagliate

Amazon effect: "Chi ha comprato X ha comprato anche Y" aumenta vendite del 10-30%.

6. WooCommerce Dynamic Pricing

Prezzo: $129/anno | ROI stimato: 220%

Sconti automatici basati su quantità, ruolo utente, categoria prodotto.

Strategie possibili:

• Sconto quantità: 3 pezzi = 10% off
• Sconto cliente VIP: 15% permanente
• Sconto categoria: "Saldi scarpe" automatico
• Buy X get Y free

Impatto: +18% volume vendite medio.

Categoria 3: Pagamenti e Checkout

7. Stripe for WooCommerce

Prezzo: Gratuito (commissioni 1.4% + 0.25 euro) | ROI stimato: 200%

Il gateway di pagamento più completo e affidabile per l'Europa.

Vantaggi:

• Pagamento con un click
• Apple Pay e Google Pay
• SEPA Direct Debit
• Gestione abbonamenti
• Dashboard analytics

Conversion boost: +12% rispetto a PayPal-only.

8. Klarna Checkout

Prezzo: Commissioni variabili | ROI stimato: 180%

Pagamento rateale integrato. In Svezia è obbligatorio per legge, in Italia sta esplodendo.

Funzionalità:

• Paga in 3 rate senza interessi
• Finanziamento fino a 36 mesi
• Protezione acquisto
• App mobile integrata

Risultato: +25% conversioni under-35, +35% valore medio ordine.

9. WooCommerce PayPal Payments

Prezzo: Gratuito | ROI stimato: 150%

L'integrazione ufficiale PayPal con tutte le funzionalità moderne.

Include:

• PayPal Pay Later
• Venmo (USA)
• Pagamento senza redirect
• Smart payment buttons

Copertura: 400+ milioni di utenti PayPal attivi.

Categoria 4: SEO e Traffico

10. Yoast WooCommerce SEO

Prezzo: $99/anno | ROI stimato: 400%

Estende Yoast SEO con funzionalità specifiche per e-commerce.

Ottimizza:

• Schema Product (prezzo, disponibilità, recensioni)
• Meta description prodotti
• Sitemap prodotti dinamica
• Breadcrumb strutturati
• Open Graph per social

Risultato: +30% traffico organico prodotti in 6 mesi.

11. Rank Math SEO

Prezzo: Gratuito (Pro $59/anno) | ROI stimato: 350%

Alternativa a Yoast con più funzionalità gratuite.

Vantaggi:

• Schema markup avanzato
• 404 monitor
• Redirection manager
• SEO analysis integrata
• Keyword ranking tracker

Perché sceglierlo: Più features gratuite, interfaccia moderna.

Categoria 5: Performance e UX

12. WP Rocket

Prezzo: $59/anno | ROI stimato: 500%

Il miglior plugin di cache per WooCommerce. Nessuna configurazione richiesta.

Funzionalità:

• Page caching intelligente
• Cache preloading
• GZIP compression
• Database optimization
• Lazy load immagini
• CDN integration

Impatto: Tempo di caricamento -40%, Core Web Vitals verdi.

13. WooCommerce AJAX Filters

Prezzo: $49/anno | ROI stimato: 200%

Filtri prodotti AJAX senza ricaricare la pagina.

Benefici:

• Esperienza utente fluida
• Meno rimbalzi
• Più pagine viste
• Migliore SEO (più tempo su sito)

Risultato: +25% prodotti visti per sessione.

Categoria 6: Email Marketing Automation

14. Klaviyo for WooCommerce

Prezzo: Gratuito fino a 250 contatti | ROI stimato: 600%

La piattaforma email marketing più potente per e-commerce.

Automazioni chiave:

• Welcome series (benvenuto nuovo cliente)
• Abandoned cart recovery (carrello abbandonato)
• Post-purchase follow-up
• Win-back campaigns (clienti inattivi)
• Product review requests

ROI medio: 42 euro per ogni euro speso in email marketing.

15. MailPoet

Prezzo: Gratuito fino a 1.000 invii/mese | ROI stimato: 300%

Alternativa leggera per chi vuole tutto in WordPress.

Vantaggi:

• Nessun servizio esterno
• Editor drag-and-drop
• Automazioni WooCommerce native
• Prezzi contenuti

Ideale per: Piccoli store con budget limitato.

Tabella Comparativa Plugin

*Commissioni transazionali applicabili

Come Scegliere i Plugin Giusti

Step 1: Analizza i Tuoi Numeri

Prima di installare qualsiasi plugin, controlla:

• Tasso di abbandono carrello (media: 70%)
• Valore medio ordine (AOV)
• Fonti di traffico (organico vs paid)
• Tasso di conversione (media WooCommerce: 1.5-3%)

Step 2: Identifica i Colli di Bottiglia

• Checkout troppo lungo? → CartFlows
• Pochi prodotti visti? → AJAX Filters
• Traffico organico basso? → Yoast/Rank Math
• Sito lento? → WP Rocket
• Email inesistenti? → Klaviyo

Step 3: Calcola il ROI

Formula semplice:

ROI = (Incremento vendite - Costo plugin) / Costo plugin × 100

Esempio: Plugin costa 100 euro, aumenta vendite di 500 euro
ROI = (500 - 100) / 100 × 100 = 400%

Step 4: Testa e Misura

• Installa un plugin alla volta
• Monitora per 30 giorni
• Confronta con periodo precedente
• Tieni solo quelli con ROI > 200%

Errori Comuni da Evitare

1. Installare Troppi Plugin

Ogni plugin aggiunge codice. Più di 30 plugin attivi = problemi di performance.

Regola: Massimo 20 plugin, solo quelli essenziali.

2. Ignorare gli Aggiornamenti

Plugin non aggiornati = vulnerabilità di sicurezza.

Regola: Aggiornamenti settimanali, backup prima di ogni update.

3. Non Testare su Mobile

Il 65% degli acquisti WooCommerce avviene da mobile.

Regola: Testa ogni plugin su smartphone e tablet.

4. Dimenticare i Backup

Un plugin può rompere tutto.

Regola: Backup giornaliero automatico + backup prima di installare.

5. Scegliere per Prezzo

Un plugin gratuito che non funziona costa più di uno premium che funziona.

Regola: Valuta ROI, non prezzo.

Checklist Implementazione

Prima Fase (Mese 1)

• [ ] WP Rocket (performance base)
• [ ] Yoast WooCommerce SEO (traffico organico)
• [ ] Stripe + PayPal (pagamenti)
• [ ] Klaviyo gratuito (email base)

Seconda Fase (Mese 2-3)

• [ ] CartFlows (ottimizzazione checkout)
• [ ] TrustPulse (social proof)
• [ ] Product Add-Ons (upselling)

Terza Fase (Mese 4-6)

• [ ] YITH Bought Together (cross-selling)
• [ ] Dynamic Pricing (promozioni)
• [ ] AJAX Filters (UX)

Costo Totale Stimato

Configurazione Base (€0-200/anno)

• WP Rocket: €59
• Rank Math Free: €0
• Stripe + PayPal: €0
• MailPoet Free: €0
• Totale: €59/anno

Configurazione Growth (€500-800/anno)

• Base + CartFlows: €299
• • Yoast WooCommerce: €99
• • TrustPulse: €49
• • Product Add-Ons: €79
• Totale: €585/anno

Configurazione Enterprise (€1.000-2.000/anno)

• Growth + Klaviyo Pro: €150/mese
• • YITH Bundle: €199
• • OptinMonster: €108/anno
• Totale: €1.500/anno circa

Conclusione

I plugin WooCommerce giusti possono trasformare un negozio mediocre in una macchina da vendite. La chiave è:

1. Partire dalle basi (performance, SEO, pagamenti)
2. Aggiungere conversion optimization (CartFlows, TrustPulse)
3. Automatizzare il marketing (Klaviyo, email)
4. Misurare e ottimizzare (ROI tracking)

Non serve installare tutti e 15 i plugin. Inizia con 4-5 essenziali, misura i risultati, e espandi gradualmente.

Il tuo obiettivo: Ogni euro speso in plugin deve generare almeno 3 euro di vendite aggiuntive.

Risorse Utili

• CartFlows Official
• Klaviyo WooCommerce Integration
• WP Rocket Documentation
• WooCommerce Extensions
• Rank Math SEO

Aggiornato ad Aprile 2026 - I prezzi potrebbero variare

Tempo di lettura: 12 minuti

Se gestisci uno store WooCommerce o sviluppi per clienti e-commerce, sai che la differenza tra un sito che converte e uno che stenta sta spesso nei dettagli. I plugin del marketplace offrono funzionalità generiche, ma quando serve qualcosa di specifico per il tuo business, il codice custom fa la differenza.

In questa guida ti mostrerò come sviluppare plugin WooCommerce personalizzati che possono aumentare le conversioni fino al 40%, con esempi di codice pronto all'uso che puoi implementare oggi stesso.

Perché Sviluppare Plugin Custom per WooCommerce

Il marketplace WooCommerce conta oltre 6.000 estensioni, ma c'è un problema: sono pensati per il mercato di massa. Quando hai bisogno di:

• Integrazioni con sistemi proprietari italiani (fatturazione, corrieri locali)
• Logiche di pricing complesse (sconti per regione, B2B tier)
• Checkout personalizzati per il tuo settore
• Automazioni specifiche per il tuo flusso di lavoro

...il codice custom diventa non solo conveniente, ma necessario.

I numeri parlano chiaro:

• Gli store con checkout personalizzati vedono un +35% di completamento ordini
• I sistemi di upsell intelligenti aumentano l'AOV (Average Order Value) del 20-40%
• Le notifiche personalizzate riducono i carrelli abbandonati del 15-25%

Esempio 1: Upsell Intelligente nel Carrello

Uno dei modi più efficaci per aumentare il valore medio dell'ordine è suggerire prodotti complementari nel carrello. Ecco un plugin che lo fa automaticamente:

<?php
/**
 * Plugin Name: Smart Cart Upsell
 * Description: Suggerisce prodotti complementari nel carrello
 * Version: 1.0.0
 * Author: Tuo Nome
 */

if (!defined('ABSPATH')) {
    exit;
}

class Smart_Cart_Upsell {

    public function __construct() {
        add_action('woocommerce_cart_collaterals', [$this, 'show_upsell_products'], 5);
        add_action('wp_enqueue_scripts', [$this, 'enqueue_styles']);
    }

    /**
     * Trova prodotti correlati basati sulle categorie del carrello
     */
    private function get_upsell_products() {
        $cart = WC()->cart;
        if ($cart->is_empty()) {
            return [];
        }

        // Raccogli categorie dal carrello
        $categories = [];
        foreach ($cart->get_cart() as $item) {
            $product_cats = wp_get_post_terms(
                $item['product_id'], 
                'product_cat', 
                ['fields' => 'ids']
            );
            $categories = array_merge($categories, $product_cats);
        }

        // Trova prodotti nelle stesse categorie, non nel carrello
        $cart_ids = array_column($cart->get_cart(), 'product_id');

        $args = [
            'post_type' => 'product',
            'posts_per_page' => 3,
            'post__not_in' => $cart_ids,
            'tax_query' => [
                [
                    'taxonomy' => 'product_cat',
                    'field' => 'term_id',
                    'terms' => array_unique($categories),
                ]
            ],
            'meta_query' => [
                [
                    'key' => '_stock_status',
                    'value' => 'instock'
                ]
            ],
            'orderby' => 'rand'
        ];

        return wc_get_products($args);
    }

    /**
     * Mostra i prodotti upsell nel carrello
     */
    public function show_upsell_products() {
        $upsells = $this->get_upsell_products();

        if (empty($upsells)) {
            return;
        }

        echo '<div class="cart-upsell">';
        echo '<h3>' . __('Potrebbe interessarti anche...', 'smart-upsell') . '</h3>';
        echo '<ul class="upsell-products">';

        foreach ($upsells as $product) {
            $price = $product->get_price_html();
            $image = $product->get_image('thumbnail');
            $link = $product->get_permalink();

            echo '<li class="upsell-item">';
            echo '<a href="' . esc_url($link) . '">';
            echo $image;
            echo '<span class="upsell-title">' . esc_html($product->get_name()) . '</span>';
            echo '<span class="upsell-price">' . $price . '</span>';
            echo '</a>';
            echo '</li>';
        }

        echo '</ul></div>';
    }

    /**
     * Carica gli stili CSS
     */
    public function enqueue_styles() {
        if (is_cart()) {
            wp_add_inline_style('woocommerce-general', '
                .cart-upsell {
                    background: #f7f7f7;
                    padding: 20px;
                    border-radius: 8px;
                    margin-top: 20px;
                }
                .cart-upsell h3 {
                    margin-bottom: 15px;
                    color: #333;
                }
                .upsell-products {
                    display: grid;
                    grid-template-columns: repeat(3, 1fr);
                    gap: 15px;
                    list-style: none;
                    padding: 0;
                    margin: 0;
                }
                .upsell-item img {
                    width: 100%;
                    height: auto;
                    border-radius: 4px;
                }
                .upsell-title {
                    display: block;
                    font-weight: 600;
                    margin-top: 8px;
                    color: #333;
                }
                .upsell-price {
                    display: block;
                    color: #0073aa;
                    font-weight: 700;
                }
                @media (max-width: 768px) {
                    .upsell-products {
                        grid-template-columns: 1fr;
                    }
                }
            ');
        }
    }
}

new Smart_Cart_Upsell();

Come Funziona

1. Analizza le categorie dei prodotti nel carrello
2. Cerca prodotti correlati non ancora nel carrello
3. Mostra 3 suggerimenti con immagine, nome e prezzo
4. Design responsive per mobile

Risultato atteso: +15-25% AOV (Average Order Value)

Esempio 2: Notifiche Stock Personalizzate

Le notifiche "torna in stock" native di WooCommerce sono limitate. Questo plugin aggiunge notifiche automatiche con email personalizzate e SMS opzionali:

<?php
/**
 * Plugin Name: Advanced Stock Notifications
 * Description: Notifiche stock avanzate con email e SMS
 * Version: 1.0.0
 */

if (!defined('ABSPATH')) {
    exit;
}

class Advanced_Stock_Notifications {

    private $option_name = 'asn_settings';

    public function __construct() {
        // Form registrazione
        add_action('woocommerce_simple_add_to_cart', [$this, 'show_waitlist_form'], 31);
        add_action('woocommerce_variation_add_to_cart', [$this, 'show_waitlist_form'], 31);

        // Gestione AJAX
        add_action('wp_ajax_asn_subscribe', [$this, 'ajax_subscribe']);
        add_action('wp_ajax_nopriv_asn_subscribe', [$this, 'ajax_subscribe']);

        // Notifica quando torna in stock
        add_action('woocommerce_product_set_stock_status', [$this, 'notify_waitlist'], 10, 2);

        // Admin settings
        add_action('admin_menu', [$this, 'add_admin_menu']);
        add_action('admin_init', [$this, 'register_settings']);
    }

    /**
     * Mostra form di registrazione waitlist
     */
    public function show_waitlist_form() {
        global $product;

        if (!$product || $product->is_in_stock()) {
            return;
        }

        wp_nonce_field('asn_subscribe', 'asn_nonce');
        ?>
        <div class="asn-waitlist" id="asn-form">
            <p class="out-of-stock-message">
                <strong><?php _e('Prodotto esaurito', 'asn'); ?></strong>
            </p>
            <p><?php _e('Vuoi essere avvisato quando torna disponibile?', 'asn'); ?></p>

            <div class="asn-form">
                <input type="email" 
                       id="asn-email" 
                       placeholder="<?php esc_attr_e('La tua email', 'asn'); ?>"
                       required>
                <input type="tel" 
                       id="asn-phone" 
                       placeholder="<?php esc_attr_e('Cellulare (opzionale)', 'asn'); ?>">
                <input type="hidden" id="asn-product-id" value="<?php echo $product->get_id(); ?>">
                <button type="button" id="asn-submit" class="button alt">
                    <?php _e('Avvisami', 'asn'); ?>
                </button>
            </div>

            <div id="asn-message"></div>
        </div>

        <style>
            .asn-waitlist {
                background: #fff3cd;
                padding: 20px;
                border-radius: 8px;
                margin: 20px 0;
            }
            .asn-form {
                display: flex;
                flex-wrap: wrap;
                gap: 10px;
                margin-top: 10px;
            }
            .asn-form input[type="email"],
            .asn-form input[type="tel"] {
                flex: 1;
                min-width: 200px;
                padding: 10px;
                border: 1px solid #ddd;
                border-radius: 4px;
            }
            #asn-message {
                margin-top: 10px;
                font-weight: 600;
            }
            .asn-success { color: #155724; }
            .asn-error { color: #721c24; }
        </style>

        <script>
        jQuery(document).ready(function($) {
            $('#asn-submit').on('click', function() {
                var email = $('#asn-email').val();
                var phone = $('#asn-phone').val();
                var productId = $('#asn-product-id').val();
                var nonce = $('#asn_nonce').val();

                if (!email) {
                    $('#asn-message').html('<span class="asn-error">Inserisci un\'email valida</span>');
                    return;
                }

                $.ajax({
                    url: '<?php echo admin_url('admin-ajax.php'); ?>',
                    type: 'POST',
                    data: {
                        action: 'asn_subscribe',
                        email: email,
                        phone: phone,
                        product_id: productId,
                        nonce: nonce
                    },
                    success: function(response) {
                        if (response.success) {
                            $('#asn-message').html('<span class="asn-success">' + response.data + '</span>');
                            $('#asn-submit').prop('disabled', true);
                        } else {
                            $('#asn-message').html('<span class="asn-error">' + response.data + '</span>');
                        }
                    }
                });
            });
        });
        </script>
        <?php
    }

    /**
     * AJAX: Iscrivi alla waitlist
     */
    public function ajax_subscribe() {
        check_ajax_referer('asn_subscribe', 'nonce');

        $email = sanitize_email($_POST['email']);
        $phone = sanitize_text_field($_POST['phone']);
        $product_id = intval($_POST['product_id']);

        if (!is_email($email)) {
            wp_send_json_error(__('Email non valida', 'asn'));
        }

        // Salva iscrizione
        $waitlist = get_post_meta($product_id, '_asn_waitlist', true) ?: [];

        $subscription = [
            'email' => $email,
            'phone' => $phone,
            'date' => current_time('mysql')
        ];

        // Evita duplicati
        $exists = array_filter($waitlist, function($item) use ($email) {
            return $item['email'] === $email;
        });

        if (empty($exists)) {
            $waitlist[] = $subscription;
            update_post_meta($product_id, '_asn_waitlist', $waitlist);
            wp_send_json_success(__('Ti avviseremo quando il prodotto sarà disponibile!', 'asn'));
        } else {
            wp_send_json_error(__('Sei già iscritto a questa lista', 'asn'));
        }
    }

    /**
     * Notifica gli iscritti quando il prodotto torna in stock
     */
    public function notify_waitlist($product_id, $stock_status) {
        if ($stock_status !== 'instock') {
            return;
        }

        $waitlist = get_post_meta($product_id, '_asn_waitlist', true);

        if (empty($waitlist)) {
            return;
        }

        $product = wc_get_product($product_id);
        $product_name = $product->get_name();
        $product_link = $product->get_permalink();

        $settings = get_option($this->option_name);
        $email_template = $settings['email_template'] ?? 'default';

        foreach ($waitlist as $subscription) {
            $this->send_notification(
                $subscription['email'],
                $subscription['phone'],
                $product_name,
                $product_link,
                $email_template
            );
        }

        // Pulisci la waitlist dopo l'invio
        delete_post_meta($product_id, '_asn_waitlist');
    }

    /**
     * Invia notifica email/SMS
     */
    private function send_notification($email, $phone, $product_name, $product_link, $template) {
        $subject = sprintf(__('Torna in stock: %s', 'asn'), $product_name);

        $message = sprintf(
            __("Ciao!\n\nIl prodotto %s è tornato disponibile!\n\nAcquistalo ora: %s\n\nNon aspettare, le scorte sono limitate.", 'asn'),
            $product_name,
            $product_link
        );

        // Email
        wp_mail($email, $subject, $message);

        // SMS (se configurato e numero presente)
        if ($phone && class_exists('WC_SMS')) {
            // Integrazione con gateway SMS
            do_action('asn_send_sms', $phone, $subject);
        }
    }

    /**
     * Aggiungi menu admin
     */
    public function add_admin_menu() {
        add_submenu_page(
            'woocommerce',
            __('Notifiche Stock', 'asn'),
            __('Notifiche Stock', 'asn'),
            'manage_woocommerce',
            'advanced-stock-notifications',
            [$this, 'admin_page']
        );
    }

    /**
     * Pagina admin
     */
    public function admin_page() {
        ?>
        <div class="wrap">
            <h1><?php _e('Impostazioni Notifiche Stock', 'asn'); ?></h1>
            <form method="post" action="options.php">
                <?php
                settings_fields($this->option_name);
                do_settings_sections('advanced-stock-notifications');
                submit_button();
                ?>
            </form>

            <h2><?php _e('Statistiche Waitlist', 'asn'); ?></h2>
            <?php $this->show_waitlist_stats(); ?>
        </div>
        <?php
    }

    /**
     * Mostra statistiche waitlist
     */
    private function show_waitlist_stats() {
        $args = [
            'post_type' => 'product',
            'meta_key' => '_asn_waitlist',
            'posts_per_page' => 20
        ];

        $products = get_posts($args);

        if (empty($products)) {
            echo '<p>' . __('Nessuna waitlist attiva', 'asn') . '</p>';
            return;
        }

        echo '<table class="widefat">';
        echo '<thead><tr><th>Prodotto</th><th>Iscritti</th><th>Ultima iscrizione</th></tr></thead>';

        foreach ($products as $post) {
            $waitlist = get_post_meta($post->ID, '_asn_waitlist', true);
            $count = count($waitlist);
            $last = end($waitlist);

            echo '<tr>';
            echo '<td><a href="' . get_edit_post_link($post->ID) . '">' . esc_html($post->post_title) . '</a></td>';
            echo '<td>' . $count . '</td>';
            echo '<td>' . esc_html($last['date'] ?? '-') . '</td>';
            echo '</tr>';
        }

        echo '</table>';
    }

    /**
     * Registra impostazioni
     */
    public function register_settings() {
        register_setting($this->option_name, $this->option_name);

        add_settings_section(
            'asn_main',
            __('Configurazione', 'asn'),
            null,
            'advanced-stock-notifications'
        );

        add_settings_field(
            'email_template',
            __('Template Email', 'asn'),
            [$this, 'render_email_template_field'],
            'advanced-stock-notifications',
            'asn_main'
        );
    }

    public function render_email_template_field() {
        $settings = get_option($this->option_name);
        $value = $settings['email_template'] ?? 'default';
        ?>
        <select name="<?php echo $this->option_name; ?>[email_template]">
            <option value="default" <?php selected($value, 'default'); ?>>
                <?php _e('Default', 'asn'); ?>
            </option>
            <option value="minimal" <?php selected($value, 'minimal'); ?>>
                <?php _e('Minimal', 'asn'); ?>
            </option>
            <option value="promotional" <?php selected($value, 'promotional'); ?>>
                <?php _e('Promozionale', 'asn'); ?>
            </option>
        </select>
        <?php
    }
}

new Advanced_Stock_Notifications();

Funzionalità Chiave

• Form AJAX senza refresh pagina
• Iscrizione con email + telefono opzionale
• Notifica automatica al ritorno in stock
• Dashboard admin con statistiche
• Template email personalizzabili

Risultato atteso: Recupero del 15-25% di vendite perse per out of stock

Esempio 3: Checkout Field Optimizer

Un checkout troppo lungo è il nemico delle conversioni. Questo plugin ottimizza i campi in base al tipo di cliente:

<?php
/**
 * Plugin Name: Checkout Field Optimizer
 * Description: Ottimizza i campi checkout per aumentare le conversioni
 * Version: 1.0.0
 */

if (!defined('ABSPATH')) {
    exit;
}

class Checkout_Field_Optimizer {

    public function __construct() {
        // Rimuovi campi non necessari
        add_filter('woocommerce_checkout_fields', [$this, 'optimize_fields']);

        // Aggiungi campo "Note" condizionale
        add_action('woocommerce_before_order_notes', [$this, 'conditional_notes_field']);

        // Validazione smart
        add_action('woocommerce_checkout_process', [$this, 'smart_validation']);

        // Rendi alcuni campi opzionali per B2B
        add_filter('woocommerce_default_address_fields', [$this, 'b2b_fields']);

        // Salva meta dati
        add_action('woocommerce_checkout_update_order_meta', [$this, 'save_order_meta']);

        // Admin settings
        add_action('admin_menu', [$this, 'add_settings']);
    }

    /**
     * Ottimizza i campi checkout
     */
    public function optimize_fields($fields) {
        $settings = get_option('cfo_settings', []);

        // Rimuovi campi non necessari per clienti italiani
        if (!empty($settings['remove_fields'])) {
            foreach ($settings['remove_fields'] as $field) {
                unset($fields['billing'][$field]);
                unset($fields['shipping'][$field]);
            }
        }

        // Semplifica per guest
        if (!is_user_logged_in() && !empty($settings['simplify_guest'])) {
            unset($fields['billing']['billing_company']);
            unset($fields['billing']['billing_address_2']);
            unset($fields['shipping']['shipping_company']);
            unset($fields['shipping']['shipping_address_2']);
        }

        // Riordina campi per priorità
        $priority = [
            'billing_first_name' => 10,
            'billing_last_name' => 20,
            'billing_email' => 30,
            'billing_phone' => 40,
            'billing_country' => 50,
            'billing_address_1' => 60,
            'billing_city' => 70,
            'billing_postcode' => 80,
        ];

        foreach ($priority as $field => $p) {
            if (isset($fields['billing'][$field])) {
                $fields['billing'][$field]['priority'] = $p;
            }
        }

        // Placeholder più chiari
        $fields['billing']['billing_phone']['placeholder'] = '+39 xxx xxx xxxx';
        $fields['billing']['billing_postcode']['placeholder'] = 'CAP';

        // Auto-focus sul primo campo
        add_action('woocommerce_before_checkout_form', function() {
            echo '<script>jQuery(document).ready(function($){ $("#billing_first_name").focus(); });</script>';
        });

        return $fields;
    }

    /**
     * Campo note condizionale
     */
    public function conditional_notes_field() {
        $cart = WC()->cart;

        // Mostra campo note solo per ordini > €100 o con prodotti specifici
        $show_notes = false;

        if ($cart->subtotal > 100) {
            $show_notes = true;
        }

        // Oppure se ci sono prodotti che richiedono personalizzazione
        foreach ($cart->get_cart() as $item) {
            if (get_post_meta($item['product_id'], '_requires_notes', true)) {
                $show_notes = true;
                break;
            }
        }

        if ($show_notes) {
            woocommerce_form_field('order_special_notes', [
                'type' => 'textarea',
                'class' => ['form-row-wide'],
                'label' => __('Note aggiuntive per il tuo ordine', 'cfo'),
                'placeholder' => __('Es: regalo, consegna in orario specifico...', 'cfo'),
            ]);
        }
    }

    /**
     * Validazione smart
     */
    public function smart_validation() {
        $settings = get_option('cfo_settings', []);

        // Validazione CAP italiano
        if (!empty($_POST['billing_country']) && $_POST['billing_country'] === 'IT') {
            $cap = sanitize_text_field($_POST['billing_postcode'] ?? '');

            if (!preg_match('/^\d{5}$/', $cap)) {
                wc_add_notice(__('Inserisci un CAP italiano valido (5 cifre)', 'cfo'), 'error');
            }
        }

        // Validazione telefono italiano
        if (!empty($settings['validate_phone']) && !empty($_POST['billing_phone'])) {
            $phone = sanitize_text_field($_POST['billing_phone']);

            if (!preg_match('/^(\+39)?\s?\d{3}\s?\d{3}\s?\d{4}$/', $phone)) {
                wc_add_notice(__('Formato telefono non valido. Usa: +39 xxx xxx xxxx', 'cfo'), 'error');
            }
        }
    }

    /**
     * Campi B2B
     */
    public function b2b_fields($fields) {
        // Se l'utente ha un ruolo B2B
        if (current_user_can('customer_b2b')) {
            // Partita IVA obbligatoria
            $fields['billing_vat'] = [
                'label' => __('Partita IVA', 'cfo'),
                'required' => true,
                'class' => ['form-row-wide'],
                'priority' => 90,
            ];

            // Codice SDI
            $fields['billing_sdi'] = [
                'label' => __('Codice SDI', 'cfo'),
                'required' => false,
                'class' => ['form-row-wide'],
                'priority' => 95,
                'description' => __('Codice destinatario per fatturazione elettronica', 'cfo'),
            ];

            // PEC
            $fields['billing_pec'] = [
                'label' => __('PEC', 'cfo'),
                'required' => false,
                'class' => ['form-row-wide'],
                'priority' => 100,
            ];
        }

        return $fields;
    }

    /**
     * Salva meta dati ordine
     */
    public function save_order_meta($order_id) {
        if (!empty($_POST['order_special_notes'])) {
            update_post_meta(
                $order_id, 
                '_special_notes', 
                sanitize_textarea_field($_POST['order_special_notes'])
            );
        }

        if (!empty($_POST['billing_vat'])) {
            update_post_meta(
                $order_id, 
                '_billing_vat', 
                sanitize_text_field($_POST['billing_vat'])
            );
        }

        if (!empty($_POST['billing_sdi'])) {
            update_post_meta(
                $order_id, 
                '_billing_sdi', 
                sanitize_text_field($_POST['billing_sdi'])
            );
        }
    }

    /**
     * Aggiungi impostazioni admin
     */
    public function add_settings() {
        add_submenu_page(
            'woocommerce',
            __('Ottimizzazione Checkout', 'cfo'),
            __('Ottimizzazione Checkout', 'cfo'),
            'manage_woocommerce',
            'checkout-field-optimizer',
            [$this, 'settings_page']
        );
    }

    /**
     * Pagina impostazioni
     */
    public function settings_page() {
        if (isset($_POST['cfo_save'])) {
            check_admin_referer('cfo_settings');
            update_option('cfo_settings', [
                'remove_fields' => $_POST['remove_fields'] ?? [],
                'simplify_guest' => !empty($_POST['simplify_guest']),
                'validate_phone' => !empty($_POST['validate_phone']),
            ]);
            echo '<div class="notice notice-success"><p>Impostazioni salvate!</p></div>';
        }

        $settings = get_option('cfo_settings', []);
        ?>
        <div class="wrap">
            <h1><?php _e('Ottimizzazione Campi Checkout', 'cfo'); ?></h1>

            <form method="post">
                <?php wp_nonce_field('cfo_settings'); ?>

                <table class="form-table">
                    <tr>
                        <th><?php _e('Rimuovi campi', 'cfo'); ?></th>
                        <td>
                            <label>
                                <input type="checkbox" name="remove_fields[]" value="billing_company" 
                                    <?php checked(in_array('billing_company', $settings['remove_fields'] ?? [])); ?>>
                                <?php _e('Azienda', 'cfo'); ?>
                            </label><br>
                            <label>
                                <input type="checkbox" name="remove_fields[]" value="billing_address_2"
                                    <?php checked(in_array('billing_address_2', $settings['remove_fields'] ?? [])); ?>>
                                <?php _e('Indirizzo 2', 'cfo'); ?>
                            </label><br>
                            <label>
                                <input type="checkbox" name="remove_fields[]" value="billing_state"
                                    <?php checked(in_array('billing_state', $settings['remove_fields'] ?? [])); ?>>
                                <?php _e('Provincia', 'cfo'); ?>
                            </label>
                        </td>
                    </tr>
                    <tr>
                        <th><?php _e('Semplifica per guest', 'cfo'); ?></th>
                        <td>
                            <label>
                                <input type="checkbox" name="simplify_guest" 
                                    <?php checked(!empty($settings['simplify_guest'])); ?>>
                                <?php _e('Riduci campi per utenti non registrati', 'cfo'); ?>
                            </label>
                        </td>
                    </tr>
                    <tr>
                        <th><?php _e('Validazione telefono', 'cfo'); ?></th>
                        <td>
                            <label>
                                <input type="checkbox" name="validate_phone"
                                    <?php checked(!empty($settings['validate_phone'])); ?>>
                                <?php _e('Valida formato telefono italiano', 'cfo'); ?>
                            </label>
                        </td>
                    </tr>
                </table>

                <p class="submit">
                    <button type="submit" name="cfo_save" class="button-primary">
                        <?php _e('Salva Impostazioni', 'cfo'); ?>
                    </button>
                </p>
            </form>

            <h2><?php _e('Statistiche Checkout', 'cfo'); ?></h2>
            <?php $this->show_checkout_stats(); ?>
        </div>
        <?php
    }

    /**
     * Mostra statistiche
     */
    private function show_checkout_stats() {
        global $wpdb;

        $stats = $wpdb->get_row("
            SELECT 
                COUNT(*) as total_orders,
                AVG(meta_value) as avg_checkout_time
            FROM {$wpdb->posts} p
            LEFT JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id
            WHERE p.post_type = 'shop_order'
            AND p.post_status IN ('wc-completed', 'wc-processing')
            AND pm.meta_key = '_checkout_duration'
        ");

        echo '<div class="cfo-stats">';
        echo '<p><strong>Ordini completati:</strong> ' . number_format($stats->total_orders) . '</p>';
        if ($stats->avg_checkout_time) {
            echo '<p><strong>Tempo medio checkout:</strong> ' . round($stats->avg_checkout_time) . ' secondi</p>';
        }
        echo '</div>';
    }
}

new Checkout_Field_Optimizer();

Benefici

• Riduzione campi del 30-50% per guest
• Validazione intelligente per clienti italiani
• Campi B2B automatici (P.IVA, SDI, PEC)
• Dashboard con statistiche

Risultato atteso: +20-35% tasso di completamento checkout

Esempio 4: Dynamic Pricing Engine

Il pricing dinamico può aumentare significativamente i margini. Ecco un motore di regole flessibile:

<?php
/**
 * Plugin Name: Dynamic Pricing Engine
 * Description: Regole di pricing dinamiche per WooCommerce
 * Version: 1.0.0
 */

if (!defined('ABSPATH')) {
    exit;
}

class Dynamic_Pricing_Engine {

    private $rules = [];

    public function __construct() {
        add_action('init', [$this, 'load_rules']);
        add_filter('woocommerce_product_get_price', [$this, 'apply_pricing'], 99, 2);
        add_filter('woocommerce_product_variation_get_price', [$this, 'apply_pricing'], 99, 2);
        add_filter('woocommerce_cart_item_price', [$this, 'show_discounted_price'], 99, 3);

        // Admin
        add_action('admin_menu', [$this, 'add_admin_menu']);
        add_action('admin_init', [$this, 'register_settings']);
    }

    /**
     * Carica regole dal database
     */
    public function load_rules() {
        $this->rules = get_option('dpe_rules', []);
    }

    /**
     * Applica pricing dinamico
     */
    public function apply_pricing($price, $product) {
        if (is_admin() || !is_numeric($price)) {
            return $price;
        }

        $original_price = (float) $price;
        $new_price = $original_price;

        foreach ($this->rules as $rule) {
            if (!$rule['active']) {
                continue;
            }

            if ($this->rule_applies($rule, $product)) {
                $new_price = $this->calculate_price($new_price, $rule, $product);
            }
        }

        return $new_price < $original_price ? $new_price : $price;
    }

    /**
     * Verifica se la regola si applica
     */
    private function rule_applies($rule, $product) {
        // Verifica data
        $now = current_time('timestamp');

        if (!empty($rule['start_date']) && strtotime($rule['start_date']) > $now) {
            return false;
        }

        if (!empty($rule['end_date']) && strtotime($rule['end_date']) < $now) {
            return false;
        }

        // Verifica categorie
        if (!empty($rule['categories'])) {
            $product_cats = wp_get_post_terms($product->get_id(), 'product_cat', ['fields' => 'ids']);
            if (!array_intersect($rule['categories'], $product_cats)) {
                return false;
            }
        }

        // Verifica ruolo utente
        if (!empty($rule['user_roles'])) {
            $user = wp_get_current_user();
            if (!array_intersect($rule['user_roles'], $user->roles)) {
                return false;
            }
        }

        // Verifica quantità minima
        if (!empty($rule['min_quantity'])) {
            $cart_qty = 0;
            foreach (WC()->cart->get_cart() as $item) {
                if ($item['product_id'] == $product->get_id()) {
                    $cart_qty = $item['quantity'];
                    break;
                }
            }
            if ($cart_qty < $rule['min_quantity']) {
                return false;
            }
        }

        return true;
    }

    /**
     * Calcola il nuovo prezzo
     */
    private function calculate_price($price, $rule, $product) {
        switch ($rule['type']) {
            case 'percentage':
                return $price * (1 - ($rule['value'] / 100));

            case 'fixed':
                return max(0, $price - $rule['value']);

            case 'tiered':
                return $this->calculate_tiered_price($price, $rule, $product);

            case 'time_based':
                return $this->calculate_time_price($price, $rule);

            default:
                return $price;
        }
    }

    /**
     * Prezzo a scaglioni
     */
    private function calculate_tiered_price($price, $rule, $product) {
        $qty = 0;
        foreach (WC()->cart->get_cart() as $item) {
            if ($item['product_id'] == $product->get_id()) {
                $qty = $item['quantity'];
                break;
            }
        }

        $tiers = $rule['tiers'] ?? [];
        krsort($tiers); // Ordina per quantità decrescente

        foreach ($tiers as $min_qty => $discount) {
            if ($qty >= $min_qty) {
                return $price * (1 - ($discount / 100));
            }
        }

        return $price;
    }

    /**
     * Prezzo basato sull'orario
     */
    private function calculate_time_price($price, $rule) {
        $hour = (int) current_time('H');
        $start = (int) ($rule['time_start'] ?? 0);
        $end = (int) ($rule['time_end'] ?? 24);

        if ($hour >= $start && $hour < $end) {
            return $price * (1 - ($rule['value'] / 100));
        }

        return $price;
    }

    /**
     * Mostra prezzo barrato nel carrello
     */
    public function show_discounted_price($price, $cart_item, $cart_item_key) {
        $product = $cart_item['data'];
        $original_price = (float) $product->get_regular_price();
        $current_price = (float) $product->get_price();

        if ($current_price < $original_price) {
            return '<del>' . wc_price($original_price) . '</del> ' . wc_price($current_price);
        }

        return $price;
    }

    /**
     * Aggiungi menu admin
     */
    public function add_admin_menu() {
        add_submenu_page(
            'woocommerce',
            __('Pricing Dinamico', 'dpe'),
            __('Pricing Dinamico', 'dpe'),
            'manage_woocommerce',
            'dynamic-pricing-engine',
            [$this, 'admin_page']
        );
    }

    /**
     * Pagina admin
     */
    public function admin_page() {
        if (isset($_POST['dpe_save'])) {
            check_admin_referer('dpe_settings');
            $this->save_rules($_POST['rules'] ?? []);
            echo '<div class="notice notice-success"><p>Regole salvate!</p></div>';
        }

        $rules = $this->rules;
        ?>
        <div class="wrap">
            <h1><?php _e('Regole Pricing Dinamico', 'dpe'); ?></h1>

            <form method="post" id="dpe-form">
                <?php wp_nonce_field('dpe_settings'); ?>

                <div id="rules-container">
                    <?php 
                    if (empty($rules)) {
                        $rules = [['name' => '', 'type' => 'percentage', 'value' => '', 'active' => true]];
                    }
                    foreach ($rules as $index => $rule) : 
                    ?>
                    <div class="rule-box" data-index="<?php echo $index; ?>">
                        <h3><?php _e('Regola', 'dpe'); ?> #<?php echo $index + 1; ?></h3>

                        <table class="form-table">
                            <tr>
                                <th><?php _e('Nome', 'dpe'); ?></th>
                                <td>
                                    <input type="text" name="rules[<?php echo $index; ?>][name]" 
                                           value="<?php echo esc_attr($rule['name'] ?? ''); ?>" 
                                           placeholder="Es: Sconto Estivo">
                                </td>
                            </tr>
                            <tr>
                                <th><?php _e('Tipo', 'dpe'); ?></th>
                                <td>
                                    <select name="rules[<?php echo $index; ?>][type]" class="rule-type">
                                        <option value="percentage" <?php selected($rule['type'] ?? '', 'percentage'); ?>>
                                            <?php _e('Percentuale', 'dpe'); ?>
                                        </option>
                                        <option value="fixed" <?php selected($rule['type'] ?? '', 'fixed'); ?>>
                                            <?php _e('Importo fisso', 'dpe'); ?>
                                        </option>
                                        <option value="tiered" <?php selected($rule['type'] ?? '', 'tiered'); ?>>
                                            <?php _e('A scaglioni', 'dpe'); ?>
                                        </option>
                                        <option value="time_based" <?php selected($rule['type'] ?? '', 'time_based'); ?>>
                                            <?php _e('Basato sull\'orario', 'dpe'); ?>
                                        </option>
                                    </select>
                                </td>
                            </tr>
                            <tr>
                                <th><?php _e('Valore', 'dpe'); ?></th>
                                <td>
                                    <input type="number" name="rules[<?php echo $index; ?>][value]" 
                                           value="<?php echo esc_attr($rule['value'] ?? ''); ?>" 
                                           step="0.01" min="0" placeholder="10">
                                    <span class="value-suffix">%</span>
                                </td>
                            </tr>
                            <tr>
                                <th><?php _e('Categorie', 'dpe'); ?></th>
                                <td>
                                    <?php 
                                    $cats = get_terms(['taxonomy' => 'product_cat', 'hide_empty' => false]);
                                    foreach ($cats as $cat) {
                                        printf(
                                            '<label><input type="checkbox" name="rules[%d][categories][]" value="%d" %s> %s</label><br>',
                                            $index,
                                            $cat->term_id,
                                            checked(in_array($cat->term_id, $rule['categories'] ?? []), true, false),
                                            esc_html($cat->name)
                                        );
                                    }
                                    ?>
                                </td>
                            </tr>
                            <tr>
                                <th><?php _e('Ruoli utente', 'dpe'); ?></th>
                                <td>
                                    <?php 
                                    global $wp_roles;
                                    foreach ($wp_roles->roles as $role_name => $role_info) {
                                        printf(
                                            '<label><input type="checkbox" name="rules[%d][user_roles][]" value="%s" %s> %s</label><br>',
                                            $index,
                                            $role_name,
                                            checked(in_array($role_name, $rule['user_roles'] ?? []), true, false),
                                            esc_html($role_info['name'])
                                        );
                                    }
                                    ?>
                                </td>
                            </tr>
                            <tr>
                                <th><?php _e('Periodo', 'dpe'); ?></th>
                                <td>
                                    <input type="date" name="rules[<?php echo $index; ?>][start_date]" 
                                           value="<?php echo esc_attr($rule['start_date'] ?? ''); ?>">
                                    -
                                    <input type="date" name="rules[<?php echo $index; ?>][end_date]" 
                                           value="<?php echo esc_attr($rule['end_date'] ?? ''); ?>">
                                </td>
                            </tr>
                            <tr>
                                <th><?php _e('Attiva', 'dpe'); ?></th>
                                <td>
                                    <label>
                                        <input type="checkbox" name="rules[<?php echo $index; ?>][active]" 
                                               value="1" <?php checked(!empty($rule['active'])); ?>>
                                        <?php _e('Regola attiva', 'dpe'); ?>
                                    </label>
                                </td>
                            </tr>
                        </table>

                        <button type="button" class="button remove-rule">Rimuovi regola</button>
                        <hr>
                    </div>
                    <?php endforeach; ?>
                </div>

                <p>
                    <button type="button" class="button" id="add-rule">+ Aggiungi regola</button>
                </p>

                <p class="submit">
                    <button type="submit" name="dpe_save" class="button-primary">
                        <?php _e('Salva Regole', 'dpe'); ?>
                    </button>
                </p>
            </form>
        </div>

        <style>
            .rule-box {
                background: #fff;
                padding: 20px;
                margin: 10px 0;
                border: 1px solid #ccc;
                border-radius: 4px;
            }
            .rule-box h3 {
                margin-top: 0;
            }
        </style>

        <script>
        jQuery(document).ready(function($) {
            var ruleIndex = <?php echo count($rules); ?>;

            $('#add-rule').on('click', function() {
                var template = $('.rule-box:first').clone();
                template.attr('data-index', ruleIndex);
                template.find('h3').text('Regola #' + (ruleIndex + 1));
                template.find('input, select').each(function() {
                    var name = $(this).attr('name');
                    if (name) {
                        $(this).attr('name', name.replace(/\[\d+\]/, '[' + ruleIndex + ']'));
                    }
                    $(this).val('');
                });
                template.find('input[type="checkbox"]').prop('checked', false);
                $('#rules-container').append(template);
                ruleIndex++;
            });

            $(document).on('click', '.remove-rule', function() {
                if ($('.rule-box').length > 1) {
                    $(this).closest('.rule-box').remove();
                }
            });
        });
        </script>
        <?php
    }

    /**
     * Salva regole
     */
    private function save_rules($rules) {
        $sanitized = [];

        foreach ($rules as $index => $rule) {
            $sanitized[] = [
                'name' => sanitize_text_field($rule['name'] ?? ''),
                'type' => sanitize_text_field($rule['type'] ?? 'percentage'),
                'value' => floatval($rule['value'] ?? 0),
                'categories' => array_map('intval', $rule['categories'] ?? []),
                'user_roles' => array_map('sanitize_text_field', $rule['user_roles'] ?? []),
                'min_quantity' => intval($rule['min_quantity'] ?? 0),
                'start_date' => sanitize_text_field($rule['start_date'] ?? ''),
                'end_date' => sanitize_text_field($rule['end_date'] ?? ''),
                'active' => !empty($rule['active']),
            ];
        }

        update_option('dpe_rules', $sanitized);
        $this->rules = $sanitized;
    }

    /**
     * Registra impostazioni
     */
    public function register_settings() {
        register_setting('dpe_settings', 'dpe_rules');
    }
}

new Dynamic_Pricing_Engine();

Tipi di Regole Supportate

1. Percentuale - Sconto % su prodotti selezionati
2. Importo fisso - Sconto in €
3. A scaglioni - Più compri, più risparmi
4. Basato sull'orario - Happy hour, orari morti

Risultato atteso: +10-20% margini, +15% conversioni

Best Practices per WooCommerce Plugin Development

1. Performance

// ❌ MAI fare query nel loop
add_action('woocommerce_before_single_product', function() {
    $products = wc_get_products(['limit' => 100]); // Lento!
});

// ✅ Usa transients per caching
add_action('woocommerce_before_single_product', function() {
    $cache_key = 'related_products_' . get_the_ID();
    $products = get_transient($cache_key);

    if (false === $products) {
        $products = wc_get_products(['limit' => 10]);
        set_transient($cache_key, $products, HOUR_IN_SECONDS);
    }
});

2. Sicurezza

// ❌ MAI fidarsi dell'input utente
$price = $_POST['custom_price'];

// ✅ Sanitizza e valida sempre
$price = floatval($_POST['custom_price'] ?? 0);
if ($price < 0 || $price > 999999) {
    wp_die('Prezzo non valido');
}

// ✅ Usa nonce per form
wp_nonce_field('my_action', 'my_nonce');
if (!wp_verify_nonce($_POST['my_nonce'], 'my_action')) {
    wp_die('Security check failed');
}

3. Compatibilità

// ✅ Verifica che WooCommerce sia attivo
if (!class_exists('WooCommerce')) {
    return;
}

// ✅ Usa le versioni minime
add_action('before_woocommerce_init', function() {
    if (class_exists(\Automattic\WooCommerce\Utilities\FeaturesUtil::class)) {
        \Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility('custom_order_tables', __FILE__);
    }
});

// ✅ Hook con priorità corretta
add_filter('woocommerce_product_get_price', 'my_filter', 99, 2); // Priorità alta

4. Debug e Logging

// ✅ Logga errori per debug
if (defined('WP_DEBUG') && WP_DEBUG) {
    error_log('WooCommerce Debug: ' . print_r($data, true));
}

// ✅ Usa WC_Logger
$logger = wc_get_logger();
$logger->info('Messaggio informativo', ['source' => 'my-plugin']);
$logger->error('Errore critico', ['source' => 'my-plugin']);

Come Testare i Tuoi Plugin

Ambiente di Test

# Crea un sito di test con WP-CLI
wp core download --version=latest --path=/var/www/test-site
wp config create --dbname=test_db --dbuser=root --dbpass=password
wp db create
wp core install --url=test.local --title="Test Site" --admin_user=admin --admin_password=password --admin_email=admin@test.local

# Installa WooCommerce
wp plugin install woocommerce --activate

# Crea prodotti di test
wp wc product create --name="Test Product" --regular_price=19.99 --user=admin

# Attiva il tuo plugin
wp plugin activate my-custom-plugin

Unit Testing

// tests/test-my-plugin.php
class MyPluginTest extends WP_UnitTestCase {

    public function test_price_calculation() {
        $product = new WC_Product_Simple();
        $product->set_regular_price(100);
        $product->save();

        $calculated = apply_filters('woocommerce_product_get_price', 100, $product);

        $this->assertLessThan(100, $calculated, 'Il prezzo scontato deve essere minore');
    }
}

Conclusione

Il codice custom per WooCommerce non è solo per sviluppatori esperti. Con gli esempi di questa guida, puoi implementare funzionalità che aumentano concretamente le conversioni del tuo store:

• Upsell intelligente → +15-25% AOV
• Notifiche stock → Recupero 15-25% vendite perse
• Checkout ottimizzato → +20-35% completamento
• Pricing dinamico → +10-20% margini

Prossimi Passi

1. Scegli un plugin dalla lista e implementalo nel tuo ambiente di test
2. Personalizza le regole in base al tuo business
3. Monitora i risultati con Google Analytics e WooCommerce Reports
4. Itera in base ai dati raccolti

Risorse Utili

• WooCommerce Developer Documentation
• WordPress Plugin Developer Handbook
• WooCommerce REST API

Sei uno sviluppatore WordPress? Condividi questa guida con i tuoi clienti e mostragli il valore del codice custom.

Sei uno store owner? Contatta un developer WooCommerce certificato per implementare queste soluzioni sul tuo store.

Hai domande o suggerimenti? Lascia un commento qui sotto!

Guida completa per costruire un e-commerce performante usando WordPress come backend headless e Next.js per il frontend. Dalla configurazione al deployment su Vercel.

🎯 Introduzione: Perché Headless WordPress?

Nel panorama e-commerce del 2026, le aspettative degli utenti sono più alte che mai:

• ⚡ Tempo di caricamento: < 2 secondi
• 📱 Mobile-first: Esperienza nativa su tutti i dispositivi
• 🔒 Sicurezza: Protezione da attacchi e data breach
• 📈 Scalabilità: Gestione di picchi di traffico senza downtime

L'architettura headless separa il backend (WordPress + WooCommerce) dal frontend (Next.js), offrendo:

🏗️ Architettura del Sistema

┌─────────────────────────────────────────────────────────────┐
│                    FRONTEND (Next.js)                       │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   Pagine    │  │  Componenti │  │  Gestione Stato     │  │
│  │   (SSR/SSG) │  │   React     │  │  (Zustand/Redux)    │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                          ↓ HTTPS/API
┌─────────────────────────────────────────────────────────────┐
│              BACKEND (WordPress + WooCommerce)              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │  REST API   │  │  GraphQL    │  │     Database        │  │
│  │  /wp-json   │  │  (WPGraphQL)│  │     MySQL           │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│                    SERVIZI ESTERNI                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │  Stripe     │  │    CDN      │  │     Analytics       │  │
│  │  Payments   │  │  (Vercel)   │  │  (Google/GA4)       │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

📋 Prerequisiti

Requisiti Tecnici

• WordPress: 6.0+ (ultimo: 6.9.4)
• WooCommerce: 8.0+
• PHP: 8.1+
• Node.js: 18.0+ (LTS)
• Next.js: 14.0+

Plugin WordPress Necessari

1. WooCommerce (gratuito) - E-commerce engine
2. WPGraphQL (gratuito) - API GraphQL
3. WPGraphQL for WooCommerce (gratuito) - Estensione WooCommerce
4. Advanced Custom Fields (opzionale) - Campi custom
5. JWT Authentication (gratuito) - Autenticazione API

# Installazione plugin via WP-CLI
wp plugin install woocommerce --activate
wp plugin install wpgraphql --activate
wp plugin install wp-graphql-woocommerce --activate
wp plugin install jwt-authentication-for-wp-rest-api --activate

🚀 Configurazione Backend WordPress

1. Configurazione WPGraphQL

Dopo aver installato i plugin, verifica che le API siano accessibili:

# Test endpoint GraphQL
wp eval 'echo graphql_endpoint();'
# Output: /graphql

2. Configurazione CORS

Aggiungi al file functions.php del tema child:

<?php
// Abilita CORS per il frontend Next.js
add_action('init', function() {
    $allowed_origin = 'https://tuosito.vercel.app';

    header("Access-Control-Allow-Origin: {$allowed_origin}");
    header("Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS");
    header("Access-Control-Allow-Headers: Content-Type, Authorization");
    header("Access-Control-Allow-Credentials: true");
});

3. Ottimizzazione API

// functions.php - Ottimizza risposte API
add_filter('graphql_query_amount_limit', function() {
    return 100; // Limite query per sicurezza
});

// Cache delle risposte API
add_filter('graphql_cache_enabled', '__return_true');

💻 Sviluppo Frontend Next.js

1. Setup Progetto

# Crea nuovo progetto Next.js
npx create-next-app@latest wp-headless-ecommerce --typescript --tailwind --app
cd wp-headless-ecommerce

# Installa dipendenze
npm install @apollo/client graphql
npm install zustand axios
npm install stripe @stripe/stripe-js

2. Configurazione Apollo Client

Crea lib/apollo.ts:

import { ApolloClient, InMemoryCache, HttpLink } from '@apollo/client';

const client = new ApolloClient({
  ssrMode: typeof window === 'undefined',
  link: new HttpLink({
    uri: process.env.NEXT_PUBLIC_WP_GRAPHQL_URL, // https://mrtux.it/graphql
    credentials: 'include',
  }),
  cache: new InMemoryCache({
    typePolicies: {
      Product: {
        keyFields: ['databaseId'],
      },
    },
  }),
});

export default client;

3. Environment Variables

Crea .env.local:

NEXT_PUBLIC_WP_GRAPHQL_URL=https://mrtux.it/graphql
NEXT_PUBLIC_WP_REST_URL=https://mrtux.it/wp-json
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_SECRET_KEY=sk_test_...
NEXT_PUBLIC_SITE_URL=https://tuosito.vercel.app

🛒 Componenti E-commerce

1. Fetch Prodotti da WooCommerce

components/ProductList.tsx:

import { gql, useQuery } from '@apollo/client';

const GET_PRODUCTS = gql`
  query GetProducts($first: Int!) {
    products(first: $first) {
      nodes {
        databaseId
        name
        slug
        description
        price
        regularPrice
        salePrice
        images {
          nodes {
            sourceUrl
            altText
          }
        }
        categories {
          nodes {
            name
            slug
          }
        }
      }
    }
  }
`;

export default function ProductList({ limit = 12 }) {
  const { data, loading, error } = useQuery(GET_PRODUCTS, {
    variables: { first: limit },
  });

  if (loading) return <div>Caricamento...</div>;
  if (error) return <div>Errore: {error.message}</div>;

  return (
    <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
      {data.products.nodes.map((product: any) => (
        <ProductCard key={product.databaseId} product={product} />
      ))}
    </div>
  );
}

2. Carrello con Zustand

store/cartStore.ts:

import { create } from 'zustand';
import { persist } from 'zustand/middleware';

interface CartItem {
  id: number;
  name: string;
  price: number;
  quantity: number;
  image: string;
}

interface CartState {
  items: CartItem[];
  addItem: (item: CartItem) => void;
  removeItem: (id: number) => void;
  updateQuantity: (id: number, quantity: number) => void;
  clearCart: () => void;
  total: () => number;
}

export const useCartStore = create<CartState>()(
  persist(
    (set, get) => ({
      items: [],
      addItem: (item) => {
        const items = get().items;
        const existing = items.find((i) => i.id === item.id);

        if (existing) {
          set({
            items: items.map((i) =>
              i.id === item.id ? { ...i, quantity: i.quantity + 1 } : i
            ),
          });
        } else {
          set({ items: [...items, { ...item, quantity: 1 }] });
        }
      },
      removeItem: (id) =>
        set({ items: get().items.filter((i) => i.id !== id) }),
      updateQuantity: (id, quantity) =>
        set({
          items: get().items.map((i) =>
            i.id === id ? { ...i, quantity } : i
          ),
        }),
      clearCart: () => set({ items: [] }),
      total: () =>
        get().items.reduce((sum, item) => sum + item.price * item.quantity, 0),
    }),
    { name: 'cart-storage' }
  )
);

3. Checkout con Stripe

components/Checkout.tsx:

import { loadStripe } from '@stripe/stripe-js';
import { useCartStore } from '@/store/cartStore';

const stripePromise = loadStripe(process.env.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY!);

export default function Checkout() {
  const { items, total, clearCart } = useCartStore();

  const handleCheckout = async () => {
    const stripe = await stripePromise;

    // Crea sessione checkout su backend
    const response = await fetch('/api/create-checkout-session', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ items }),
    });

    const session = await response.json();

    // Redirect a Stripe
    const result = await stripe!.redirectToCheckout({
      sessionId: session.id,
    });

    if (result.error) {
      alert(result.error.message);
    }
  };

  return (
    <button
      onClick={handleCheckout}
      className="bg-green-600 text-white px-6 py-3 rounded-lg hover:bg-green-700"
    >
      Paga ora (€{total().toFixed(2)})
    </button>
  );
}

📊 Ottimizzazione SEO e Performance

1. Generazione Statica (SSG)

app/products/[slug]/page.tsx:

import { gql } from '@apollo/client';
import { apolloClient } from '@/lib/apollo';

export async function generateStaticParams() {
  const { data } = await apolloClient.query({
    query: gql`
      query GetProductSlugs {
        products(first: 100) {
          nodes {
            slug
          }
        }
      }
    `,
  });

  return data.products.nodes.map((product: any) => ({
    slug: product.slug,
  }));
}

export default async function ProductPage({ params }: { params: { slug: string } }) {
  // Fetch dati prodotto...
  return <div>...</div>;
}

2. Metadata Dinamici

export async function generateMetadata({ params }: { params: { slug: string } }) {
  const product = await getProduct(params.slug);

  return {
    title: `${product.name} | MRTUX E-commerce`,
    description: product.description,
    openGraph: {
      images: [product.image],
    },
  };
}

3. Image Optimization

import Image from 'next/image';

<Image
  src={product.image}
  alt={product.name}
  width={400}
  height={400}
  priority
  className="rounded-lg"
/>

🔒 Sicurezza

1. Rate Limiting API

middleware.ts:

import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';

export function middleware(request: NextRequest) {
  // Rate limiting semplice
  const ip = request.ip ?? '127.0.0.1';
  // Implementa logica rate limiting...

  return NextResponse.next();
}

2. Validazione Input

// API Route - /api/create-checkout-session
import { NextRequest, NextResponse } from 'next/server';

export async function POST(request: NextRequest) {
  try {
    const body = await request.json();

    // Valida input
    if (!body.items || !Array.isArray(body.items)) {
      return NextResponse.json(
        { error: 'Invalid cart data' },
        { status: 400 }
      );
    }

    // Procedi con creazione sessione Stripe...
  } catch (error) {
    return NextResponse.json(
      { error: 'Internal server error' },
      { status: 500 }
    );
  }
}

🚀 Deployment su Vercel

1. Connetti Repository GitHub

# Inizializza git
git init
git add .
git commit -m "Initial commit: WP Headless E-commerce"

# Push su GitHub
git remote add origin https://github.com/tuo-username/wp-headless-ecommerce.git
git push -u origin main

2. Configura Vercel

1. Vai su vercel.com
2. Importa il repository GitHub
3. Configura le environment variables
4. Deploy automatico ad ogni push

3. Custom Domain

# Aggiungi dominio su Vercel Dashboard
# mrtux-shop.vercel.app → shop.mrtux.it

📈 Monitoraggio e Analytics

1. Google Analytics 4

components/GoogleAnalytics.tsx:

import Script from 'next/script';

export default function GoogleAnalytics() {
  return (
    <>
      <Script
        strategy="afterInteractive"
        src={`https://www.googletagmanager.com/gtag/js?id=${process.env.NEXT_PUBLIC_GA_ID}`}
      />
      <Script
        id="gtag-init"
        strategy="afterInteractive"
        dangerouslySetInnerHTML={{
          __html: `
            window.dataLayer = window.dataLayer || [];
            function gtag(){dataLayer.push(arguments);}
            gtag('js', new Date());
            gtag('config', '${process.env.NEXT_PUBLIC_GA_ID}');
          `,
        }}
      />
    </>
  );
}

2. Vercel Analytics

import { Analytics } from '@vercel/analytics/react';

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Analytics />
      </body>
    </html>
  );
}

📊 Caso Studio: Sito da 10K Visite/Giorno

Performance Prima/Dopo

Costi Mensili

🎯 Conclusioni

L'architettura headless con WordPress + Next.js offre:

✅ Performance superiori - Caricamento < 1 secondo
✅ SEO eccellente - SSR/SSG per indicizzazione ottimale
✅ Sicurezza migliorata - API isolate, niente esposizione diretta del backend
✅ Scalabilità illimitata - CDN globale di Vercel
✅ Developer Experience - React moderno + WordPress familiare

Quando Scegliere Headless

• 📈 Traffico > 5K visite/giorno
• 🛒 E-commerce con checkout custom
• 🎨 Design altamente personalizzato
• 🌍 Audience globale (CDN essenziale)

Quando Evitare

• 📝 Blog semplice (< 1K visite/giorno)
• 💰 Budget limitato (< €50/mese)
• 👤 Team senza competenze React/Node

📚 Risorse Utili

• Documentazione Next.js
• WPGraphQL Documentation
• WooCommerce REST API
• Vercel Deployment Guide
• Stripe Integration

Hai trovato utile questa guida? Condividi i tuoi risultati nei commenti o contattaci per una consulenza personalizzata sulla tua architettura e-commerce!

Pubblicato su mrtux.it - 4 Aprile 2026
Categoria: Sviluppo WordPress, E-commerce, Next.js

Gestire un negozio WooCommerce con oltre 10.000 prodotti può essere una sfida, soprattutto quando le prestazioni del sito iniziano a risentirne. Un database non ottimizzato può causare tempi di caricamento lenti, query inefficienti e persino crash del server, compromettendo l’esperienza utente e le conversioni.

In questo articolo, esploreremo tecniche avanzate per ottimizzare il database di WooCommerce, garantendo prestazioni fluide anche con un catalogo esteso. Dalla pulizia dei dati ridondanti all’indicizzazione delle tabelle, scoprirai come mantenere il tuo e-commerce veloce e reattivo.

1. Perché l’Ottimizzazione del Database è Cruciale per WooCommerce

WooCommerce si affida pesantemente al database MySQL per gestire prodotti, ordini, recensioni e altri dati. Con migliaia di prodotti, le tabelle crescono rapidamente, generando query complesse che possono rallentare il backend e il frontend.

Problemi comuni con database non ottimizzati:

• Tempi di risposta lenti nelle pagine del negozio.
• Carico elevato sul server, con picchi di CPU e RAM.
• Difficoltà nella gestione degli ordini e nell’aggiornamento dell’inventario.

Un’ottimizzazione mirata migliora non solo la velocità, ma anche la stabilità del sito, riducendo il rischio di downtime durante i picchi di traffico.

2. Analisi e Pulizia del Database WooCommerce

Prima di ottimizzare, è essenziale identificare i dati ridondanti. WooCommerce accumula nel tempo informazioni non necessarie, come:

• Revisioni di prodotti non utilizzate.
• Transienti scaduti (opzioni temporanee).
• Ordini e carrelli abbandonati.

Strumenti per la Pulizia del Database

• WP-Optimize: Plugin che elimina dati inutili e compatta le tabelle.
• Advanced Database Cleaner: Rimuove transienti, post duplicati e spam.
• Query manuali SQL: Per eliminare record obsoleti direttamente via phpMyAdmin.

Esempio di query per eliminare revisioni dei prodotti:

DELETE FROM wp_posts WHERE post_type = 'revision';  

3. Ottimizzazione delle Tabelle MySQL

Le tabelle WooCommerce possono frammentarsi nel tempo, riducendo l’efficienza delle query. Una manutenzione regolare include:

A. Deframmentazione e Ottimizzazione

Esegui periodicamente:

OPTIMIZE TABLE wp_woocommerce_order_items, wp_woocommerce_order_itemmeta;  

B. Indicizzazione delle Colonne Frequenti

Aggiungi indici alle colonne usate spesso nelle query, come _product_id o _order_id:

ALTER TABLE wp_woocommerce_order_itemmeta ADD INDEX (meta_key(50));  

4. Configurazione di WooCommerce per Cataloghi Grandi

A. Disattiva Funzionalità Non Necessarie

• Recensioni dei prodotti: Se non utilizzate, disattivale da WooCommerce > Impostazioni > Prodotti.
• Cron job ridondanti: Usa Action Scheduler per gestire i task in background in modo efficiente.

B. Limita i Dati Caricati nelle Query

Modifica le query predefinite per evitare di recuperare troppi dati:

add_filter( 'woocommerce_product_query', function( $query ) {  
    $query->set( 'posts_per_page', 50 ); // Limita i prodotti per pagina  
});  

5. Caching e Scalabilità per Database di Grandi Dimensioni

A. Utilizza un Caching Avanzato

• Object Caching (Redis/Memcached): Riduce le query ripetute al database.
• Transients API: Memorizza dati temporanei invece di interrogare il DB ogni volta.

B. Scalabilità Orizzontale del Database

Per negozi con milioni di prodotti:

• Replica MySQL: Distribuisci il carico su più server.
• Sharding: Suddividi le tabelle in database separati.

6. Monitoraggio e Manutenzione Continua

Usa strumenti come:

• New Relic o Query Monitor per tracciare query lente.
• MySQL Slow Query Log per identificare colli di bottiglia.

Pianifica backup e ottimizzazioni regolari per evitare degradazioni delle prestazioni nel tempo.

Conclusione

Ottimizzare il database di WooCommerce per 10.000+ prodotti richiede una combinazione di pulizia, indicizzazione, caching e configurazioni avanzate. Seguendo queste best practice, il tuo negozio rimarrà veloce e scalabile, migliorando l’esperienza utente e il tasso di conversione.

Investi nella manutenzione proattiva del database: i risultati si tradurranno in un e-commerce più efficiente e redditizio.

Creare un negozio online è diventato più accessibile che mai grazie a WordPress e WooCommerce. WooCommerce, il plugin ecommerce più popolare al mondo, trasforma qualsiasi sito WordPress in una piattaforma di vendita completa, offrendo flessibilità, personalizzazione e scalabilità.

Che tu sia un principiante o un esperto, configurare correttamente WooCommerce è essenziale per garantire un'esperienza d'acquisto fluida per i clienti e una gestione efficiente per te. In questa guida completa, esploreremo passo dopo passo come impostare WooCommerce per vendere online in modo professionale, ottimizzato e sicuro.

1. Preparazione Iniziale: Requisiti e Installazione

1.1 Scegliere un Hosting e Dominio

Prima di iniziare, assicurati di avere:

• Un dominio professionale (es. iltuonegozio.com)
• Un hosting performante (consigliati: SiteGround, Kinsta, o WP Engine)
• WordPress installato (versione più recente)

1.2 Installare WooCommerce

1. Vai su Plugin > Aggiungi Nuovo in WordPress.
2. Cerca "WooCommerce" e clicca Installa.
3. Dopo l'installazione, clicca Attiva.

1.3 Configurazione Iniziale

Al primo avvio, WooCommerce avvierà una procedura guidata per:

• Impostare la posizione del negozio (Paese, valuta).
• Definire i metodi di pagamento (PayPal, carta di credito).
• Configurare le spedizioni e le tasse.

2. Personalizzazione del Negozio Online

2.1 Scegliere un Tema WooCommerce-Compatible

Un tema ottimizzato per WooCommerce migliora l’esperienza utente. Alcune opzioni consigliate:

• Astra (leggero e personalizzabile)
• Shopify (design moderno)
• Flatsome (per ecommerce avanzati)

2.2 Configurare Pagine Principali

WooCommerce crea automaticamente:

• Shop (pagina prodotti)
• Carrello
• Checkout
• Il mio account

Verifica che siano correttamente impostate in WooCommerce > Impostazioni > Pagine.

2.3 Aggiungere Prodotti

1. Vai su Prodotti > Aggiungi nuovo.
2. Inserisci:
   • Nome e descrizione
   • Immagini professionali
   • Prezzo e inventario
   • Categorie e tag

Consiglio: Usa varianti prodotto (es. colori, taglie) se necessario.

3. Configurazione Avanzata per Massimizzare le Vendite

3.1 Metodi di Pagamento

Attiva almeno due opzioni di pagamento:

• PayPal (facile e sicuro)
• Stripe (per carte di credito)
• Bonifico bancario

Configurale in WooCommerce > Impostazioni > Pagamenti.

3.2 Gestione delle Spedizioni

• Definisci zone di spedizione (Italia, UE, mondiale).
• Imposta corrieri (Poste Italiane, DHL, GLS).
• Aggiungi spese di spedizione gratuite sopra una certa soglia.

3.3 Tasse e Fatturazione

Configura le aliquote IVA in WooCommerce > Impostazioni > Tasse. Se vendi in Italia, imposta:

• 22% per prodotti standard
• 4% o 10% per beni agevolati

3.4 Sicurezza e GDPR

• Installa SSL (obbligatorio per i pagamenti).
• Aggiungi una Privacy Policy e Termini di Servizio.
• Usa plugin come GDPR Cookie Consent per la conformità.

4. Ottimizzazione SEO e Marketing

4.1 SEO per WooCommerce

• Usa Yoast SEO o Rank Math per ottimizzare:
  • Titoli e meta descrizioni
  • URL ottimizzati
  • Schema markup per prodotti

4.2 Plugin per Aumentare le Vendite

• WooCommerce Discounts: sconti e coupon.
• WooCommerce Subscriptions: vendite ricorrenti.
• Mailchimp per WooCommerce: email marketing.

4.3 Google Analytics e Facebook Pixel

Collega il tuo negozio a:

• Google Analytics per tracciare visite e conversioni.
• Facebook Pixel per remarketing.

5. Manutenzione e Scalabilità

5.1 Backup e Aggiornamenti

• Usa UpdraftPlus per backup automatici.
• Mantieni WordPress, WooCommerce e i plugin sempre aggiornati.

5.2 Monitoraggio delle Prestazioni

• Ottimizza le immagini con Smush.
• Usa caching con WP Rocket o LiteSpeed Cache.

5.3 Scalabilità

Se il tuo negozio cresce, valuta:

• Hosting dedicato o VPS.
• CDN (Cloudflare) per velocità globale.

Conclusione

Configurare WooCommerce in modo professionale richiede attenzione ai dettagli, ma con questa guida hai tutti gli strumenti per creare un negozio online di successo. Dalla scelta dell’hosting all’ottimizzazione SEO, ogni passaggio è cruciale per garantire un’esperienza d’acquisto fluida e conversioni elevate.

Inizia oggi stesso e trasforma la tua passione in un business redditizio con WooCommerce!