WooCommerce: cercare i prodotti tramite SKU

Perché cercare prodotti tramite SKU in WooCommerce

La possibilità di cercare un prodotto usando lo SKU non è solo una comodità: è una funzionalità essenziale in contesti professionali, specialmente nei siti WooCommerce dedicati al B2B, alla vendita all’ingrosso o alla gestione di cataloghi estesi.

Cos’è lo SKU e a cosa serve

Lo SKU (Stock Keeping Unit) è un codice univoco che identifica ogni prodotto o variante all’interno del tuo catalogo. Può essere alfanumerico, basato su logica interna, codici a barre o riferimenti del fornitore.

In WooCommerce, ogni prodotto può avere un SKU univoco assegnato direttamente nel pannello prodotto.

Quando è utile cercare per SKU (frontend + backend)

Ecco alcuni casi reali in cui la ricerca per SKU fa la differenza:

• ✅ eCommerce B2B: clienti abituali cercano il prodotto direttamente da un codice interno o da un listino.
• ✅ Siti con migliaia di articoli: la ricerca per nome può restituire troppi risultati generici.
• ✅ Operatori e staff: chi gestisce gli ordini o risponde all’assistenza trova subito l’articolo con lo SKU.
• ✅ Varianti simili: per i prodotti con molte opzioni (es. taglie, colori), lo SKU è spesso il riferimento più preciso.

In sintesi: più è complesso il tuo catalogo, più è strategico abilitare la ricerca per SKU.

Abilitare la ricerca per SKU nel front-end (senza plugin)

WooCommerce, di default, non include il campo SKU nella ricerca interna del sito. Questo significa che se un utente digita uno SKU nel campo di ricerca, non otterrà alcun risultato, anche se il prodotto esiste.

Fortunatamente, è possibile estendere la funzionalità del motore di ricerca nativo tramite uno snippet PHP.

add_filter('posts_search', 'custom_search_by_sku', 9999, 2);
function custom_search_by_sku($search, $wp_query) {
    global $wpdb;

    // Solo per frontend e ricerche WooCommerce
    if ( is_admin() || ! is_search() || ! isset($wp_query->query_vars['s']) ) return $search;

    $search_term = sanitize_text_field($wp_query->query_vars['s']);
    if (empty($search_term)) return $search;

    // Applichiamo solo alla ricerca dei prodotti
    $post_types = (array) $wp_query->query_vars['post_type'] ?? ['product'];
    if (!in_array('product', $post_types)) return $search;

    // Cerchiamo il prodotto tramite SKU
    $product_id = wc_get_product_id_by_sku($search_term);
    if (!$product_id) return $search;

    // Se è una variante, otteniamo il prodotto genitore
    $product = wc_get_product($product_id);
    if ($product && $product->is_type('variation')) {
        $product_id = $product->get_parent_id();
    }

    // Modifichiamo la query per includere il prodotto trovato
    $search = preg_replace(
        "/AND\s+\(\s*(((.*?))\s*)\)/",
        "AND ((({$wpdb->posts}.ID IN ({$product_id})) OR $1))",
        $search,
        1
    );

    return $search;
}