🔑 Activation
Gestisce l’attivazione della licenza necessaria per il collegamento a Pricelist Server.
L’inserimento dei dati di licenza abilita tutte le funzioni del plugin.

Campi principali:
• License ID → codice identificativo univoco della licenza.
• License Expiration → data di scadenza della licenza.

Dopo aver inserito i dati, premere Save per completare l’attivazione. Verrà attivata la finestra Sync per la sincronizzazione.

🔄 Sync
Consente di sincronizzare i contenuti del catalogo da Pricelist Server al sito WordPress.
Durante la sincronizzazione vengono aggiornati articoli, listini, descrizioni e immagini.

Funzioni disponibili:
• Avvio sincronizzazione manuale.
• Visualizzazione dello stato di avanzamento.

💡 Suggerimento: eseguire la sincronizzazione periodicamente o dopo ogni aggiornamento del catalogo.

🧰 Develop
Consente di impostare la lingua predefinita e di effettuare prove senza influire sull’ambiente di produzione.

Campi principali:
• Default Language → lingua di riferimento per lo sviluppo in base alle lingue catalogo disponibili.

⚙️ Setup
Gestisce le impostazioni generali del plugin e del catalogo pubblicato.

Opzioni disponibili:
• Pagina condizioni di vendita → link alla pagina informativa del sito.
• Unità di misura → unità base per i prodotti (es. cm, mm, pezzo).
• Simbolo valuta → opzione ON/OFF che determina se mostrare o meno il simbolo della valuta impostato nel listino di Pricelist Server.
• ON → il simbolo di valuta viene visualizzato accanto ai prezzi sul sito.
• OFF → i prezzi vengono mostrati senza simbolo di valuta.
• Lingua fail safe → lingua di riserva se una traduzione non è disponibile.
• Rigenerazione ID univoci → funzione per ricreare gli identificativi dei blocchi.

💡 Suggerimento: mantenere l’opzione Simbolo valuta attiva solo se i listini online sono destinati a un’unica valuta di riferimento.

📱 App
Definisce le impostazioni di integrazione con l’app Pricelist dedicata o con la sezione mobile del sito.
Consente di indicare la pagina di destinazione e i parametri base di collegamento.

• Landing Page → pagina visualizzata in apertura del chatbot.

📝 Note
Attiva la funzionalità di preventivo rapido sul sito web.
Gli utenti possono selezionare articoli, configurazioni o finiture direttamente dal listino e ottenere un totale stimato in tempo reale.

Funzioni principali:
• Attivazione del calcolo dinamico dei prezzi.
• Gestione delle opzioni di personalizzazione (es. colore, finitura, quantità).
• Visualizzazione del riepilogo preventivo.
I preventivi generati vengono registrati automaticamente nella sezione Pricelist Note di Pricelist Server.

🧠 Suggerimenti operativi
• Verificare la corretta attivazione della licenza prima di avviare la sincronizzazione.
• Impostare l’ambiente di sviluppo separatamente da quello di produzione.
• Aggiornare periodicamente i dati tramite la sezione Sync.
• Utilizzare Vault solo con credenziali sicure e protette.
• Controllare periodicamente gli utenti configurati in WP-User per mantenere coerenza tra WordPress e Pricelist Server.

Il blocco Price-list Description permette di mostrare all’interno delle pagine del sito WordPress le descrizioni degli articoli presenti nel listino collegato a Pricelist Server.
È uno dei blocchi fondamentali per costruire la struttura del listino online e consente di richiamare automaticamente le informazioni dei prodotti, come descrizioni, intestazioni e dati tecnici, tramite codice articolo o ricerca testuale.

