HS Product Filters — guida utente

Cambio di edizione — Free 1.2 / Pro 0.2: creare o modificare pagine filtro dedicate, collegamenti con URL leggibili, indicizzazione selettiva, titoli e descrizioni richiede Pro. Free conserva il noindex automatico e continua a mostrare senza modifiche le pagine SEO già salvate. Rimuovere Pro non elimina né riscrive queste configurazioni.

Per Free 1.2 / Pro 0.2. Prova su una copia di staging prima della distribuzione. La presentazione supportata è un solo catalogo Product Filters tramite shortcode in una pagina WordPress. Non sostituisce un archivio WooCommerce esistente o un widget prodotti Elementor.

Crea il primo catalogo

1. Installa lo ZIP Product Filters in un sito con WooCommerce attivo. Il pacchetto richiede WordPress 6.8 o successivo e PHP 8.2 o successivo; combinazioni verificate e limiti sono elencati sotto.
2. Apri HookSpark → Product Filters e crea un gruppo. Dagli un nome comprensibile per i clienti: il catalogo lo usa come titolo.
3. Scegli la categoria che definisce la collezione oppure usa l’intero catalogo. Sotto Sottocategorie, scegli Includi le sottocategorie , valore predefinito per gruppi nuovi ed esistenti, oppure Solo assegnazioni dirette alla categoria. La scelta vale sia per il perimetro del catalogo sia per i filtri di categoria. Il perimetro resta quando il visitatore azzera le selezioni. Un prodotto assegnato esplicitamente sia alla categoria principale sia a quella figlia può corrispondere a entrambe le assegnazioni dirette, ma conta una sola volta.
4. Scegli fino a otto sorgenti dei filtri: categorie, tag, brand WooCommerce quando registrati e attributi globali dei prodotti. Crea prima in WooCommerce gli attributi globali mancanti; gli attributi personalizzati del singolo prodotto non sono sorgenti in questa anteprima.
5. Usa l’anteprima per provare combinazioni. Mostra al massimo sei schede prodotto corrispondenti, ma il totale conta tutti i risultati. Le liste lunghe sono ridotte a 30 valori nell’anteprima dell’editor.
6. Salva il gruppo e attivalo quando è pronto. Copia lo shortcode generato in un blocco Shortcode di una pagina WordPress. Usa una sola griglia nella pagina. Pubblica con la normale procedura WordPress.
7. Apri la pagina senza accesso, prova filtri e ordinamento e poi verifica da telefono.

Uno shortcode tipico è [hs_product_filters set="YOUR_SET_ID"]. Copia il valore effettivo dall’editor: il nome del gruppo non è il suo ID. Per una pagina SEO collegata esplicitamente segui la guida SEO.

Come funzionano le corrispondenze

Più valori nello stesso filtro sono alternativi: Prugna oppure Lavanda. Filtri diversi si combinano: Prugna e S. Un prodotto variabile deve avere una singola variante idonea che soddisfi insieme tutti gli attributi, prezzo e disponibilità selezionati. Una variante Prugna/S e una Lavanda/M non fanno corrispondere il prodotto a Prugna/M.

Una variante configurata con Qualsiasi valore può corrispondere ai valori assegnati al prodotto principale per quell’attributo. Gli antenati delle categorie sono inclusi quando il gruppo include sottocategorie. L’anteprima supporta prodotti semplici e variabili; non valuta attualmente prodotti raggruppati, esterni o personalizzati.

Il catalogo include prodotti pubblicati, visibili pubblicamente, acquistabili e con prezzo. I prodotti protetti da password sono esclusi. Viene rispettata l’impostazione WooCommerce che nasconde gli esauriti: se nasconde un articolo, scegliere Esaurito non lo rende visibile.

