Guida Admin — Overview Day | Week | Month

Versione guida: settembre 2026 · SvetiX

1. Cos'è il plugin e chi lo usa

Overview Day | Week | Month è una dashboard per negozi che si apre in una pagina WordPress: target mensili, raggiunto di ogni agente, Footfall e Conversion Rate, calendario turni, classifiche e grafici. Tutto gira dentro un riquadro (iframe) caricato dallo shortcode [overview_week]; i dati vengono salvati sul tuo sito WordPress tramite l'API REST del plugin, quindi ogni persona vede sempre gli stessi numeri in tempo reale.

I quattro ruoli

Le tre versioni

La lingua predefinita è l'inglese; sono disponibili italiano, tedesco, francese e serbo, con bandierine nel selettore in alto (vedi sezione 5, "Lingue").

2. Installazione e attivazione

Servono WordPress 5.8 o più recente (testato fino a 7.1), PHP 7.4 o più recente e un sito in HTTPS (obbligatorio per installare la dashboard come app sul telefono).

Installare il plugin

1. Scarica lo zip overview-week-dashboard-x.y.z.zip (dall'email di Freemius o da Overview → Account).
2. Nella bacheca WordPress vai su Plugin → Aggiungi plugin → Carica plugin, scegli lo zip e premi Installa ora.
3. Premi Attiva. Compare la voce di menu Overview nella barra laterale della bacheca.
4. Alla prima attivazione Freemius chiede l'opt-in (invio di dati tecnici anonimi): puoi accettare o premere Skip, il plugin funziona in entrambi i casi.

Se il plugin è già installato, carica il nuovo zip nello stesso modo: WordPress mostra la tabella "Attuale / Caricato" e il pulsante Sostituisci l'attuale con quello caricato. Impostazioni e dati restano intatti.

Attivare la licenza o la prova gratuita

1. Vai su Overview (menu bacheca). Senza licenza vedi l'avviso arancione "Nessuna licenza attiva" con tre pulsanti.
2. Prova gratuita 14 giorni: apre il checkout Freemius, nessuna carta richiesta. Inserisci l'email e ricevi la chiave di licenza.
3. Acquista la licenza: checkout in CHF, mensile, annuale o una tantum, per 1, 3 o 5 siti. Puoi comprare direttamente senza fare la prova.
4. Torna alla bacheca, premi Ho già una chiave (o Overview → Account → Activate License), incolla la chiave e conferma.
5. L'avviso diventa verde: "Licenza attiva" o "Prova gratuita attiva". Da questo momento shortcode e API sono operativi.

Senza licenza attiva la dashboard resta visibile ma in sola lettura (modalità Lite, vedi sezione 7). Alla scadenza della prova torna in modalità Lite finché non attivi una licenza: i dati non vengono cancellati.

Dopo l'attivazione: la pagina Overview

La pagina Overview nella bacheca riassume lo stato della licenza, i passi "Come si usa" e i PIN iniziali. Freemius aggiunge sotto la voce Account (licenza, rinnovo, siti attivi, download dell'ultima versione).

3. Pagine e shortcode

Ogni negozio ha bisogno di una pagina WordPress per gli agenti e c'è una sola pagina Admin per tutto il sito. La differenza sta nell'attributo shop.

Attributo facoltativo height="1000": altezza in pixel del riquadro (predefinito 1000). Esempio: [overview_week shop="negozio1" height="1100"].

Attributo facoltativo fullwidth="1": la dashboard esce dalla colonna del tema e occupa l'intera larghezza dello schermo, restando centrata (utile con temi a colonna stretta). Esempio: [overview_week shop="negozio1" fullwidth="1" height="1000"]. Senza questo attributo il riquadro riempie normalmente la colonna del contenuto, allineato come il resto della pagina.

Creare le pagine

1. Pagine → Aggiungi nuova, titolo ad esempio "Overview Admin".
2. Aggiungi un blocco Shortcode (o Codice HTML) e incolla [overview_week].
3. Pubblica. Ripeti per ogni negozio con [overview_week shop="id"].
4. Facoltativo: nascondi le pagine dal menu del sito e dai motori di ricerca (impostazione "noindex" del tuo tema o plugin SEO). L'accesso resta comunque protetto dai PIN.

Pagina a tutta larghezza (consigliato)

La dashboard rende meglio senza titolo e senza margini del tema. Nel blocco della pagina, prima dello shortcode, aggiungi un blocco HTML personalizzato con questo CSS (sostituisci 31 con l'ID della tua pagina, visibile nell'URL dell'editor post=31):

<style>
body.page-id-31 main, body.page-id-31 .entry-content, body.page-id-31 .wp-block-post-content{max-width:none!important;width:100%!important;padding:0!important;margin:0!important}
body.page-id-31 .entry-title, body.page-id-31 h1.wp-block-post-title{display:none}
body.page-id-31 .overview-week-embed-wrap iframe{display:block;width:100%!important;height:calc(100vh - 80px)!important;min-height:640px;border:0}
</style>

Se il tuo tema offre un template "Larghezza piena" o "Senza intestazione", usalo: spesso basta quello. Il valore 80px è l'altezza della barra di navigazione del tema, da adattare.

Installare la dashboard come app (PWA)

Dal telefono o tablet apri la pagina del negozio in Safari o Chrome e scegli Aggiungi alla schermata Home (iPhone: pulsante Condividi → Aggiungi a Home; Android: menu ⋮ → Installa app). L'icona si apre a schermo intero, senza barra del browser. L'interfaccia è disponibile anche offline, ma i dati richiedono la connessione: senza rete vedi "Offline" e non puoi salvare.

4. Primo accesso e PIN

Ogni persona entra con un PIN numerico da 4 a 8 cifre sulla schermata di accesso. I PIN sono per negozio; solo il PIN Admin vale ovunque. Cambia subito i PIN iniziali: sono uguali per tutte le installazioni.

Regole: tutti i PIN di un negozio devono essere diversi tra loro; Store Manager e agenti non possono cambiare il proprio PIN, solo l'Admin. Dopo alcuni tentativi sbagliati un PIN viene bloccato temporaneamente: l'Admin lo sblocca dalla stessa sezione (pulsante "Sblocca").

Il primo accesso dell'Admin, passo per passo

1. Apri la pagina Admin ([overview_week]) e digita 123456.
2. Nella schermata "Scegli il negozio" seleziona Negozio 1 (è l'unico all'inizio).
3. Vai in Pannello Admin → Sicurezza — PIN di Accesso e imposta un nuovo PIN Admin, il nome e il PIN dello Store Manager, i PIN degli agenti. Premi Salva.
4. In Gestione Negozi rinomina "Negozio 1" con il nome reale (l'id negozio1 resta uguale ed è quello da usare nello shortcode).
5. In Gestione Agenti rinomina i 4 agenti predefiniti (nome, badge a due lettere, colore) e la riga SHOP; nascondi quelli che non ti servono.
6. In Calendario Giorni Lavorativi segna i giorni lavorati di ogni agente per il mese corrente: senza giorni pianificati un agente non compare in grafici e classifiche.
7. In Centro Correzioni → Modifica Target & Risultati inserisci i target mensili (TARGET MINIMO e SHOP) per ogni agente e KPI.

Cosa vede ogni ruolo dopo il login

• Admin e Store Manager: la barra laterale completa (Dashboard Globale, Analisi Negozio, Grafici Performance, Performance Agenti, Raggiungimento Settimanale, Panoramica 360°, Settimane 360°, Tabelle KPI SHOP, Tabelle KPI TARGET MINIMO, Calendario Turni, Pannello Admin / Gestione Negozio, Centro Correzioni, Importa da CSV).
• Agente: "La Mia Scheda" con tab Giornaliera, Settimanale e Dashboard Globale (sola lettura). Nessuna barra laterale.
• Riga SHOP: come un agente, ma per i numeri del negozio non attribuiti a persone.

In alto a destra ognuno trova il selettore lingua (bandierine) e il tema chiaro/scuro personale; il pulsante con il lucchetto o il logo riporta alla schermata di accesso (logout).

5. Pannello Admin, sezione per sezione

Il Pannello Admin (per lo Store Manager si chiama "Gestione Negozio" e mostra solo le parti che può modificare) è l'ultima voce di configurazione nella barra laterale. Ogni scheda ha il proprio pulsante Salva; l'indicatore in alto ("Sincronizzato" / "Salvataggio...") conferma che i dati sono sul server.

Gestione Negozi (solo Admin)

• Nuovo negozio: premi "Aggiungi negozio", inserisci il nome; l'id viene generato (es. negozio2) ed è quello da usare nello shortcode [overview_week shop="negozio2"]. Ogni negozio parte con riga SHOP + 4 agenti, PIN e impostazioni propri.
• Rinomina / elimina: matita per rinominare; il cestino cancella negozio e tutti i suoi dati (chiede conferma, non è reversibile: fai prima un backup).
• Cambia negozio attivo: il pulsante "Opera su questo negozio" sposta l'Admin su un altro negozio senza rifare il login.
• Limite: 50 negozi in Pro, 1 in Lite.

Gestione Agenti

• Per ogni agente: nome completo, badge (2 lettere mostrate nel cerchio), colore, ore mensili contrattuali (default 160 = tempo pieno; usate per calcolare la quota giornaliera del TARGET MINIMO), ruolo (Agente o Apprendista).
• Aggiungi agente/apprendista (solo Admin): il messaggio verde mostra il PIN iniziale generato. Poi imposta target in Centro Correzioni e giorni nel Calendario.
• Nascondi: l'agente sparisce da viste e classifiche ma i dati storici restano; si può riattivare in ogni momento. Preferiscilo all'eliminazione quando qualcuno lascia il negozio.
• Limite: 50 agenti per negozio in Pro, 2 in Lite.

Lingue (bandierine)

• Lingue attive: accendi o spegni Italiano, English, Deutsch, Français, Srpski. Solo le lingue attive compaiono nel selettore con bandierina in alto. Almeno una deve restare accesa.
• Lingua predefinita: quella mostrata a chi non ha ancora scelto una lingua sul proprio dispositivo (di serie English). La scelta personale di ogni utente (memorizzata sul suo browser) ha la precedenza, finché quella lingua resta attiva.
• Le impostazioni sono per negozio: negozi diversi possono avere lingue diverse.

Aspetto & Tema

• Tema del negozio: chiaro, scuro o automatico (segue il dispositivo). Ogni persona può comunque forzare il proprio tema dal pulsante sole/luna in alto.
• Colore accento e stile grafico (BASE o gli altri stili disponibili) cambiano bottoni, badge e logo.

Sicurezza — PIN di Accesso

Vedi sezione 4. Da qui l'Admin cambia il proprio PIN, nome e PIN dello Store Manager, PIN degli agenti e sblocca i PIN bloccati.

Rinomina KPI, KPI Personalizzati, Colonne Tabelle

• Rinomina KPI: cambia le etichette dei KPI standard (es. "Prodotto A" → "Abbonamenti") e l'unità di misura (CHF, pz).
• KPI Personalizzati: aggiungi categorie tue con nome, unità e colore; compaiono in tutte le tabelle e nei target.
• KPI Extra per Agente: valori liberi mostrati solo nella scheda dell'agente (es. bonus, note numeriche).
• Colonne Tabelle: nascondi o rinomina le colonne di Tabelle KPI e Raggiungimento Settimanale; "Ripristina" torna ai nomi predefiniti.

Target Giornaliero & Settimanale

Mostra, per tutti i KPI, il target di ogni giorno e settimana calcolato dal target mensile diviso per i giorni lavorativi del calendario. Serve per controllare che il calendario e i target siano coerenti.

Formule CR Personalizzate e Colonne Formula Preset

• CR PO e CR WIN (pezzi ÷ Footfall) sono le due Conversion Rate di serie, con target modificabili e prodotti inclusi selezionabili.
• Formule CR Personalizzate: crea altre CR scegliendo quali KPI sommare al numeratore. Appaiono nel grafico Footfall & CR e nelle tabelle.
• Colonne Formula Preset: colonne calcolate (somme, rapporti) da aggiungere alle tabelle KPI.

Qualità & Raggiungimento Totale, Flex Upgrade

Soglia di qualità e moltiplicatori che pesano il raggiungimento totale di ogni agente; modalità di visualizzazione (percentuale o valore). "Flex Upgrade" è una scheda extra con soglia ed etichetta a piacere.

Notifiche WhatsApp

Inserisci il numero con prefisso internazionale (es. 41791234567): i pulsanti "Invia su WhatsApp" delle tabelle apriranno la chat con il riepilogo già compilato. Nessun messaggio parte in automatico.

Backup & Ripristino Dati

• Scarica backup: un file JSON con tutti i negozi, agenti, PIN, target e risultati. Fallo almeno una volta al mese e prima di ogni aggiornamento importante.
• Ripristina: carica un backup precedente; sostituisce tutti i dati attuali (chiede il PIN Admin per conferma).
• Il backup serve anche per spostare i dati su un altro sito WordPress.

Calendario Giorni Lavorativi

Per ogni agente e mese, clicca i giorni lavorati (verde) o liberi. In Pro puoi pianificare qualsiasi mese fino al 2050; in Lite solo la settimana corrente. Le percentuali "ideale a oggi" e le proiezioni dipendono da questo calendario.

6. Lavoro quotidiano: viste, inserimenti, correzioni

Il flusso tipico: l'Admin imposta target e calendario a inizio mese, gli agenti inseriscono il proprio raggiunto ogni giorno, lo Store Manager inserisce Footfall e controlla le classifiche, l'Admin corregge gli errori dal Centro Correzioni.

Le viste della barra laterale

I due sistemi di target

• TARGET MINIMO: il target mensile di ogni agente per KPI, inserito dall'Admin. La quota giornaliera si calcola come target mensile × 8 ÷ ore contrattuali dell'agente.
• SHOP: si calcola in automatico come TARGET MINIMO × percentuale (modificabile per agente, correggibile cella per cella). Il pulsante "Torna al calcolo automatico" rimuove le correzioni manuali.
• Ogni tabella e grafico permette di scegliere il sistema con il selettore "SHOP / TARGET MINIMO".

Inserire il raggiunto del giorno (agente)

1. L'agente entra con il proprio PIN e apre "La Mia Scheda" → tab Giornaliera.
2. Sceglie il giorno (frecce Giorno precedente/successivo) e scrive il numero raggiunto per ogni KPI. Il valore si somma al totale della settimana e del mese.
3. La riga SHOP fa lo stesso per le vendite non attribuite a un agente.

In alternativa lo Store Manager inserisce per tutti da Performance Agenti (usando il suo master-PIN per aprire le schede).

Inserire Footfall e Conversion Rate

Dalla Dashboard Globale, tabella "Footfall & CR giornaliera": scrivi gli ingressi del giorno. La CR si calcola da sola (pezzi raggiunti ÷ Footfall dei giorni già inseriti). Si può correggere a mano da Centro Correzioni → Correzione Manuale CR (giornaliera, settimanale o mensile).

Centro Correzioni (Admin)

• Modifica Target & Risultati (SHOP e TARGET MINIMO): target mensile per agente e KPI; percentuali SHOP; risultati mensili. Lo Store Manager la vede in sola lettura.
• Correggi Raggiunto: correzione del raggiunto giornaliero o settimanale di qualsiasi agente, anche sui giorni passati. Il numero digitato nella cella settimanale è il raggiunto cumulativo da inizio mese: il sistema sottrae da solo le settimane precedenti. "Rimuovi la correzione manuale" torna alla somma automatica dei giorni.
• Azzera: azzera tutto il mese o una sola settimana (chiede conferma).
• Calendario Giorni Lavorativi, Qualità & Raggiungimento Totale, Flex Upgrade, Correzione Manuale CR: stesse schede descritte nella sezione 5, raggruppate qui per comodità.

Importa da CSV (Pro)

Quattro importazioni in tre passi (1. Carica il file, 2. Mappatura colonne, 3. Anteprima e conferma): Target Mensile, Raggiungimento Settimanale, Ordini Giornalieri, Footfall & CR. Il file deve avere una riga di intestazione; i nomi agente devono corrispondere a quelli in Gestione Agenti (maiuscole/minuscole e spazi non contano). Nel passo 2 scegli tu quale colonna è la Data, quale il nome dell'agente e a quale KPI corrisponde ogni colonna numerica: i nomi delle colonne sono liberi. L'anteprima mostra cosa verrà scritto prima di confermare.

Esempi già compilati da vedere e riusare — nella cartella del plugin docs/csv-esempi/ (scaricabili anche da bacheca → Overview → Guida Admin → "File CSV di esempio"). Aprili con Excel, Numbers o Google Sheets, sostituisci i numeri e i nomi con i tuoi, salva di nuovo come CSV e caricali.

Regole valide per tutti i file:

• Separatore: virgola ,, punto e virgola ; o tabulazione — rilevato in automatico dalla riga di intestazione (Excel in italiano/tedesco/francese salva con ;). Codifica UTF-8, con o senza BOM.
• Date accettate: 2026-10-01, 01.10.2026, 01/10/2026, 1.10.26.
• Numeri: 1234, 1234.50, 1'234.50 o 1234,50 (formato svizzero e italiano). Percentuali con % finale.
• I nomi dei KPI nelle colonne sono solo un suggerimento: nel passo 2 li abbini tu ai KPI del plugin (rinominati inclusi).
• Nessuna riga viene scritta finché non premi Conferma nel passo 3; prima di un import grande fai un backup JSON.

Esportare

• Ogni tabella ha il pulsante Esporta → immagine PNG (Pro).
• I grafici hanno Esporta → Scarica PNG / Scarica PDF con legenda.
• Il backup JSON completo è in Pannello Admin → Backup & Ripristino.

7. Lite e Pro a confronto

La versione Lite è lo stesso plugin senza licenza attiva: serve a provare il calendario e l'inserimento con un piccolo negozio. Ogni funzione bloccata mostra la finestra "Disponibile in Pro" con i pulsanti Passa a Pro e Prova 14 giorni.

Passare a Pro

1. Da qualsiasi finestra "Passa a Pro" o da bacheca → Overview → Passa a Pro apri il checkout Freemius (prezzi in CHF: 24.99/mese, 199.99/anno o 499 una tantum per 1 sito; tariffe per 3 e 5 siti).
2. Completa l'acquisto o scegli Prova 14 giorni (senza carta). Ricevi la chiave via email.
3. In bacheca → Overview → Account incolla la chiave ("Activate License"). I dati inseriti in Lite restano e vengono sbloccati subito.

Quando la licenza scade o viene disattivata il plugin torna in Lite: i negozi e gli agenti oltre il limite restano salvati ma non sono più accessibili finché non si riattiva una licenza.

8. Licenza, aggiornamenti, più siti

La licenza è gestita da Freemius: tutto quello che riguarda chiave, rinnovi e siti attivi si trova in bacheca → Overview → Account.

Aggiornamenti

• Con licenza o prova attiva gli aggiornamenti arrivano in Plugin → Aggiornamenti come per qualsiasi plugin: premi Aggiorna ora. Nessun dato viene toccato.
• Se un aggiornamento non compare subito, apri Overview → Account e premi Check for updates (o ricarica la pagina Plugin): il controllo avviene ogni 12 ore.
• In alternativa scarica l'ultimo zip da Overview → Account → Download latest version e caricalo con "Sostituisci l'attuale".
• Consiglio: fai un backup JSON (Pannello Admin → Backup) prima di aggiornare, per abitudine.

Più siti con la stessa licenza

Le licenze 3 siti e 5 siti attivano la stessa chiave su più installazioni WordPress. Ogni sito ha i propri negozi e dati: non c'è sincronizzazione tra siti (usa il backup JSON per copiare la configurazione).

Spostare la licenza su un altro sito

1. Sul vecchio sito: Overview → Account → Deactivate License (o disinstalla il plugin).
2. Sul nuovo sito: installa il plugin e attiva la stessa chiave.
3. Se il vecchio sito non è più raggiungibile, dal portale utente Freemius (link "Manage your account" nell'email di acquisto) puoi disattivare il sito dalla lista.

Rinnovi e cancellazione

• Licenza mensile/annuale: si rinnova da sola alla scadenza; puoi disattivare il rinnovo dal portale Freemius, la licenza resta valida fino a fine periodo.
• Licenza una tantum (499): non scade, aggiornamenti inclusi.
• Alla scadenza senza rinnovo il plugin passa in modalità Lite (sezione 7); i dati restano.

Disinstallare

Disattivare il plugin lascia tutti i dati nel database. Eliminarlo da Plugin → Elimina rimuove i file; prima scarica un backup JSON se vuoi conservare i dati.

9. Regole commerciali

• Nessun rimborso dopo l'acquisto, in nessun caso. Per questo esistono la demo pubblica e la prova gratuita di 14 giorni senza carta: provale prima di comprare.
• Nessun supporto incluso: la licenza dà diritto al plugin e ai suoi aggiornamenti, non ad assistenza personale, installazione o personalizzazioni. Questa guida e la demo sono l'unico materiale di riferimento.
• Demo pubblica: svetix.ch/spacetool — pagina Admin e pagina Negozio con i PIN di prova indicati sul sito; i dati si azzerano ogni 5 minuti.
• Prezzi in CHF, pagamento tramite Freemius (carta o PayPal); la fattura arriva via email da Freemius.
• Le stesse regole sono scritte sulla pagina di vendita, nella bacheca del plugin e nella finestra "Passa a Pro".

10. Problemi frequenti

Se il problema persiste, disattiva temporaneamente gli altri plugin (cache, sicurezza, ottimizzazione JS) per capire quale interferisce: la dashboard carica librerie esterne e non tollera la minificazione o il rinvio degli script da parte di plugin di ottimizzazione.