🔹 ID
La sezione ID contiene tutti i parametri di configurazione principali del blocco.
• ID: È il codice univoco assegnato automaticamente al blocco. Serve per identificarlo all’interno della pagina e non può essere modificato manualmente.
• Tag: Determina il tipo di elemento HTML che conterrà il testo (ad esempio paragraph, header 1, header 2, span, ecc.). Permette di definire la gerarchia e lo stile semantico del contenuto.
• Font Style: Consente di selezionare lo stile del testo tra le opzioni disponibili (Normal o Bold).
• Price-list Code: È il campo che collega il blocco a un articolo del listino. Il codice non può essere inserito manualmente, ma deve essere selezionato tramite ricerca (icona lente 🔍). È possibile cercare sia tramite testo (ad esempio parte della descrizione) sia tramite codice neutro.
• Mode: Questo campo si compila automaticamente dopo la selezione del codice e indica la tipologia di dato recuperato. Può assumere i valori:
• Article description → se la ricerca ha individuato un articolo.
• Header description → se la ricerca ha individuato un’intestazione.
• Field Type: Permette di selezionare il tipo di campo da mostrare, come “Standard description field”, “Technical field”, o altri, a seconda delle informazioni disponibili per il prodotto.

🔹 Link
La sezione Link consente di rendere cliccabile il blocco, collegandolo a una risorsa interna o esterna.
• Type: Definisce il tipo di collegamento da applicare. Le opzioni disponibili sono:
• Page → collega il blocco a una pagina del sito.
• Post → collega il blocco a un articolo WordPress.
• Custom Link → permette di inserire un URL personalizzato.
• Linked: In base alla tipologia selezionata, consente di scegliere la pagina, il post o l’indirizzo web da associare. Questo è utile, ad esempio, per collegare un codice articolo alla scheda prodotto corrispondente o a una categoria del catalogo.

🔹 Phantom
La sezione Phantom permette di attivare la modalità riservata del blocco.
• Phantom mode: Quando è attiva, il contenuto del blocco viene nascosto agli utenti non registrati e rimane visibile solo a chi ha effettuato l’accesso. È particolarmente utile per gestire contenuti destinati esclusivamente a rivenditori, partner o personale interno (ad esempio prezzi riservati o informazioni tecniche).

🔹 Pricelist AI
La sezione Pricelist AI integra il blocco con il sistema di intelligenza artificiale del listino, permettendo di generare descrizioni dinamiche o testi personalizzati basati sui dati dell’articolo.
• Content: Campo principale dove si inserisce il prompt, ossia il testo che guida la generazione automatica del contenuto. È possibile utilizzare tag dinamici per richiamare i dati del prodotto selezionato.
Esempio di prompt:
• Il codice <COD> è un <st;A;des> del modello <topic> con larghezza <diml>
• Load Saved Prompt / Save Prompt: Permettono rispettivamente di caricare un prompt salvato in precedenza o salvarne uno nuovo per riutilizzarlo in altri blocchi.
• Preview: Mostra un’anteprima del risultato finale sostituendo i tag con i valori reali del prodotto collegato.
• Tag: Elenco dei campi disponibili per il codice articolo selezionato (es. COD, DIML, DIMP, DES, ecc.), utilizzabili all’interno del prompt.
• Topic: Campo dedicato all’argomento di riferimento del prompt (ad esempio modello, collezione o categoria). Permette di generare testi più coerenti e contestualizzati rispetto al prodotto visualizzato.

Il blocco Price-list Table permette di visualizzare i dati del listino in formato tabellare.
Ogni tabella può essere completamente personalizzata: numero di righe e colonne, contenuti delle celle, dati caricati dal listino, immagini, link, testi liberi, descrizioni e molto altro.
È il blocco ideale per realizzare listini strutturati, tabelle tecniche, griglie prodotto o schede configurabili.

🔹 Struttura della tabella
La tabella viene generata in base ai parametri inseriti nella sezione Table Settings:
• Rows number: numero di righe da generare
• Columns number: numero di colonne da generare
• Cell style: permette di applicare uno stile grafico alle celle (bordi, sfondi, allineamenti)
Quando si salva, il plugin genera automaticamente una lista di celle con nome progressivo:
Formato delle celle:
cella-
Esempi:
• Riga 0 → cella-00, cella-01, cella-02
• Riga 1 → cella-10, cella-11, cella-12
• …
• Riga 5 → cella-50, cella-51, cella-52
Ogni cella può essere configurata in modo indipendente.

🔹 Selezione della cella
Dopo aver generato la tabella:
1. Si apre il menù a tendina Cell.
2. Si seleziona la cella da configurare (es. cella-01).
3. In base al tipo di contenuto scelto, la barra laterale mostra impostazioni diverse.