Ogni prodotto principale compare una volta. La scheda usa immagine, prezzo e collegamento della variante corrispondente meno costosa. Se non ha un’immagine, WooCommerce usa quella principale; se manca anche quella, mostra il segnaposto standard. Lo stesso vale nell’anteprima amministrativa, che spiega anche che tutti i filtri devono corrispondere alla stessa variante o prodotto semplice, identifica la variante meno costosa e ne elenca attributi accanto all’ID. Questi dettagli diagnostici non compaiono nelle schede pubbliche. Il collegamento porta alla normale pagina WooCommerce per scegliere o acquistare: filtrare non cambia quantità nel carrello, scorte o prezzi di catalogo.

Conteggi, prezzi e ordinamento

Il numero accanto a un valore conta prodotti principali distinti. Considera gli altri gruppi di filtri ignorando quello corrente, così il cliente vede le alternative. Aggiungere più valori dello stesso gruppo non conta più volte il medesimo prodotto.

Prezzo minimo e massimo sono inclusi e usano il prezzo WooCommerce visualizzato con la precisione della valuta configurata, da zero a sei decimali. Usa punto o virgola per i decimali, senza separatori delle migliaia. Un intervallo invertito viene rifiutato. I prezzi non validi conservano i valori inseriti e mostrano un messaggio accanto al campo con riepilogo degli errori collegato. Dopo l’applicazione il focus va al primo prezzo non valido; su telefono il pannello si apre per la correzione. Integrazioni fiscali e di valuta richiedono comunque prove nel negozio effettivo.

Le disponibilità sono Qualsiasi disponibilità, Disponibile, Ordinabile e Esaurito. L’ordinamento supporta ordine di catalogo, prezzo crescente, prezzo decrescente e più recenti. La griglia pubblica mostra dodici prodotti per pagina.

Cambia o azzera le selezioni

Con JavaScript i comandi aggiornano la griglia senza ricaricare tutta la pagina. Applica filtri funziona anche come normale navigazione. L’URL registra le scelte applicate e Indietro/Avanti del browser le ripristina. Se gli aggiornamenti si sovrappongono, una risposta vecchia non sostituisce una selezione nuova. Gli aggiornamenti automatici conservano il focus sul controllo corrente, anche se passi al successivo mentre una richiesta è in attesa. Applicazione, azzeramento e paginazione spostano il focus ai risultati aggiornati; gli errori di validazione prevalgono.

I valori scelti compaiono sopra la griglia come etichette rimovibili. Rimuovine uno per conservare gli altri; il catalogo torna a pagina uno. Azzera ripristina il catalogo originale o il singolo filtro assegnato alla pagina SEO. Fino a 650 px, Filtra prodotti apre un pannello modale. Le scelte restano una bozza fino a Applica filtri. Annulla modifiche, Esc o chiusura sullo sfondo ripristinano le scelte applicate e riportano il focus al pulsante di apertura. Passare alla larghezza desktop annulla la bozza. I conteggi riflettono lo stato applicato e si aggiornano dopo l’applicazione; non c’è anteprima del numero di risultati della bozza. Senza JavaScript resta utilizzabile il normale modulo espandibile.

Una combinazione senza risultati mostra comandi di recupero. Rimuovi un’etichetta, amplia i prezzi o azzera. Una pagina filtrata non valida o vuota restituisce 404 e noindex: non significa che la pagina WordPress originale sia stata eliminata. Se una richiesta AJAX fallisce, i risultati precedenti restano visibili con errore e Riprova aggiornamento. Il comando ripete l’operazione fallita, compresa la rimozione di un filtro. Una nuova richiesta supera risposte ed errori precedenti.

SEO e URL leggibili

Crea una pagina WordPress normale con un indirizzo leggibile per una collezione utile con un solo filtro, poi collegala in Pagine SEO. Controlli titolo, descrizione e indicizzazione. Salvare il collegamento non pubblica la pagina e non supera la visibilità del sito WordPress.

Soltanto una pagina attivata esplicitamente, esatta e non vuota può essere idonea all’indicizzazione. Filtri aggiuntivi, limiti di prezzo, ordinamento e paginazione restano noindex e non ereditano la descrizione editoriale. Il plugin non genera migliaia di percorsi leggibili per combinazioni arbitrarie. Consulta la guida SEO a configurazione e recupero prima di abilitare l’indicizzazione.

