GMC Social Share — Documentazione (WordPress)
GMC Social Share aggiunge a un sito WordPress pulsanti di condivisione social rispettosi della privacy. I pulsanti non caricano script di terze parti e non impostano cookie social al rendering, il plugin registra statistiche di condivisione per articolo e per network e può, in via opzionale, pubblicare automaticamente i nuovi articoli su una Pagina Facebook e/o su Instagram tramite la Graph API. È pensato per blogger, editori, agenzie e siti aziendali che vogliono una condivisione veloce e conforme al GDPR, con statistiche d'uso reali.
Requisiti: WordPress 6.0 o superiore, PHP 8.1 o superiore. L'interfaccia è disponibile in inglese, italiano e spagnolo. Questa documentazione riguarda l'edizione WordPress (gmc-social-share); l'edizione Joomla è un prodotto separato.
Installazione
- Scarica lo
.zipdel plugin dall'email di acquisto o dal tuo account. Lascialo compresso. - Nella bacheca di WordPress vai su Plugin → Aggiungi nuovo → Carica plugin.
- Seleziona il file
.zipe clicca Installa ora. - Al termine dell'installazione, clicca Attiva.
Dopo l'attivazione la schermata delle impostazioni del plugin appare nel menu di amministrazione.
Configurazione
Apri la schermata delle impostazioni del plugin dal menu di amministrazione. Le impostazioni principali:
- Download Key — inserisci la chiave ricevuta con l'email di licenza. Sblocca gli aggiornamenti con un clic per i licenziatari (vedi Aggiornamenti e licenza più sotto).
- Layout, stile e posizione — scegli come e dove far apparire i pulsanti. Tra le opzioni disponibili: un layout
bara tutta larghezza, un widget nel footer, una Footer bar compatta di piccoli pulsanti circolari solo icona che ereditano il colore del testo circostante (funziona su sfondi chiari e scuri) e una barra mobile fissa in basso dimensionata in modo che etichette e conteggi non escano mai dagli schermi piccoli. - Link al profilo Instagram — mostra opzionalmente un pulsante che rimanda al tuo profilo Instagram.
- Pubblicazione automatica su Meta (opzionale) — condivisione e statistiche funzionano anche senza. Per abilitarla, aggiungi le tue credenziali Meta, scegli le categorie di articoli consentite e configura la pianificazione. I nuovi articoli in una categoria consentita vengono quindi messi in coda e ripubblicati automaticamente sulla tua Pagina Facebook e/o su Instagram.
Per i pulsanti in sé non serve alcuna configurazione di consenso cookie: vengono renderizzati senza caricare script social di terze parti, quindi la sola presenza di un pulsante nella pagina non imposta cookie social.
Uso del plugin
Posizionare i pulsanti di condivisione
Ci sono due modi per mostrare i pulsanti:
- Scegli layout, stile e posizione nelle impostazioni, così i pulsanti appaiono automaticamente.
- Inserisci lo shortcode
[gmcsocialshare]dove vuoi che appaia la barra di condivisione — nel contenuto di un articolo, in un widget o in un template che elabora gli shortcode.
I pulsanti condividono sempre l'URL effettivo della pagina corrente, su ogni pagina — comprese le pagine nelle lingue non predefinite dei siti multilingua.
Statistiche di condivisione
Il plugin registra le condivisioni per articolo e per network. Usa queste statistiche per vedere quali articoli vengono condivisi e su quali network, così misuri quali contenuti circolano davvero invece di tirare a indovinare.
Pubblicazione automatica su Facebook e Instagram
Con l'integrazione Meta opzionale abilitata, ogni nuovo articolo pubblicato in una categoria consentita viene messo in coda e pubblicato automaticamente sulla tua Pagina Facebook e/o su Instagram tramite la Graph API, secondo la pianificazione configurata. Gli articoli fuori dalle categorie consentite non vengono ripubblicati. Se non abiliti mai questa funzione, i pulsanti di condivisione e le statistiche continuano a funzionare normalmente per conto proprio.
Aggiornamenti e licenza
GMC Social Share è un prodotto a pagamento (39 EUR/anno, un sito per licenza). Gli aggiornamenti sono automatici: il plugin controlla da solo il server di aggiornamento GMC / FuerteventuraTV (circa ogni 12 ore) e mostra ogni nuova versione in Plugin e in Bacheca → Aggiornamenti, come qualsiasi altro plugin.
- Download Key — dopo l'acquisto ricevi una Download Key con l'email di licenza. Inseriscila nella schermata delle impostazioni del plugin; sblocca gli aggiornamenti con un clic finché la licenza è attiva. Lasciala inserita e gli aggiornamenti continuano ad arrivare.
- Nuovo download — puoi anche riscaricare l'ultima build dal tuo account in qualsiasi momento.
- Licenza — il software è rilasciato sotto licenza GNU GPL. L'acquisto copre la build ufficiale, gli aggiornamenti con un clic e il supporto per un sito. Per più siti o per progetti dei clienti, chiedi informazioni su un accordo volume o agenzia.
Supporto
Per assistenza, rispondi all'email di acquisto o scrivici su WhatsApp al +34 633 168 995 (lo stesso numero è riportato nell'email di licenza). Includi:
- il nome del prodotto e la versione (es. GMC Social Share 1.4.13),
- le tue versioni di WordPress e PHP,
- un URL pubblico o uno screenshot del problema, con eventuali chiavi oscurate.
Rispondiamo in inglese, italiano e spagnolo. Se il plugin non funziona come descritto e non riusciamo a risolvere il problema, puoi richiedere un rimborso entro 14 giorni dall'acquisto.
Tutto incluso
71 funzionalità reali, raggruppate per area.
Pulsanti di condivisione e reti
- 9 reti di condivisione — Facebook, X (Twitter), WhatsApp, Telegram, LinkedIn, Reddit, Email, Copia link, più un pulsante profilo Instagram, così i visitatori condividono sul canale che preferiscono.
- Scegli quali reti mostrare — attiva solo le reti che vuoi (il set predefinito è Facebook, X, WhatsApp, Telegram, LinkedIn, Email e Copia), mantenendo la barra ordinata.
- Intent di condivisione nativi — i pulsanti aprono la finestra di condivisione propria di ogni piattaforma (sharer di Facebook, intent di X, WhatsApp, Telegram, LinkedIn, Reddit, mailto) con titolo e URL della pagina già precompilati.
- "Copia link" con un clic — copia l'URL della pagina corrente negli appunti per incollarlo ovunque, senza bisogno di alcun account social.
- Pulsante "segui" di Instagram — poiché Instagram non consente la condivisione di link, il pulsante Instagram rimanda all'URL del profilo che hai configurato e compare solo quando quell'URL è impostato.
- Sempre l'URL corretto della pagina corrente — i pulsanti condividono sempre la pagina effettivamente visualizzata (incluso l'URL nella lingua giusta sui siti multilingue), mai la home del sito.
- Icone SVG inline nitide — icone a percorso singolo 24×24 che ereditano il colore del testo, così restano nitide a qualsiasi dimensione senza alcuna richiesta di immagini.
- Colori di marca autentici — ogni pulsante riporta il vero colore del brand della sua rete (il blu di Facebook, il verde di WhatsApp, ecc.) per un riconoscimento immediato.
- Link in uscita sicuri — i veri link di condivisione si aprono in una nuova scheda con
rel="noopener noreferrer nofollow", proteggendo la tua pagina e la SEO.
Layout e aspetto
- 10 layout selezionabili — riga in linea, barra a tutta larghezza in maiuscolo, pila verticale, griglia responsive, nuvola di tag, grandi contatori, barra a piè di pagina, fluttuante a sinistra, fluttuante a destra e ancorata in basso, per adattarsi a qualsiasi punto della pagina.
- Layout "barra" a tutta larghezza — pulsanti di uguale larghezza con etichette in maiuscolo che vanno a capo sugli smartphone, in stile classica barra di condivisione.
- Layout barra a piè di pagina — una striscia compatta di piccoli pulsanti circolari solo icona che ereditano il colore del testo circostante (attenuato di default, colore del brand al passaggio del mouse) e appaiono bene sia sui footer scuri sia su quelli chiari, senza spostamenti di layout.
- Barre fluttuanti e ancorate — fissa una barra verticale di icone sul bordo sinistro o destro, oppure una barra a tutta larghezza in fondo allo schermo; le barre fluttuanti si riducono a una barra inferiore sugli smartphone e si nascondono in stampa.
- 3 stili di pulsante — pieno, contorno o minimale, per adattarsi al peso del tuo tema.
- 4 forme di pulsante — arrotondato, a pillola, quadrato o cerchio.
- 3 dimensioni di pulsante — piccolo, normale o grande.
- Mostra o nascondi etichette, conteggi e totale — attiva ciascuno in modo indipendente, dal solo icona fino al layout completamente etichettato con numeri di condivisione in tempo reale.
- Titolo personalizzato — aggiungi una riga di invito all'azione sopra la barra (ad es. "Condividi questo con i tuoi amici:").
- Colore d'accento personalizzato — imposta l'accento usato dagli stili minimale/contorno con un selettore di colori (esadecimale sanificato).
- Sicuro sul mobile per design — la barra ancorata in basso passa alla modalità compatta solo icona sugli schermi piccoli, così etichette lunghe e conteggi non escono mai dalla viewport.
Posizionamento e iniezione
- Iniezione automatica in articoli/post — inserisci la barra nel contenuto automaticamente, prima, dopo o attorno al testo del corpo, senza modificare il template.
- Posizionamento con shortcode — metti la barra esattamente dove vuoi con
{gmcsocialshare}(Joomla) /[gmcsocialshare](WordPress); uno shortcode esplicito prevale sempre sull'iniezione automatica. - Controllo del contesto (Joomla) — scegli se l'iniezione automatica avviene solo sui singoli articoli o anche sulle viste articolo/in evidenza/categoria.
- Modulo footer/sidebar (Joomla) — il modulo
mod_gmcsocialsharecolloca una barra di condivisione in qualsiasi posizione del template, condividendo la pagina corrente. - Widget footer/sidebar (WordPress) — il widget GMC Social Share colloca la barra in qualsiasi area widget, con impostazioni sovrascrivibili per singola istanza per layout, stile, forma, dimensione, reti, titolo e URL Instagram (ciascuna con fallback all'impostazione globale).
- Compatibile con i page builder — l'iniezione automatica funziona anche con builder come YOOtheme che renderizzano il contenuto fuori dal loop standard, dove i plugin di condivisione ingenui non appaiono mai.
- Nessuna barra duplicata — i layout fluttuanti/ancorati fissi si iniettano una sola volta per pagina e i loop secondari/post correlati vengono saltati, così la barra non viene mai renderizzata due volte.
Analytics delle condivisioni
- Tracciamento delle condivisioni per elemento e per rete — ogni clic di condivisione viene conteggiato sullo specifico articolo/post e sulla rete, così vedi esattamente cosa viene condiviso.
- Il tuo database, nessun terzo — i conteggi provengono dalla tabella dei clic del tuo stesso sito tramite un endpoint di prima parte; nulla viene inviato alle reti e non è coinvolto alcun servizio di analisi esterno.
- Conteggio e totale in tempo reale — mostra facoltativamente i conteggi per rete e un totale progressivo sulla barra, aggiornato in modo ottimistico nel momento in cui un visitatore clicca.
- Cruscotto analytics nel backend — una schermata di amministrazione mostra i totali per rete e i contenuti più condivisi (i 50 post principali con link di modifica su WordPress), così individui ciò che funziona.
- Conteggio accurato — un upsert atomico incrementa i conteggi in sicurezza in caso di concorrenza, e Joomla aggiunge la de-duplicazione per sessione così un visitatore che ri-clicca non gonfia i numeri.
- A prova di errore — conteggio/tracciamento sono protetti da un controllo di esistenza della tabella e da JavaScript best-effort (errori assorbiti), così la condivisione continua a funzionare anche se la tabella delle statistiche è assente.
Pubblicazione automatica su Facebook e Instagram (opzionale)
- Cross-posting senza intervento — quando pubblichi un nuovo articolo/post in una categoria consentita, viene messo in coda e pubblicato automaticamente sulla tua Pagina Facebook e/o su Instagram tramite le Meta Graph API, trasformando ogni articolo in un post social senza copia-incolla.
- Regole per categoria consentita — solo i contenuti nelle categorie che scegli vengono messi in coda, così bozze e sezioni fuori tema restano lontane dai social.
- Pubblica anche sugli aggiornamenti (opzionale) — facoltativamente rimetti in coda un post già pubblicato quando viene modificato, oppure limitalo ai soli nuovi post.
- Template della didascalia personalizzabile — costruisci la didascalia del post dai segnaposto
{title},{url},{intro}e{description}; le didascalie vengono tagliate ai limiti della piattaforma. - Post immagine su Instagram — la pubblicazione su Instagram usa l'immagine in evidenza dell'articolo/post (contenitore media in due passaggi e poi pubblicazione); viene saltata con un messaggio chiaro quando non è disponibile alcuna immagine.
- Post link su Facebook — i post su Facebook vengono pubblicati nel feed della Pagina come post link con la tua didascalia.
- Ritardo e spaziatura programmati — imposta quanto attendere dopo la pubblicazione prima del primo post e l'intervallo minimo tra i post in coda, così il tuo feed appare naturale e resta entro i limiti di frequenza.
- Limitazione dei batch — elabora solo pochi post per esecuzione (configurabile) per rispettare i limiti di Meta.
- Modalità dry-run — registra esattamente ciò che verrebbe pubblicato senza chiamare Meta, così puoi verificare la configurazione prima di andare in produzione (il dry-run è l'impostazione predefinita).
- Ripetizioni automatiche con back-off — i post falliti vengono ritentati fino a un numero massimo configurabile di tentativi dopo un ritardo configurabile, tracciando il successo parziale per rete così una rete già completata non viene ripubblicata.
- Recupero da lock obsoleti — un'esecuzione che si interrompe a metà pubblicazione rilascia automaticamente il proprio lock, così la coda non si blocca mai.
- Visibilità della coda — la coda di pubblicazione registra stato, tentativi, orario programmato, ID dei post remoti e ultimo errore per ogni elemento, così vedi cosa è in attesa, completato o in errore.
- Segreti tenuti fuori dal database — gli ID Pagina Facebook/Instagram e i token di accesso vengono letti dalle variabili d'ambiente del server / dalle costanti di
wp-config, e i token vengono oscurati da qualsiasi messaggio di log. - Versione delle Graph API configurabile — fissa la versione delle Meta Graph API (predefinita v20.0) così gli aggiornamenti restano sotto il tuo controllo.
- Guidata dagli scheduler nativi — Joomla la esegue come Attività Programmata (
plg_task_gmcsocialpublisher); WordPress la esegue su un evento WP-cron ogni 15 minuti. - Protetta dalla licenza in sicurezza — il publisher rifiuta di pubblicare quando il prodotto è definitivamente privo di licenza, ma una semplice interruzione del gateway non blocca mai un sito con licenza valida.
- Completamente opzionale — condivisione e analytics funzionano in modo del tutto autonomo; la pubblicazione automatica resta disattivata finché non la abiliti e aggiungi le credenziali.
Privacy e GDPR
- Nessuno script o SDK di terze parti — i pulsanti vengono renderizzati lato server con SVG inline, così non viene caricato alcun JavaScript di Facebook/X/ecc.
- Nessun pixel di tracciamento né cookie social — nulla viene impostato sul browser del visitatore solo perché viene mostrato un pulsante di condivisione.
- Solo analytics di prima parte — i conteggi delle condivisioni vivono nel tuo database e non lasciano mai il tuo sito, mantenendoti conforme al GDPR per design.
Internazionalizzazione
- Inglese, italiano e spagnolo pronti all'uso — la barra di condivisione, il modulo/widget e le schermate di analytics sono forniti tradotti in en-GB, it-IT ed es-ES.
- Rispetta i siti multilingue — condivide l'URL nella lingua propria dell'articolo, così le pagine italiane/spagnole puntano al link corretto e non alla home in lingua predefinita.
Prestazioni e compatibilità
- Rendering leggero e veloce — JS vanilla (nessun framework) e CSS semplice senza passaggi di build né dipendenze impacchettate mantengono le pagine rapide.
- Joomla 5 e 6, WordPress 6.0–7.0 — supporto per CMS moderni su PHP 8.1+, usando solo le API core del CMS.
- Zero dipendenze esterne — nessuna libreria Composer, npm o vendor da verificare o aggiornare.
Sviluppatori e API
- Endpoint di tracciamento di prima parte — le rotte Joomla
com_gmcsocialshare&task=track.hit/.countse le rotte REST WordPress/wp-json/gmc-social-share/v1/hite/countsregistrano e leggono i conteggi. - Protetto da CSRF/nonce — l'endpoint hit richiede un token di form Joomla / nonce REST WordPress e valida la rete rispetto a una whitelist, così i conteggi non possono essere falsificati banalmente.
- Updater protetto da SSRF (WordPress) — l'auto-updater limita rigidamente l'host del pacchetto a fuerteventuratv.net su HTTPS, bloccando gli abusi di redirect/SSRF.
- Disinstallazione pulita — WordPress rimuove le sue opzioni e i suoi dati alla disinstallazione; lo script di auto-riparazione del pacchetto Joomla riordina la topologia dell'update-site e abilita il plugin incluso all'installazione.
Affidabilità e licenza
- Licenza GNU GPL v2 — ricevi la build ufficiale sotto licenza open, per un sito per acquisto (accordi volume/agenzia su richiesta).
- Self-hosted, autonomo — tutto gira sul tuo server; le uniche chiamate in uscita sono il controllo licenza/aggiornamenti verso il server GMC / FuerteventuraTV e, se le abiliti, le tue chiamate di pubblicazione automatica verso Meta.
- Aggiornamenti con un clic sotto licenza — una Download Key dalla tua email di licenza sblocca i controlli automatici degli aggiornamenti (Joomla ~ogni 24h, WordPress ~ogni 12h) mostrati nel normale updater del CMS finché la tua licenza è attiva.
- Continua a funzionare durante le interruzioni — l'abilitazione della licenza viene messa in cache con un fallback all'ultimo stato valido, così un'interruzione temporanea del gateway non disattiva mai un sito con licenza; solo un diniego definitivo blocca il rendering.
- Comprovato in produzione — questa build alimenta la barra di condivisione sul portale turistico del fornitore stesso, fuerteventuratv.net.
- Abbonamento a 39 €/anno — prezzo di fascia media che batte concorrenti comparabili con analytics + pubblicazione automatica, fatturato tramite Stripe.
- Nessun segreto nel prodotto — le chiavi di licenza e i token Meta sono impostazioni runtime/valori d'ambiente, mai committati né spediti.
Joomla e WordPress
- Joomla — fornito come un unico pacchetto che raggruppa quattro estensioni mantenute allineate nella stessa versione: installa lo zip
pkg_gmcsocialshare(non gli zip interni). Aggiunge un modulo footer/sidebar, il controllo del contesto per articolo, la de-duplicazione dei conteggi per sessione e un publisher automatico guidato dallo Scheduler. Il manifest del content-plugin espone tutti i 10 layout (il modulo espone i 7 non fissi). - WordPress — un unico plugin autonomo che usa lo shortcode
[gmcsocialshare], un widget configurabile e il filtrothe_content, con endpoint di tracciamento REST e un publisher automatico WP-cron ogni 15 minuti. Una licenza copre il plugin WP sul suo stesso slug, con parità di funzioni rispetto a Joomla per condivisione, analytics e pubblicazione automatica su Meta.