🔹 Tipi di contenuto disponibili
Per ogni cella è possibile selezionare il tipo di contenuto tramite il campo Cell Type:
• Article description
• Article data
• Header description
• Price
• Free text
• Image
Quando si seleziona un tipo, la barra laterale mostra le impostazioni corrispondenti alla categoria.

🔸 CONFIGURAZIONE DELLE CELLE
Di seguito sono descritte tutte le possibili configurazioni in base al contenuto scelto.

🟦 1. Article description
Mostra una descrizione dell’articolo collegato.

Campi disponibili:
• Article code: si seleziona cliccando sulla lente e cercando:
• codice neutro
• testo descrittivo dell’articolo
• Mode: si compila automaticamente
• Field type: seleziona quale campo descrittivo mostrare (es. descrizione standard, descrizione tecnica, lingua, ecc.).
• ROW SPAN / COL SPAN: Permettono di unire la cella con quelle adiacenti:
• 0 = nessuna unione
• 1+ = unione delle celle in verticale o in orizzontale

🟩 2. Article data
Mostra informazioni anagrafiche del prodotto.

Esempi di campi selezionabili:
• codice articolo
• dimensioni
• altezza, larghezza, profondità
• informazioni extra
Funziona come Article description, con ricerca tramite lente.

🟧 3. Header description
Mostra descrizioni appartenenti alle intestazioni del listino.

Campi
• Header code: Ricerca tramite lente, selezionando un’intestazione del listino.
• Field type: Campo descrittivo dell’intestazione
• Link:
• Type: selezione tipo contenuto (Page, Post, Custom link)
• Linked: selezione della pagina/post/URL
Utile per rendere cliccabili categorie o sezioni.

🟥 4. Price
Mostra un prezzo proveniente dal listino.

Campi disponibili
• Article code: selezionabile solo tramite ricerca
• Price column: colonna del listino da utilizzare

🟨 5. Free text
Inserisce testo manuale in una cella, non verrà tradotto.

🟪 6. Image
Inserisce un’immagine nella cella.

Selezione immagine:
• L’immagine si seleziona dalla Media Library di WordPress.

Dimensioni immagine:
• Image auto dimension = ON –> Usa le dimensioni originali dell’immagine.
• Image auto dimension = OFF –> Permette di definire manualmente:
• larghezza
• altezza
• unità di misura (px, %, vh, vw, ecc.)

Prefix / Suffix:
Permettono di selezionare un’immagine basata sul nome file con suffisso o prefisso indicati.
Prefix/suffix permettono di trovare varianti come:
• AB01.jpg
• disegno_AB01.png
• AB01_schema.jpeg

Esempio:
Codice articolo = AB01
Prefix = disegno_
Suffix = (vuoto)
Il plugin cercherà automaticamente in Media Library un file che contiene:
disegno_AB01.*

Recursive override:
Serve per il blocco ricorsivo (spiegato nel prossimo modulo).
Se Recursive override è attivo l’immagine rimane quella selezionata, senza essere sostituita automaticamente in base al codice articolo selezionato.

🔹 SALVATAGGIO
Il pulsante Save cell si trova all’interno della schermata di configurazione di ogni singola cella.
Serve per salvare:
• le impostazioni della cella attualmente selezionata
• la configurazione generale della tabella
• lo stato corrente della pagina WordPress

👉 È fondamentale cliccare “Save cell” prima di uscire dalla cella selezionata, altrimenti le modifiche apportate non verranno applicate.

🔹 ANTEPRIMA
Click su Show Table per vedere l’anteprima della tabella con i dati generati.

Il blocco Price-list Recursive permette di generare in automatico una serie di tabelle ripetute, partendo da un templatecreato con il blocco Price-list table e applicandolo a più codici articolo selezionati.
Il risultato è una sequenza di tabelle identiche nella struttura, ma con contenuti diversi in base al codice associato.

Nota importante: il blocco Recursive funziona solo su codici articolo, non sulle intestazioni.