Gestisci i gruppi in sicurezza

Cerca per nome nella lista. Copiare un gruppo crea una copia inattiva da adattare prima dell’uso. Spostarlo nel Cestino richiede il nome; ripristinarlo lo lascia inattivo. Un gruppo disabilitato, mancante o nel Cestino mostra un messaggio di indisponibilità e un collegamento al normale negozio invece del vecchio catalogo.

Le modifiche non salvate attivano un avviso di navigazione. I salvataggi rifiutati conservano i valori inseriti e identificano il primo campo non valido. Se qualcuno salva prima un’altra revisione, ricarica e confronta la configurazione aggiornata prima di riprovare; non presumere che il vecchio modulo abbia sovrascritto il suo lavoro.

Recupera una configurazione precedente

Apri un gruppo salvato e trova Configurazioni precedenti sotto l’anteprima. Vengono conservate le ultime dieci configurazioni modificate del gruppo. Scegli Carica revisione … come bozza per controllare nome, sorgenti e categoria precedenti. Questo non cambia il catalogo salvato. La bozza recuperata è inattiva: controllala, salva quando è pronta e attivala esplicitamente se serve.

Salvare la bozza recuperata conserva la configurazione sostituita, così puoi recuperare anche quella. I salvataggi concorrenti sono rifiutati. Se una categoria o sorgente precedente non esiste più, l’editor spiega il problema e mostra la configurazione corrente. Pagine SEO e altri gruppi non cambiano. Le copie iniziano con cronologia vuota; il Cestino conserva la cronologia. Non è possibile ricostruire versioni precedenti all’installazione della funzione.

L’anteprima accetta al massimo 100 gruppi, inclusi quelli nel Cestino, e 100 collegamenti SEO. Sono limiti tecnici, non livelli di piano a pagamento. Non mantenere copie di prova inutili nella configurazione pubblica.

Demo e compatibilità

La demo Product Filters usa prodotti di studio inventati e immagini originali. La demo amministrativa personale dura un’ora, con sottosito WordPress isolato e account limitato. Consente impostazioni dei filtri e pagine SEO fornite; non concede pubblicazione generale di pagine, caricamenti, installazione plugin o gestione rete. Le pagine demo restano noindex. Gli URL personali di sessione scadono.

Combinazioni verificate: WordPress 6.8 con WooCommerce 10.6.0 e WordPress 7.1.1 con WooCommerce 11.1.0, entrambe su PHP 8.2.29. Le prove minime usano lo ZIP distribuito installato e coprono filtri, SEO, conservazione dati e una verifica essenziale nel browser. Sono prove per quegli ambienti, non certificano ogni versione sopra i minimi. Filtri shortcode su pagina singola, regole SEO, corrispondenza varianti e demo multisito hanno controlli automatici. Yoast SEO 28.5 e Rank Math 1.0.278 hanno superato verifiche HTTP di metadati, robots, canonical e sitemap XML effettive su WordPress 7.1.1, WooCommerce 11.1.0 e PHP 8.2.29. Anche Yoast 27.9 e Rank Math 1.0.278 hanno superato le prove minime. Yoast 28.5 richiede WordPress 6.9 o successivo e non è stato forzato su 6.8. Altre versioni restano non verificate. Più griglie, adattatori per archivi o builder, integrazioni multilingua e altri gestori multivaluta restano fuori dal perimetro verificato.

I grandi cataloghi richiedono ancora ottimizzazione. Il motore scansisce il catalogo idoneo a ogni valutazione; l’elaborazione in gruppi riduce le query ma non elimina il lavoro. Una misura locale con 50.000 prodotti semplici ha richiesto circa 10 secondi. Non usarla come garanzia di hosting o dichiarazione di idoneità ai grandi negozi.

Risoluzione dei problemi

