iCONstat Tracker v1.7.0 Plus

Documentazione Plugin per WordPress

Guida completa all'installazione, configurazione e utilizzo di iCONstat Tracker Plus per ambienti WordPress.

Descrizione

iCONstat Tracker Plus è la versione avanzata del plugin iCONstat Tracker, progettata per rilevare e integrare automaticamente lo script di tracking iCONstat in installazioni WordPress, incluse quelle in sottocartelle o con strutture complesse e personalizzate.

Il plugin elimina la necessità di configurazioni manuali complicate, scansionando intelligentemente il filesystem per localizzare la cartella _iconstat e iniettare lo script tracker con attributi anti-ottimizzazione che ne preservino l'integrità.

Caratteristiche Principali

Funzionalità Core

Interfaccia Pannello Impostazioni (v1.7.x)

Sicurezza

Requisiti

Minimi

Consigliati

Installazione

Metodo 1: Upload Manuale

  1. Scarica il file ZIP del plugin dalla pagina https://iconsuite.it/iconstat
  2. Vai su Plugin → Aggiungi nuovo → Carica plugin
  3. Seleziona il file ZIP e clicca Installa ora
  4. Attiva il plugin

Metodo 2: FTP/SFTP

  1. Estrai il contenuto dello ZIP nella cartella /wp-content/plugins/
  2. La struttura dovrebbe essere: /wp-content/plugins/iconstat-tracker-plus/
  3. Attiva il plugin da Plugin → Plugin installati

Configurazione

Configurazione Automatica (Consigliata)

Dopo l'attivazione, il plugin esegue automaticamente:

  1. Scansione Iniziale: Cerca tracker.js all'interno di cartelle _iconstat nel tuo server
  2. Cache Risultato: Memorizza il percorso trovato per evitare scansioni ripetute
  3. Iniezione Script: Aggiunge automaticamente il tracker nel footer del sito

Nessuna azione richiesta se il plugin trova correttamente lo script.

Configurazione Manuale

Se il rilevamento automatico fallisce:

  1. Vai su Impostazioni → iCONstat Tracker +
  2. Nel campo "Percorso manuale (opzionale)", inserisci il percorso relativo alla cartella _iconstat
    • Esempio: Se il tracker si trova in https://example.com/analytics/_iconstat/tracker.js, inserisci: analytics/_iconstat
    • Nota: Non includere barre iniziali o finali
  3. Clicca "Salva impostazioni"

Forza Ri-scansione

Per aggiornare la cache e cercare nuovamente il tracker:

Come Funziona

Algoritmo di Rilevamento

