Documentazione iCONstat
Versione 1.5 · Ultimo aggiornamento: Marzo 2026
Introduzione
iCONstat è un sistema di analytics self-hosted che non richiede database. Tutti i dati vengono salvati in file JSON sul tuo server, garantendo massima privacy e pieno controllo sulle informazioni raccolte.
iCONstat è disponibile in tre versioni: Free (gratuita, senza licenza né registrazione), Starter (€29) e Plus (€59). Starter e Plus con licenza lifetime. La versione Free include:
- Nessun database richiesto (MySQL, PostgreSQL, etc.)
- Dati salvati esclusivamente sul tuo server
- GDPR-ready: nessun cookie di profilazione, IP anonimizzati
- Installazione in 3 minuti
- Compatibile con qualsiasi hosting PHP
- Dashboard Visite: contatore live, visite totali, visitatori unici, pagine viste, confronto con periodo precedente, visite nel tempo, visite per orario, browser, dispositivi, pagine più visitate, paesi, sorgenti di traffico, sistemi operativi
- Impostazioni: gestione credenziali, esclusione rete locale, "non tracciarmi", Tracker Installer, backup dati con BREEZE™, gestione licenza
- Tema chiaro/scuro, multi-lingua (italiano e inglese)
La versione iCONstat Plus include tutte le funzionalità Starter, più:
- KPI aggiuntivi: Rimbalzo e Durata Media Sessione (Dashboard Visite), Conversioni e Video Play (Dashboard Azioni), con confronto rispetto al periodo precedente
- Mini grafici giornalieri su tutte le tabelle dati, per visualizzare l'andamento nel tempo a colpo d'occhio
- UTM Canali e UTM Contenuti per un'analisi completa delle campagne marketing
- Navigazione: pagine di entrata e pagine di uscita
- Conversione: form inviati ed engagement video (play, completamento, autoplay detection, dettaglio per video)
- Dashboard Obiettivi: obiettivi con modelli predefiniti (form inviato, file scaricato, link esterno, video riprodotto, pagina contatti, conferma, registrazione, acquisto, landing promozionale, errore 404) e obiettivi personalizzati con tre tipologie: Pagina, Azione ed Evento
- Report stampabile: genera un riepilogo completo dei dati analytics, salvabile come PDF
Performance e Impatto sul Sito
iCONstat è stato progettato per essere estremamente leggero e non compromettere in alcun modo le prestazioni del tuo sito.
Caratteristiche tecniche:
- Peso dello script: meno di 1 KB (Gzip)
- Richieste HTTP: 1 sola (self-hosted, nessuna chiamata esterna)
- Nessun cookie di profilazione → non richiede banner GDPR
- Zero impatto su LCP, FID, CLS (Core Web Vitals)
Questo rende iCONstat ideale per siti che puntano a massimizzare SEO, velocità e conformità privacy.
Requisiti di Sistema
- PHP 7.4 o superiore (consigliato PHP 8.x)
- Qualsiasi hosting con supporto PHP (Apache, LiteSpeed, Nginx)
- Nessuna estensione PHP speciale richiesta
- Permessi di scrittura sulla cartella
_iconstat/
iCONstat è progettato per siti con traffico fino a 3.000 visite al giorno (circa 90.000 visite/mese).
Installazione
- Carica la cartella
_iconstatnella root del tuo sito via FTP/SFTP - Apri nel browser:
tuosito.com/_iconstat/iconstat.php - Primo accesso: crea le tue credenziali di accesso (username e password)
- Attiva la licenza inserendo la chiave ricevuta dopo l'acquisto (solo Starter e Plus)
-
Installazione Tracker: al primo accesso alla dashboard, iCONstat rileva automaticamente le pagine del sito e propone l'installazione del tracker. Scegli "Automatico" per installarlo su tutte le pagine con un click, oppure "Manuale" per selezionare le singole pagine.
In alternativa, puoi aggiungere manualmente il tracker a ogni pagina del sito, prima del tag</body>:
<script src="/_iconstat/tracker.js"></script>Le statistiche inizieranno ad apparire dopo le prime visite.
_iconstat. In tal caso, dovrai aggiornare il nome della cartella anche nel tracker inserito nelle pagine.
Modifica Credenziali
Per modificare username o password in qualsiasi momento:
- Accedi alla dashboard di iCONstat
- Apri Impostazioni (icona ingranaggio)
- Nella sezione Credenziali di Accesso, modifica le credenziali
- Clicca Salva modifiche
Installazione su WordPress
- Carica la cartella
_iconstatnella root di WordPress (accanto awp-config.php) - Installa e attiva il plugin iCONstat Tracker presente nella cartella
WP_plugindel pacchetto;
se hai la versione Free, scaricalo dal sito ufficiale - Apri
tuosito.com/_iconstat/iconstat.php, crea le credenziali e attiva la licenza
Il plugin configura automaticamente il percorso del tracker, anche se WordPress è installato in una sottocartella.
Alternativa: WPCode
Se preferisci non installare il plugin (ad esempio perché usi già WPCode per gestire altri snippet), puoi aggiungere il tracker manualmente:
- Installa il plugin WPCode (gratuito) dal repository WordPress
- Vai in WPCode → Aggiungi Snippet → Snippet HTML
- Inserisci il codice:
<script src="/_iconstat/tracker.js"></script> - Posizione: Footer per tutto il sito
- Attiva e Salva
WordPress o sito statico in sottocartella
Se usi il plugin iCONstat Tracker, il percorso è configurato automaticamente. Se usi WPCode o un sito statico in sottocartella (es. /blog/), aggiorna il percorso manualmente:
<script src="/blog/_iconstat/tracker.js"></script>LiteSpeed Cache
Se usi LiteSpeed Cache e la dashboard non si apre correttamente, escludi _iconstat dalla cache:
LiteSpeed Cache → Impostazioni → Escludi → URI memorizzati nella cache privata:
/_iconstat/Tracker Installer
iCONstat include un sistema di installazione automatica del tracker nelle pagine HTML del sito, accessibile in due modi:
Al primo accesso
Se vengono rilevate pagine senza tracker, una finestra propone tre opzioni:
- Automatico – installa su tutte le pagine con un click
- Manuale – apre il pannello per selezionare le singole pagine
- Annulla – chiude la finestra senza fare nulla
Dalle Impostazioni
La sezione "Installazione Tracker" permette di:
- Scansionare le pagine del sito (file
.htmle.htm) - Visualizzare lo stato di ogni pagina (ATTIVO / ASSENTE / SOLA LETTURA)
- Installare o rimuovere il tracker dalle pagine selezionate
- Modificare il percorso di scansione (Document Root)
- Attivare o disattivare lo scan automatico al login (AUTO SCAN)
_ o . vengono esclusi automaticamente dalla scansione. Il tracker viene inserito come ultimo elemento prima di </body>. L'installazione automatica funziona solo con file HTML statici; per siti PHP o framework, utilizzare l'installazione manuale.
Tracciamento Campagne UTM
iCONstat traccia automaticamente i parametri UTM per monitorare le tue campagne marketing.
Parametri tracciati in entrambe le versioni (Starter e Plus):
utm_source– Sorgente del traffico (es. google, facebook, newsletter)utm_campaign– Nome campagna (es. promo_estate, lancio_prodotto)
La versione iCONstat Plus traccia anche:
utm_medium– Canale (es. cpc, email, social)utm_content– Contenuto (es. cta_top, banner_hero)
Esempio di URL con parametri UTM:
tuosito.com/landing?utm_source=facebook&utm_campaign=promo2026I dati delle campagne sono visibili nella dashboard, nella sezione UTM.
Dashboard Obiettivi
La versione iCONstat Plus include una terza dashboard dedicata agli Obiettivi, che permette di monitorare le conversioni e le azioni chiave del tuo sito.
KPI dedicati: obiettivi attivi, obiettivi raggiunti, conversion rate, media giornaliera e miglior giorno del periodo selezionato.
Grafico andamento: visualizza l'andamento di ogni obiettivo attivo nel tempo, con una linea dedicata per ciascuno.
10 modelli predefiniti pronti all'uso, attivabili con un click:
- Tipo Evento: form inviato, file scaricato, link esterno, video riprodotto
- Tipo Pagina: pagina contatti, pagina di conferma, registrazione, acquisto completato, landing promozionale, errore 404
Ogni modello mostra il tipo (Evento o Pagina), il pattern di tracciamento e il conteggio con percentuale di completamento. I pattern dei modelli predefiniti possono essere personalizzati per adattarsi alla struttura del proprio sito.
Obiettivi personalizzati con tre tipologie:
- Pagina: conta le visite a un percorso specifico del sito (es.
/carrello,/grazie). Nessun codice da aggiungere. - Azione: seleziona dal menu a tendina un'azione già registrata automaticamente dal tracker (click su bottoni, link esterni, download, form, video). Le azioni sono ordinate alfabeticamente con il numero di occorrenze. Nessun codice da aggiungere.
- Evento: per azioni personalizzate non rilevabili automaticamente. Richiede una riga di JavaScript:
_iconstat.trackEvent('nome')
La percentuale di conversione si aggiorna in tempo reale al cambio selezione, prima ancora di salvare. Le modifiche non salvate sono evidenziate da un indicatore visivo sull'icona di salvataggio. Ogni obiettivo può essere attivato o disattivato individualmente senza eliminarlo.
Disattivazione e Trasferimento Licenza
Le versioni Starter e Plus sono licenziate per un singolo dominio.
Per spostare la licenza su un altro dominio:
- Accedi alla dashboard di iCONstat
- Apri Impostazioni (icona ingranaggio)
- Nella sezione Licenza, clicca su Disattiva licenza
- Conferma la disattivazione nella finestra di dialogo
- Installa iCONstat sul nuovo dominio e riattiva la licenza con la stessa chiave
_iconstat sul nuovo server oppure utilizzare BREEZE™: esporta un backup completo dal vecchio dominio e reimportalo sul nuovo con un click, senza toccare FTP.
N.B. La versione Free non ha licenza: la sposti liberamente senza alcuna procedura.
_analytics/.allowed_hosts.json nella cartella dati.
Sicurezza e Protezione
iCONstat integra diversi livelli di protezione per garantire la massima integrità del codice e dei dati:
- Protezione del Codice: il motore PHP è protetto tramite offuscamento professionale, garantendo l'integrità del software e proteggendo la proprietà intellettuale.
- Privacy Fingerprinting con Salt Dinamico: il riconoscimento degli utenti unici avviene tramite hash crittografici non invertibili con chiave segreta, rendendo matematicamente impossibile il re-identikit degli utenti.
- Anti-Brute Force: sistema di rate limiting che blocca automaticamente gli IP dopo tentativi di login errati.
- Protezione CSRF: tutte le operazioni sensibili sono protette da Token CSRF per impedire azioni non autorizzate.
- Timeout sessione automatico (4 ore) con fingerprint sessione anti-hijacking.
- Security Headers: header di sicurezza avanzati (CSP, X-Frame-Options, HSTS) per proteggere da attacchi XSS e clickjacking.
- Protezione .htaccess automatica sulla cartella dati per impedire l'accesso diretto ai file.
- Privacy Compliant: zero database esterni, IP anonimizzati alla fonte. I dati non lasciano mai il tuo server.
- Zero-Dependency Tracker: il tracker è scritto in puro JavaScript senza librerie esterne, eliminando il rischio di attacchi Supply Chain.
- Concurrency Management: meccanismi di file locking esclusivo durante la scrittura per prevenire la corruzione dei dati durante visite simultanee.
- Ottimizzazione I/O: sistema progettato per minimizzare le operazioni di lettura/scrittura, riducendo il carico su disco e CPU. Ideale per hosting condivisi.
Struttura Dati e Integrazioni
iCONstat salva tutti i dati analitici in file JSON standard nella cartella _iconstat/_analytics/. I dati sono organizzati per data (es. visits_YYYY-MM-DD.json), rendendo semplice per gli sviluppatori:
- Leggere i dati grezzi con qualsiasi linguaggio (PHP, Python, Node.js, ecc.).
- Creare report esterni personalizzati o alert automatizzati.
- Integrare le statistiche in dashboard di terze parti.
- Esportare i dati in formato CSV direttamente dalla dashboard.
Questa architettura garantisce che tu rimanga l'unico proprietario dei tuoi dati, pronti per essere consultati o riutilizzati ovunque.
Supporto
Per assistenza tecnica relativa all'installazione o a difetti del software (solo Starter e Plus):
- Supporto tecnico: support@iconsuite.it
- Vendita e licenze: store@iconsuite.it
Il supporto è incluso per 12 mesi con Starter e 24 mesi con Plus, e non include personalizzazioni del codice o configurazioni server di terze parti.
iCONstat Documentation
Version 1.5 · Last updated: March 2026
Introduction
iCONstat is a self-hosted analytics system that requires no database. All data is saved in JSON files on your server, ensuring maximum privacy and full control over collected information.
iCONstat is available in three versions: Free (no license or registration required), Starter (€29) and Plus (€59). Starter and Plus with lifetime license. The Free version includes:
- No database required (MySQL, PostgreSQL, etc.)
- Data stored exclusively on your server
- GDPR-ready: no profiling cookies, anonymized IPs
- 3-minute installation
- Compatible with any PHP hosting
- Visits dashboard: live counter, total visits, unique visitors, page views, period-over-period comparison, visits over time, visits by hour, browsers, devices, top pages, countries, traffic sources, operating systems
- Settings: credential management, local network exclusion, "don't track me", Tracker Installer, data backup with BREEZE™, license management
- Light/dark theme, multi-language (Italian and English)
iCONstat Plus includes all Starter features, plus:
- Additional KPIs: Bounce Rate and Average Session Duration (Visits dashboard), Conversions and Video Plays (Actions dashboard), with period-over-period comparison
- Daily trend mini charts on all data tables, for at-a-glance trend visualization
- UTM Mediums and UTM Contents for complete marketing campaign analysis
- Navigation: entry pages and exit pages
- Conversion: submitted forms and video engagement (plays, completion, autoplay detection, per-video detail)
- Goals dashboard: goals with preset templates (form submitted, file downloaded, external link, video played, contact page, confirmation page, registration, purchase completed, promotional landing, 404 error) and custom goals with three types: Page, Action and Event
- Printable report: generates a complete analytics summary, exportable as PDF
Performance and Site Impact
iCONstat is designed to be extremely lightweight and have no negative impact on your website's performance.
Technical highlights:
- Script size: under 1 KB (Gzip-compressed)
- HTTP requests: only 1 (self-hosted, no external calls)
- No profiling cookies → no GDPR cookie banner required
- Zero impact on LCP, FID, CLS (Core Web Vitals)
This makes iCONstat ideal for sites focused on maximizing SEO, speed, and privacy compliance.
System Requirements
- PHP 7.4 or higher (PHP 8.x recommended)
- Any hosting with PHP support (Apache, LiteSpeed, Nginx)
- No special PHP extensions required
- Write permissions on the
_iconstat/folder
iCONstat is designed for sites with traffic up to 3,000 visits per day (approximately 90,000 visits/month).
Installation
- Upload the
_iconstatfolder to your site's root via FTP/SFTP - Open in your browser:
yoursite.com/_iconstat/iconstat.php - First access: create your login credentials (username and password)
- Activate the license by entering the key received after purchase (Starter and Plus only)
-
Tracker Installation: on first access to the dashboard, iCONstat automatically detects your site pages and offers to install the tracker. Choose "Automatic" to install it on all pages with one click, or "Manual" to select individual pages.
Alternatively, you can manually add the tracker to every page of your site, before the</body>tag:
<script src="/_iconstat/tracker.js"></script>Stats will start appearing after the first visits.
_iconstat folder. If you do, update the folder name in the tracker script tag on your pages accordingly.
Changing Credentials
To change username or password at any time:
- Access the iCONstat dashboard
- Open Settings (gear icon)
- In the Access Credentials section, update your credentials
- Click Save changes
WordPress Installation
- Upload the
_iconstatfolder to WordPress root (next towp-config.php) - Install and activate the iCONstat Tracker plugin included in the
WP_pluginfolder of the package;
if you have the Free version, download it from the official website - Open
yoursite.com/_iconstat/iconstat.php, create your credentials and activate the license
The plugin automatically configures the tracker path, even if WordPress is installed in a subdirectory.
Alternative: WPCode
If you prefer not to install the plugin (for example, because you already use WPCode to manage other snippets), you can add the tracker manually:
- Install the WPCode plugin (free) from the WordPress repository
- Go to WPCode → Add Snippet → HTML Snippet
- Insert the code:
<script src="/_iconstat/tracker.js"></script> - Location: Site Wide Footer
- Activate and Save
WordPress or static site in subdirectory
If you use the iCONstat Tracker plugin, the path is configured automatically. If you use WPCode or a static site in a subdirectory (e.g., /blog/), update the path manually:
<script src="/blog/_iconstat/tracker.js"></script>LiteSpeed Cache
If you use LiteSpeed Cache and the dashboard won't open correctly, exclude _iconstat from cache:
LiteSpeed Cache → Settings → Exclude → Private Cached URIs:
/_iconstat/Tracker Installer
iCONstat includes an automatic tracker installation system for HTML pages on your site, accessible in two ways:
On first access
If pages without the tracker are detected, a dialog offers three options:
- Automatic – installs on all pages with one click
- Manual – opens the panel to select individual pages
- Cancel – closes the dialog without doing anything
From Settings
The "Tracker Installation" section allows you to:
- Scan site pages (
.htmland.htmfiles) - View the status of each page (ACTIVE / MISSING / READ ONLY)
- Install or remove the tracker from selected pages
- Change the scan path (Document Root)
- Enable or disable automatic scan at login (AUTO SCAN)
_ or . are automatically excluded from scanning. The tracker is inserted as the last element before </body>. Automatic installation only works with static HTML files; for PHP sites or frameworks, use manual installation.
UTM Campaign Tracking
iCONstat automatically tracks UTM parameters to monitor your marketing campaigns.
Parameters tracked in both versions (Starter and Plus):
utm_source– Traffic source (e.g., google, facebook, newsletter)utm_campaign– Campaign name (e.g., summer_promo, product_launch)
iCONstat Plus also tracks:
utm_medium– Medium (e.g., cpc, email, social)utm_content– Content (e.g., cta_top, banner_hero)
Example URL with UTM parameters:
yoursite.com/landing?utm_source=facebook&utm_campaign=promo2026Campaign data is visible in the dashboard, under the UTM section.
Goals Dashboard
iCONstat Plus includes a third dashboard dedicated to Goals, allowing you to monitor conversions and key actions on your site.
Dedicated KPIs: active goals, completed goals, conversion rate, daily average and best day for the selected period.
Trend chart: displays each active goal's performance over time, with a dedicated line for each one.
10 preset templates ready to use, activatable with a single click:
- Event type: form submitted, file downloaded, external link, video played
- Page type: contact page, confirmation page, registration, purchase completed, promotional landing, 404 error
Each template shows its type (Event or Page), the tracking pattern and the count with completion percentage. Preset patterns can be customized to match your site's structure.
Custom goals with three types:
- Page: counts visits to a specific path on your site (e.g.
/cart,/thank-you). No code required. - Action: select from a dropdown an action already tracked automatically (button clicks, outbound links, downloads, forms, videos). Actions are sorted alphabetically with occurrence counts. No code required.
- Event: for custom actions not automatically detectable. Requires one line of JavaScript:
_iconstat.trackEvent('name')
The conversion rate updates in real time on selection change, even before saving. Unsaved changes are highlighted by a visual indicator on the save icon. Each goal can be individually enabled or disabled without deleting it.
License Deactivation and Transfer
Starter and Plus versions are licensed for a single domain.
To move the license to another domain:
- Access the iCONstat dashboard
- Open Settings (gear icon)
- In the License section, click Deactivate license
- Confirm the deactivation in the dialog window
- Install iCONstat on the new domain and reactivate the license with the same key
_iconstat folder to the new server or use BREEZE™: export a full backup from the old domain and reimport it on the new one with a single click, no FTP needed.
NOTE: The Free version has no license: you can move it freely without any procedure.
_analytics/.allowed_hosts.json file in the data folder.
Security & Protection
iCONstat integrates several protection layers to ensure maximum code and data integrity:
- Code Protection: the PHP engine is secured using professional obfuscation, ensuring software integrity and protecting intellectual property.
- Privacy Fingerprinting with Dynamic Salt: unique visitor recognition is performed using non-invertible cryptographic hashes with a secret key, making it mathematically impossible to re-identify users.
- Anti-Brute Force: rate limiting system that automatically blocks IPs after failed login attempts.
- CSRF Protection: all sensitive operations are protected by CSRF Tokens to prevent unauthorized actions.
- Automatic session timeout (4 hours) with session fingerprinting to prevent hijacking.
- Security Headers: advanced security headers (CSP, X-Frame-Options, HSTS) to protect against XSS and clickjacking.
- Automatic .htaccess protection on the data folder to prevent direct file access.
- Privacy Compliant: no external databases, IPs anonymized at source. Data never leaves your server.
- Zero-Dependency Tracker: the tracker is written in pure JavaScript with no external libraries, eliminating the risk of Supply Chain attacks.
- Concurrency Management: exclusive file locking mechanisms during write operations to prevent data corruption during high-traffic spikes.
- I/O Optimization: designed to minimize read/write operations, reducing disk and CPU overhead. Ideal for shared hosting environments.
Data Structure & Integrations
iCONstat stores all analytics data in standard JSON files in the _iconstat/_analytics/ folder. Data is organized by date (e.g., visits_YYYY-MM-DD.json), making it easy for developers to:
- Read raw data using any programming language (PHP, Python, Node.js, etc.).
- Create custom external reports or automated alerts.
- Integrate stats into third-party dashboards.
- Export data in CSV format directly from the dashboard.
This architecture ensures you remain the sole owner of your data, ready to be repurposed or analyzed anywhere.
Support
For technical assistance related to installation or software defects (Starter and Plus only):
- Technical support: support@iconsuite.it
- Sales and licenses: store@iconsuite.it
Support is included for 12 months with Starter and 24 months with Plus, and does not include code customizations or third-party server configurations.