Problema	Che cosa controllare
Catalogo non disponibile	Conferma ID dello shortcode, gruppo salvato e attivazione; se opportuno ripristina un gruppo dal Cestino e poi attivalo.
Manca un attributo	Usa un attributo globale WooCommerce, assegna i termini ai prodotti e selezionalo nel gruppo.
Manca la variante attesa	Controlla che la stessa variante soddisfi tutte le condizioni, abbia un prezzo e sia disponibile secondo la visibilità del negozio.
Un vecchio URL viene rifiutato	Un elemento usato dal filtro può essere stato rimosso: aggiorna le impostazioni e i link interessati.
Il titolo SEO è generico	Un filtro aggiuntivo, un ordinamento o un numero di pagina possono rendere l’URL una combinazione di navigazione invece della pagina SEO esatta.
Il noindex resta dopo l’attivazione della pagina	Controlla visibilità WordPress e restrizioni SEO esistenti: l’interruttore Product Filters non può rimuoverle.
L’anteprima è lenta	Misura catalogo effettivo ed estensioni installate; l’indice per grandi cataloghi è ancora in sviluppo.
Il salvataggio segnala una modifica concorrente	Ricarica la configurazione aggiornata, confronta le modifiche e salva consapevolmente.

Disabilitare il plugin conserva la configurazione e non elimina prodotti WooCommerce o pagine native. Lo shortcode richiede il plugin attivo: rimuovilo o sostituiscilo se ritiri la pagina catalogo. Rimuovere il plugin non elimina automaticamente i prodotti. Conserva un backup prima di aggiornamenti o pulizie. Conservazione di configurazione, collegamenti SEO, cronologia e Cestino dopo disattivazione e riattivazione, aggiornamenti da 0.8.2 a 0.8.3, reinstallazioni e disinstallazione con reinstallazione è stata verificata su WordPress 6.8 e WooCommerce 10.6.0 con il pacchetto effettivo 0.8.3-dev. Una nuova attivazione non crea né abilita un gruppo. Questo non certifica ogni combinazione esterna.

Adatta l’aspetto al tema

Il catalogo eredita carattere e colore del testo circostanti. Controlli e schede usano i valori base e contrasto della tavolozza WordPress se presenti. Gli stili si applicano alle classi HookSpark; lo shortcode gestisce la propria griglia e non cambia quella del negozio del tema. Gli adattatori per archivi nativi e griglie dei builder restano non verificati.