1. Gestione delle associazioni
Apertura pannello
Clicca su Manage Associations per aprire la finestra di gestione dei codici.
Aggiungere un’associazione
1. Clicca Add Association
2. Cerca un codice articolo tramite testo o codice
3. Clicca Associa accanto al codice desiderato
4. Ripeti per tutti i codici necessari
5. Conferma con Save & Close
Ordine delle associazioni
• Ogni codice viene inserito con una posizione automatica (0,1,2,…)
• Puoi modificarla tramite Move Up / Move Down
• L’ordine stabilito determina l’ordine con cui vengono generate le tabelle nel frontend

2. Selezione del Template
Dopo aver salvato le associazioni, scegli dal menu Template quale tabella (creata precedentemente con Price-list table) deve essere utilizzata per ogni codice.
Il template è obbligatorio, perché:
• definisce la struttura delle celle
• indica quali campi devono essere sostituiti
• permette al ricorsivo di sapere quali elementi generare (testi, immagini, prezzi, ecc.).

3. Prefisso/Suffisso immagine (attenzione!)
Nel blocco Recursive puoi impostare:
• Image Prefix
• Image Suffix
Questi valori vengono applicati a TUTTE le immagini all’interno del template.

⚠️ Attenzione
Se nel template alcune celle hanno già un prefisso/suffisso specifico, aggiungere un prefisso/suffisso anche nel ricorsivo potrebbe:
• duplicare i prefissi/suffissi,
• far sì che l’immagine non venga trovata.
Regola pratica
• Se tutte le immagini devono avere un certo prefisso o suffisso → impostalo nel Recursive.
• Se solo alcune immagini devono averlo → impostalo direttamente nella tabella (template) e lascia vuoti Prefix e Suffix nel Recursive.

4. Come avviene la generazione delle tabelle
Per ogni codice associato:
1. Il sistema clona il template
2. Sostituisce automaticamente i campi delle celle (es. codice, dim, immagine, descrizione, ecc.)
3. Applica prefissi/suffissi alle immagini (se impostati nel Recursive)
4. Mostra in pagina una sequenza di tabelle, una per ogni codice

Esempio:
Hai selezionato i codici AB01, AB02, AB03
→ Verranno generate tre tabelle identiche nella struttura ma con:
• codice diverso
• descrizioni diverse
• immagini con nome AB01 / AB02 / AB03
• contenuti testuali adattati automaticamente

5. Campi AI
Il Recursive non contiene un campo “content”: il testo AI si trova nel template, dove sarà scritto in forma dinamica (es. con tag AI tipo <COD>, <DES> <diml> ecc.).
Si può applicare solo il topic generale.
Il Recursive si limita a passare i valori corretti per ogni codice.

6. Output finale (render)
Alla pubblicazione, il blocco mostrerà:
• una tabella per ogni codice
• secondo l’ordine deciso
• con dati e immagini sostituiti correttamente

Il blocco Price-list Single Price permette di mostrare un singolo prezzo prelevato dal listino, per un articolo specifico e per una colonna prezzo scelta.
Viene usato ad esempio quando vuoi mostrare il prezzo di un prodotto all’interno di una pagina di dettaglio o in una scheda prodotto.

⚙️ Impostazioni del blocco

🔎 Price-list code
Campo di ricerca che ti permette di selezionare solo tramite ricerca il codice articolo.
👉 Non puoi scriverlo manualmente.
Puoi cercare tramite:
• testo della descrizione
• codice neutro
Una volta selezionato un risultato, il blocco si collega automaticamente all’articolo.

🧱 Column
Seleziona da quale colonna prezzo prelevare il valore.

📌 A cosa serve?
Molte aziende usano più colonne per gestire prezzi diversi:
• materiali differenti
• varianti
• fasce di prezzo

Esempio:
• Colonna 001 → prezzo in melaminico
• Colonna 002 → prezzo in marmo
👉 Con questo campo scegli esattamente quale prezzo mostrare.

💱 Valuta

Il simbolo della valuta:
• è deciso dal Pricelist Server (es. €, $, CHF…)
• può essere attivato o disattivato nelle impostazioni del plugin WordPress (opzioni ON/OFF)

👉 il blocco non gestisce direttamente la valuta, ma solo la visualizzazione.