# DataFirefly Group Catalog: nascondere prodotti per gruppo clienti e catalogo su tablet

> Installazione Installate il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP. All'installazione il modulo crea le sue tabelle, registra i suoi hook e aggiunge…

- Pagina: <https://www.datafirefly.com/it/documentation/dfgroupcatalog/>
- Lingua: it
- Aggiornato il: 2026-09-29
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfgroupcatalog/index.md), [en](https://www.datafirefly.com/en/documentation/dfgroupcatalog/index.md), [es](https://www.datafirefly.com/es/documentation/dfgroupcatalog/index.md), [de](https://www.datafirefly.com/de/documentation/dfgroupcatalog/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfgroupcatalog/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfgroupcatalog/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfgroupcatalog/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Installazione

Installate il modulo da **Moduli > Gestione moduli > Carica un modulo** inviando il file ZIP. All'installazione il modulo crea le sue tabelle, registra i suoi hook e aggiunge la scheda **Catalogo > Visibilità per gruppo**.

Per aggiornare da una versione precedente basta caricare il nuovo ZIP: lo script di aggiornamento crea ciò che manca senza toccare i prodotti riservati.

## Prima impostazione: il gruppo del personale

Il modulo distingue due tipi di gruppi clienti:

- **I gruppi del personale** vedono tutti i prodotti riservati e aprono il catalogo su tablet. È il gruppo delle vostre commesse in negozio.
- **Gli altri gruppi**, ad esempio i rivenditori B2B, vedono solo i prodotti riservati assegnati a loro.

Create prima un gruppo dedicato in **Clienti > Gruppi**, ad esempio "Commesse", con le stesse condizioni di prezzo del gruppo Clienti (sconto di gruppo, prezzi IVA inclusa o esclusa) perché il personale veda i prezzi pubblici. Aprite poi **Catalogo > Visibilità per gruppo**, scheda **Impostazioni**, selezionate questo gruppo in **Gruppi del personale** e salvate. Infine create un account cliente per ogni tablet o commessa e associatelo a questo gruppo.

Non usate il gruppo Clienti come gruppo del personale: tutti i vostri clienti vedrebbero i prodotti riservati.

## Riservare un prodotto dalla sua scheda

Nella scheda prodotto aprite la scheda **Moduli** (nuova scheda prodotto di PrestaShop 8.1 e 9) o la sezione dei moduli (vecchia scheda). Il pannello **Visibilità per gruppo clienti** propone due scelte:

- **Pubblico**: il prodotto segue le sue impostazioni di visibilità native.
- **Riservato**: il prodotto è nascosto nel negozio. Resta visibile ai gruppi del personale e ai gruppi selezionati subito sotto.

Cliccate su **Salva visibilità**. Il salvataggio è immediato e indipendente dal pulsante di salvataggio della scheda prodotto.

### Cosa fa la riserva

Il prodotto passa alla visibilità nativa _Da nessuna parte_. Sparisce quindi da categorie, ricerca, navigazione a faccette e moduli di prodotti in evidenza. Il modulo memorizza la visibilità originale per ripristinarla alla pubblicazione e aggiunge tre protezioni che la visibilità nativa non offre:

- l'URL diretto del prodotto restituisce una pagina non trovata, oppure la pagina di accesso per un visitatore non connesso se l'opzione è attiva;
- l'aggiunta al carrello viene rifiutata;
- se un prodotto riservato è già in un carrello, viene rimosso al momento dell'ordine e il cliente ne viene informato.

Un prodotto riservato deve restare **attivo**. Un prodotto disattivato non è visibile a nessuno, né al personale né ai gruppi autorizzati.

## Gestire la visibilità in massa

La pagina **Catalogo > Visibilità per gruppo**, scheda **Prodotti**, elenca tutto il catalogo con il relativo stato. Filtrate per nome, riferimento, EAN o ID, per categoria (sottocategorie comprese) e per stato Pubblico o Riservato.

Scegliete poi l'ambito (**Prodotti selezionati** o **tutti i prodotti che corrispondono al filtro**) e l'azione:

- **Riserva ai gruppi selezionati**: sostituisce i gruppi attuali.
- **Aggiungi** o **Rimuovi i gruppi selezionati**: si applica solo ai prodotti già riservati.
- **Rendi pubblico ora**, con l'opzione di abilitare anche l'ordine.
- **Rendi pubblico in una data**, oppure **Annulla la pubblicazione programmata**.

### Applicare un'azione a un elenco di riferimenti

Il blocco **Applica un'azione a un elenco di riferimenti** accetta riferimenti, EAN, UPC o ID prodotto, uno per riga o separati da virgole. Il riferimento o il codice a barre di una variante seleziona il suo prodotto. I codici non trovati vengono elencati dopo l'operazione, così potete correggere un file del fornitore.

### Riservare automaticamente i nuovi prodotti

Nelle impostazioni, l'opzione **Riserva automaticamente i nuovi prodotti** fa partire ogni nuovo prodotto come Riservato, con i gruppi selezionati per impostazione predefinita. Comodo quando preparate una collezione prima di metterla online.

## Pubblicazione programmata

Un prodotto riservato può diventare pubblico a una data e ora precise. Nella scheda prodotto compilate **Rendi pubblico automaticamente il** e selezionate se volete **e abilita l'ordine**. In massa, usate l'azione **Rendi pubblico in una data**. La colonna Visibilità dell'elenco mostra la data prevista.

Alla scadenza il modulo ripristina la visibilità originale, abilita l'ordine se richiesto e rilancia l'indicizzazione della ricerca. Senza configurazione, la pubblicazione avviene alla prima visita del negozio successiva alla scadenza. Per un orario esatto, richiamate ogni 5 o 15 minuti l'indirizzo cron indicato in **Impostazioni > Manutenzione**, protetto da un token specifico del vostro negozio.

## Il catalogo su tablet

### Accesso e installazione

L'indirizzo del catalogo si trova in **Impostazioni > Catalogo negozio per tablet**, nella forma `/module/dfgroupcatalog/catalog`. Un link compare anche nell'area Il mio account dei clienti autorizzati. Sul tablet accedete una volta con l'account del gruppo del personale, aprite l'indirizzo e aggiungetelo alla schermata Home: il catalogo si apre così a schermo intero come un'app.

I gruppi selezionati in **Altri gruppi autorizzati nel catalogo negozio** possono aprirlo anch'essi, ma vedono solo i prodotti pubblici e i propri prodotti riservati.

### Cercare e scansionare

- La ricerca riguarda nome, riferimento, EAN e i riferimenti o codici a barre delle varianti.
- Il pulsante di scansione usa la fotocamera del tablet. Su Android viene usato il rilevatore nativo del browser; su iPad subentra una libreria di lettura inclusa nel modulo. La torcia viene proposta quando il dispositivo ne dispone.
- Un lettore di codici a barre USB o Bluetooth funziona ovunque nella pagina, anche con una scheda aperta.
- Quando un codice corrisponde esattamente a un prodotto o a una variante, la scheda si apre direttamente sulla riga giusta.

Il pannello **Categorie**, il filtro **Solo disponibili**, l'ordinamento e, per il personale, il filtro Pubblico o Riservato completano la ricerca. Gli ultimi prodotti consultati vengono riproposti in cima all'elenco.

### La scheda prodotto sul tablet

Mostra la galleria con zoom a schermo intero, il prezzo (barrato in caso di sconto, IVA esclusa e inclusa se l'opzione è attiva), i prezzi per quantità del gruppo connesso, la giacenza, la data di ritorno in stock, le caratteristiche e la descrizione. La tabella delle varianti indica per ciascuna riferimento, EAN, prezzo, giacenza e ubicazione in magazzino se compilata. Toccando una variante si vede la sua immagine. Per il personale, la scheda indica anche per quali gruppi è visibile un prodotto riservato.

### Vista cliente e QR code

Il pulsante **Vista cliente**, in alto sullo schermo, nasconde giacenze, ubicazioni, etichette Riservato e la riga "Visibile per" prima di girare il tablet verso il cliente. Su un prodotto pubblico, il pulsante **Mostra al cliente** visualizza un QR code che apre la scheda prodotto sul suo telefono.

## Impostazioni

- **Gruppi del personale**, **Altri gruppi autorizzati nel catalogo negozio** e **Gruppi selezionati per impostazione predefinita**.
- **Riserva automaticamente i nuovi prodotti**.
- **Visitatori che aprono un prodotto riservato**: pagina di accesso invece di una pagina non trovata.
- **Prodotti riservati negli elenchi del negozio**: vedere la sezione B2B.
- Per il catalogo su tablet: titolo, prodotti per pagina, quantità in giacenza, prezzi IVA esclusa e inclusa, pulsante Vista cliente.

## Usare il modulo per un gruppo B2B

Create un gruppo rivenditori, poi selezionatelo sui prodotti riservati a esso destinati. Questi clienti aprono la scheda, aggiungono al carrello e ordinano normalmente, mentre i clienti B2C non vedono nulla.

Per impostazione predefinita un prodotto riservato non compare in categorie e ricerca, nemmeno per un gruppo autorizzato: vi si accede tramite il suo link o il catalogo su tablet. L'opzione **Prodotti riservati negli elenchi del negozio** li mostra in categorie e ricerca per i gruppi autorizzati. Si applica solo a questi clienti e solo nelle categorie che contengono prodotti riservati a loro, dove vedono un ordinamento semplice al posto dei filtri a faccette. I clienti B2C non sono mai coinvolti.

## Manutenzione e disinstallazione

**Verifica i prodotti riservati** nasconde di nuovo un prodotto riservato la cui visibilità sia stata modificata fuori dal modulo, da un'importazione o da un dipendente il cui profilo non ha il permesso di vedere il modulo.

**Rendi pubblici tutti i prodotti** restituisce a ogni prodotto riservato la sua visibilità originale. Usatelo prima di disinstallare: altrimenti i prodotti riservati restano nascosti, che è la scelta più sicura.

## Risoluzione dei problemi

### Il personale non vede i prodotti riservati

Verificate che l'account appartenga al gruppo selezionato in Gruppi del personale e che il prodotto sia attivo, poi disconnettete e riconnettete l'account sul tablet.

### Un prodotto riservato è tornato visibile

La sua visibilità è stata probabilmente modificata da un'importazione o da un dipendente senza permessi sul modulo. Avviate **Verifica i prodotti riservati**, poi date al profilo interessato il permesso "Visualizza" sul modulo in **Parametri avanzati > Team > Permessi**.

### Il pulsante di scansione non compare o la fotocamera viene rifiutata

La fotocamera è disponibile solo su un negozio in HTTPS. Consentite l'accesso alla fotocamera per il sito nelle impostazioni del browser del tablet. In alternativa resta utilizzabile un lettore di codici a barre.

### Un prodotto programmato non è ancora pubblico

Senza cron job, la pubblicazione attende la visita successiva del negozio. Aprite una pagina qualsiasi del sito o configurate l'indirizzo cron. Svuotate la cache se è attivo un modulo di cache delle pagine.

### I prezzi del catalogo su tablet differiscono da quelli del sito

Il catalogo mostra i prezzi del gruppo dell'account connesso. Date al gruppo del personale gli stessi sconti e la stessa visualizzazione IVA del gruppo Clienti.

## Limiti da conoscere

- I feed prodotti gestiti da altri moduli (Google Shopping, marketplace, comparatori) non sono filtrati per gruppo: escludete lì i prodotti riservati.
- I blocchi di accessori aggiunti da moduli di terze parti possono mostrare un prodotto riservato collegato a un prodotto pubblico.

## Compatibilità

- PrestaShop da 8.0 a 9.x con lo stesso ZIP, vecchia e nuova scheda prodotto.
- Navigazione a faccette nativa (ps_facetedsearch).
- Architettura ModuleAdminController, senza dipendenze Composer.
- Interfaccia tradotta in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.