Il plugin segue questa priorità:

  1. Percorso Manuale (se specificato dall'utente)
  2. Cache (se esistente e valida)
  3. Scansione Automatica (fallback)

Scansione Automatica Dettagliata

Costruzione URL

// Esempio:
Path fisico: /home/user/public_html/blog/iconstat/_iconstat/tracker.js
Home URL: https://example.com/blog/

Risultato: https://example.com/iconstat/_iconstat/tracker.js

Il plugin rimuove correttamente la sottocartella WordPress (/blog/) dall'URL finale.

Iniezione dello Script

Il tracker viene inserito nel footer con priorita 20:

<script src="https://example.com/iconstat/_iconstat/tracker.js" 
        defer 
        data-cfasync="false" 
        data-no-optimize="1" 
        data-no-minify="1">
</script>

Attributi di protezione:

Struttura File

iconstat-tracker-plus/
├── iconstat-tracker-plus.php           # File principale del plugin
├── readme.txt                          # Documentazione WordPress.org
└── assets/
    ├── css/
    │    └── admin-style.css            # Stili interfaccia admin
    ├── js/
    │    └── admin-i18n.js              # Sistema traduzione IT/EN (Vanilla JS)
    └── img/
         └── iconstat-logo-main.webp    # Logo ufficiale

File Principali

iconstat-tracker-plus.php

Contiene tutta la logica del plugin:

assets/css/admin-style.css

Stili per l'interfaccia amministrativa:

assets/js/admin-i18n.js

Sistema di internazionalizzazione:

Sistema Bilingua

Funzionamento

Il plugin supporta Italiano (IT) e Inglese (EN) con:

Come Cambiare Lingua

Nel pannello WordPress:

  1. Clicca su IT o EN nell'angolo in alto a destra della pagina impostazioni
  2. La traduzione avviene istantaneamente (JavaScript)
  3. La preferenza viene salvata nel tuo profilo utente

Aggiungere Altre Lingue

Per aggiungere una nuova lingua (es. Francese):

  1. Apri assets/js/admin-i18n.js
  2. Aggiungi l'oggetto fr nell'oggetto translations
  3. Aggiungi il pulsante nel PHP

FAQ

Il plugin non trova il tracker.js. Cosa faccio?

Soluzione 1: Usa il percorso manuale

Soluzione 2: Verifica i permessi

Soluzione 3: Forza ri-scansione

Posso usare il plugin con WordPress in una sottocartella?

Sì! Il plugin gestisce automaticamente installazioni come:

Costruisce l'URL corretto rimuovendo la sottocartella WordPress dal path finale.

Il plugin rallenta il sito?

No, perché:

Posso personalizzare la posizione dello script?

No, il plugin inietta automaticamente lo script nel footer (wp_footer hook, priorita 20).

Funziona con plugin di caching/ottimizzazione?

Sì, ed e progettato proprio per questo! Gli attributi data-no-optimize e data-no-minify prevengono che plugin come:

... modifichino o spostino lo script tracker.

Come disattivo il plugin?

  1. Vai su Plugin → Plugin installati
  2. Trova "iCONstat Tracker Plus"
  3. Clicca Disattiva
  4. (Opzionale) Clicca Elimina per rimuovere anche le opzioni dal database

Nota: La disattivazione non elimina le opzioni dal database. Per una pulizia completa, elimina il plugin.

Hook e Filtri

Action Hooks

iconstat_plus_after_scan

Eseguito dopo la scansione automatica.

add_action( 'iconstat_plus_after_scan', function( $url ) {
    error_log( 'Tracker URL: ' . $url );
});

Filtri Disponibili

iconstat_plus_tracker_url

Filtra l'URL del tracker prima dell'output.

add_filter( 'iconstat_plus_tracker_url', function( $url ) {
    // Modifica URL per CDN
    return str_replace( 'example.com', 'cdn.example.com', $url );
});

iconstat_plus_scan_depth

Modifica la profondita massima di scansione (default: 5).

add_filter( 'iconstat_plus_scan_depth', function( $depth ) {
    return 7; // Aumenta a 7 livelli
});

iconstat_plus_excluded_dirs

Aggiungi o rimuovi cartelle dalla lista di esclusione.

add_filter( 'iconstat_plus_excluded_dirs', function( $dirs ) {
    $dirs[] = 'my_custom_folder';
    return $dirs;
});

Changelog

1.7.0 Plus

1.6.0 Plus

1.5.2 Plus

1.1.3

1.1.0

1.0.1

1.0.0

iCONstat Tracker v1.7.0 Plus

WordPress Plugin Documentation

A comprehensive guide to the installation, configuration, and operation of iCONstat Tracker Plus within WordPress environments.

Description

iCONstat Tracker Plus is the advanced version of the iCONstat Tracker plugin, designed to automatically detect and integrate the iCONstat tracking script in complex WordPress installations, including subdirectory setups or custom server structures.

The plugin eliminates the need for complex manual configurations by intelligently scanning the filesystem to locate the _iconstat folder and injecting the tracker script with anti-optimization attributes that preserve its integrity.

Key Features

Core Functionality

Professional Interface (v1.7.0)

Security

Requirements

Minimum

Recommended

Installation

Method 1: Manual Upload

  1. Download the plugin ZIP file from the page https://iconsuite.it/iconstat
  2. Go to Plugins → Add New → Upload Plugin
  3. Select the ZIP file and click Install Now
  4. Activate the plugin

Method 2: FTP/SFTP

  1. Extract the ZIP contents to the /wp-content/plugins/ folder
  2. The structure should be: /wp-content/plugins/iconstat-tracker-plus/
  3. Activate the plugin from Plugins → Installed Plugins

Configuration

Automatic Configuration (Recommended)

After activation, the plugin automatically performs:

  1. Initial Scan: Searches for tracker.js within _iconstat folders on your server
  2. Result Caching: Stores the found path to avoid repeated scans
  3. Script Injection: Automatically adds the tracker to your site footer

No action required if the plugin finds the script correctly.

Manual Configuration

If auto-detection fails:

  1. Go to Settings → iCONstat Tracker +
  2. In the "Manual Path (Optional)" field, enter the relative path to the _iconstat folder
    • Example: If the tracker is at https://example.com/analytics/_iconstat/tracker.js, enter: analytics/_iconstat
    • Note: Do not include leading or trailing slashes
  3. Click "Save Settings"

Force Rescan

To update the cache and search for the tracker again:

How It Works

Detection Algorithm

The plugin follows this priority:

  1. Manual Path (if specified by user)
  2. Cache (if existing and valid)
  3. Auto-Scan (fallback)

Detailed Auto-Scan

URL Construction

// Example:
Physical path: /home/user/public_html/blog/iconstat/_iconstat/tracker.js
Home URL: https://example.com/blog/

Result: https://example.com/iconstat/_iconstat/tracker.js

The plugin correctly removes the WordPress subdirectory (/blog/) from the final URL.

Script Injection

The tracker is inserted in the footer with priority 20:

<script src="https://example.com/iconstat/_iconstat/tracker.js" 
        defer 
        data-cfasync="false" 
        data-no-optimize="1" 
        data-no-minify="1">
</script>

Protection attributes:

File Structure

iconstat-tracker-plus/
├── iconstat-tracker-plus.php           # Main plugin file
├── readme.txt                          # WordPress.org documentation
└── assets/
    ├── css/
    │    └── admin-style.css            # Admin interface styles
    ├── js/
    │    └── admin-i18n.js              # IT/EN translation system (Vanilla JS)
    └── img/
         └── iconstat-logo-main.webp    # Official logo

Main Files

iconstat-tracker-plus.php

Contains all plugin logic:

assets/css/admin-style.css

Styles for the admin interface:

assets/js/admin-i18n.js

Internationalization system:

Bilingual System

How It Works

The plugin supports Italian (IT) and English (EN) with:

How to Change Language

In WordPress dashboard:

  1. Click IT or EN in the top-right corner of the settings page
  2. Translation happens instantly (JavaScript)
  3. Preference is saved to your user profile

In HTML preview:

Adding More Languages

To add a new language (e.g., French):

  1. Open assets/js/admin-i18n.js
  2. Add the fr object to the translations object
  3. Add the button in the PHP file

FAQ

The plugin cannot find tracker.js. What should I do?

Solution 1: Use manual path

Solution 2: Verify permissions

Solution 3: Force rescan

Can I use the plugin with WordPress in a subdirectory?

Yes! The plugin automatically handles installations like:

It builds the correct URL by removing the WordPress subdirectory from the final path.

Does the plugin slow down my site?

No, because:

Can I customize the script position?

No, the plugin automatically injects the script in the footer (wp_footer hook, priority 20).

Does it work with caching/optimization plugins?

Yes, and it is designed specifically for this! The data-no-optimize and data-no-minify attributes prevent plugins like:

... from modifying or relocating the tracker script.

How do I deactivate the plugin?

  1. Go to Plugins → Installed Plugins
  2. Find "iCONstat Tracker Plus"
  3. Click Deactivate
  4. (Optional) Click Delete to also remove options from the database

Note: Deactivation does not remove options from the database. For complete cleanup, delete the plugin.

Hooks & Filters

Action Hooks

iconstat_plus_after_scan

Executed after the automatic scan.

add_action( 'iconstat_plus_after_scan', function( $url ) {
    error_log( 'Tracker URL: ' . $url );
});

Available Filters

iconstat_plus_tracker_url

Filters the tracker URL before output.

add_filter( 'iconstat_plus_tracker_url', function( $url ) {
    // Modify URL for CDN
    return str_replace( 'example.com', 'cdn.example.com', $url );
});

iconstat_plus_scan_depth

Modifies the maximum scan depth (default: 5).

add_filter( 'iconstat_plus_scan_depth', function( $depth ) {
    return 7; // Increase to 7 levels
});

iconstat_plus_excluded_dirs

Add or remove folders from the exclusion list.

add_filter( 'iconstat_plus_excluded_dirs', function( $dirs ) {
    $dirs[] = 'my_custom_folder';
    return $dirs;
});

Changelog

1.7.0 Plus

1.6.0 Plus

1.5.2 Plus

1.1.3

1.1.0

1.0.1

1.0.0