Per un colore locale limita il CSS al catalogo o alla sezione che lo contiene. Per esempio, .my-catalog { --hs-pf-accent: #006446; --hs-pf-on-accent: #ffffff; } cambia la coppia di colori principali solo in quel contenitore. Altre proprietà facoltative sono --hs-pf-surface, --hs-pf-border, --hs-pf-control-border e --hs-pf-soft. Il bordo dei controlli riguarda campi prezzo, selettori e annullamento del pannello; quello decorativo resta distinto. Scegli coppie leggibili di testo e sfondo e controlla da computer e telefono dopo la personalizzazione.

Controlla le pagine prima di rimuovere un gruppo

Nella lista dei gruppi scegli Controlla le pagine interessate prima di Sposta nel cestino. La lista in sola lettura unisce shortcode espliciti nelle pagine native e collegamenti SEO salvati, elimina duplicati e rimanda agli editor se l’account può modificarli. Include bozze, non pagine inaccessibili o nel Cestino. File dei modelli e archivi dei builder richiedono controllo separato. La verifica viene eseguita solo su richiesta.

Spostare un gruppo nel Cestino richiede il nome salvato esatto. Non elimina pagine o contenuti editoriali. Il catalogo non disponibile offre un link al negozio. Ripristina il gruppo inattivo, controlla le impostazioni e riattivalo quando è pronto.

Cambio valuta collaudato

FOX Currency Switcher 1.5.4 è stato provato su WordPress 6.8, WooCommerce 10.6.0 e PHP 8.2.29 con USD/EUR, cambi fissi di prova, aggiornamenti automatici disattivati, archiviazione transient predefinita e pagina shortcode senza cache. Prezzi nativi, etichette valuta e confronti minimo/massimo concordano in questa configurazione. Il selettore ricarica la pagina e azzera le scelte AJAX: scegli prima la valuta, poi i filtri. Non è promessa la conversione automatica di un importo filtro già inserito.

L’archiviazione con cookie ha mostrato aggiornamenti ritardati e non è supportata da questo risultato. GeoIP, prezzi fissi per prodotto, negozi in cache, conversione a checkout e pagamento e altri fornitori non sono stati verificati. FOX è facoltativo e non è incluso nello ZIP Product Filters.

Navigazione dell’area di lavoro

Usa Tutti i gruppi di filtri per i cataloghi, Pagine SEO per collezioni indicizzabili, Inizia qui per la configurazione e Plugin HookSpark per il catalogo della suite. Il catalogo legge lo stato delle installazioni locali: aprirlo non attiva né installa plugin. Le modifiche non salvate mantengono la conferma condivisa di uscita dalla pagina.

Lettura del catalogo e compatibilità

Il plugin sceglie automaticamente come leggere il catalogo. I dati standard sono letti in gruppi limitati; prezzi personalizzati, idoneità, archivi prodotto o callback di query rilevati usano gli oggetti nativi WooCommerce. Anche offerte programmate e dati fiscali importati insoliti passano dai prezzi nativi. Non c’è una modalità da configurare. Le prestazioni dipendono da dimensioni e integrazioni: prova cataloghi rappresentativi su staging. Non sono ancora state completate tutte le prove su cataloghi di grandi dimensioni e accessi simultanei.

Se il catalogo non è leggibile, compare un’indisponibilità temporanea invece di un falso risultato vuoto. La pagina restituisce un errore temporaneo del server con noindex e no-cache: riprova dopo aver risolto la causa. Le richieste automatiche dei filtri conservano i risultati esistenti se falliscono.

Posizione delle azioni amministrative (candidato 0.8.3)

Crea un gruppo da Tutti i gruppi di filtri o Inizia qui. Nell’editor Salva gruppo di filtri e Aggiorna anteprima restano insieme sotto la configurazione; salvare è l’azione principale. Lo shortcode compare solo dopo il salvataggio. Restano le quattro schede condivise, compreso il catalogo HookSpark. La ricerca resta accanto al suo campo.

Cache delle pagine e CDN

Escludi dalla cache dell’intera pagina tutte quelle con shortcode Product Filters, compresi catalogo iniziale senza filtri e pagine SEO. Svuota le copie in cache dopo aver aggiunto lo shortcode o aggiornato il plugin. Mantieni la normale cache per pagine estranee e risorse statiche.

Il plugin invia istruzioni private/no-store e imposta il consueto indicatore WordPress per saltare la cache prima di mostrare queste pagine. I prezzi possono dipendere da valuta, imposte o cliente prima ancora di scegliere un filtro. Una cache che serve HTML prima di WordPress o ignora queste istruzioni richiede esclusioni esplicite per URL. Le istruzioni non certificano un plugin cache o una CDN: verifica l’esclusione su staging.

Lingua dell’interfaccia

Sono incluse le traduzioni inglese e italiana. WordPress sceglie la lingua del frontend dal sito e quella amministrativa dalla preferenza dell’utente. I risultati usano il singolare per una corrispondenza e il plurale per zero o più corrispondenze. Nomi dei cataloghi, testi prodotto ed etichette delle tassonomie restano contenuti del venditore: il plugin non li traduce automaticamente.

WP Super Cache 3.1.3 in modalità Simple è stato verificato su WordPress 6.8, WooCommerce 10.6.0 e PHP 8.2.29: una pagina ordinaria arrivava dalla cache, mentre catalogo iniziale, filtrato e SEO restavano aggiornati. La prova usava cache per soli anonimi e corrispondenza dei permalink con barra finale. Modalità Expert, CDN, proxy e altre cache richiedono verifiche separate. Elimina eventuale cache precedente del catalogo quando aggiorni.