Pubblicazione sui Social (dfsocialautopost)
Installa e configura la pubblicazione automatica dei tuoi nuovi prodotti su Facebook, Telegram, X, LinkedIn e Pinterest.
Panoramica
Il modulo DataFirefly Pubblicazione Automatica sui Social (dfsocialautopost) pubblica automaticamente i tuoi nuovi prodotti PrestaShop su cinque social network: Facebook Page, Telegram, X (Twitter), LinkedIn e Pinterest. Non appena un prodotto viene creato o aggiornato, viene messo in coda e poi pubblicato da un cron sicuro, con la sua immagine, il suo prezzo e un messaggio personalizzabile per rete.
Il modulo è compatibile con PrestaShop 8.0-9.x, PHP 7.4-8.3, multinegozio, e non richiede alcuna dipendenza da Composer.
Installazione
- Scarica l’archivio
dfsocialautopost.zipdal tuo account DataFirefly. - Nel back office di PrestaShop, vai su Moduli > Gestore moduli, fai clic su Carica un modulo e seleziona lo ZIP.
- Il modulo si installa, crea la sua tabella di coda, registra i suoi hook e genera un token cron univoco.
- Fai clic su Configura per accedere alle impostazioni.
All’installazione, il modulo congela automaticamente la data di avvio: nessun prodotto esistente viene pubblicato. Solo i prodotti creati o modificati dopo l’installazione entrano nella coda.
Configurazione generale
Modalità di pubblicazione
Sono disponibili due modalità:
- Coda + cron sicuro (consigliato): ogni prodotto viene aggiunto alla coda e pubblicato in background dal cron. È la modalità più affidabile, che non rallenta mai il salvataggio di un prodotto e gestisce i tentativi in modo pulito.
- Immediato (best-effort): la pubblicazione viene tentata direttamente al salvataggio del prodotto. Più semplice da testare, ma dipendente dalla disponibilità delle reti in quel momento.
Il cron sicuro
La pagina di configurazione mostra un URL di cron protetto da un token segreto, con un pulsante di copia. Ha la seguente forma:
https://TUO-DOMINIO/index.php?fc=module&module=dfsocialautopost&controller=cron&token=TUO_TOKENAggiungi questo URL all’attività cron del tuo hosting, ad esempio ogni 5-10 minuti:
*/10 * * * * curl -s "https://TUO-DOMINIO/index.php?fc=module&module=dfsocialautopost&controller=cron&token=TUO_TOKEN" >/dev/null 2>&1Il token impedisce qualsiasi attivazione non autorizzata del cron. Non condividerlo pubblicamente. In caso di fuga, rigeneralo dalla configurazione: il vecchio URL smetterà di funzionare.
Protezione anti-retroattiva
La data di avvio congelata all’installazione garantisce che il tuo catalogo già online non venga mai pubblicato in massa. Puoi avviare la diffusione con tranquillità: escono solo i prodotti nuovi.
Filtri
Puoi affinare ciò che viene pubblicato:
- Per categoria: pubblicare solo i prodotti appartenenti a determinate categorie.
- Per stato attivo: pubblicare solo i prodotti attivi.
- Per data di aggiunta: combinato con la protezione anti-retroattiva.
Connessione dei social network
Ogni rete si attiva in modo indipendente e dispone delle proprie credenziali. Un pulsante Testa la connessione ne verifica immediatamente la validità.
Facebook (Page)
- Page ID: l’identificativo numerico della tua pagina Facebook.
- Page Access Token: un token di accesso di pagina (permessi di pubblicazione), ottenuto tramite un’app Meta / Graph API.
Il modulo pubblica tramite la Graph API (endpoint /feed, o /photos quando è disponibile un’immagine).
Telegram
- Bot Token: il token fornito da @BotFather alla creazione del tuo bot.
- Chat ID: l’identificativo del canale o gruppo di destinazione (il bot deve esservi amministratore).
X (Twitter)
- API Key e API Secret (chiavi consumer).
- Access Token e Access Token Secret.
Il modulo firma le sue richieste con OAuth 1.0a, pubblica il testo tramite l’API v2 e carica l’immagine tramite l’endpoint media v1.1.
- Access Token: token di accesso con permesso di pubblicazione.
- Organization URN: l’URN della tua pagina aziendale, nel formato
urn:li:organization:XXXXXX.
- Access Token: token di accesso dell’API Pinterest v5.
- Board ID: l’identificativo della bacheca su cui appuntare i prodotti.
Modelli di messaggio e variabili
Per ogni rete, componi un modello di messaggio. Le seguenti variabili vengono sostituite al momento della pubblicazione:
{name}— nome del prodotto{price}— prezzo IVA inclusa{price_tax_excl}— prezzo IVA esclusa{reference}— riferimento{description_short}— descrizione breve{url}— URL della scheda prodotto{category}— categoria predefinita{manufacturer}— produttore{quantity}— quantità in stock{shop_name}— nome del negozio
Adatta il tono a ogni rete: breve e diretto su X, visivo su Pinterest, istituzionale su LinkedIn. L’immagine di copertina del prodotto viene inviata automaticamente quando la rete lo consente.
La coda
Il menu di amministrazione del modulo mostra la coda. Ogni riga indica il prodotto, il canale, lo stato, il numero di tentativi, il messaggio e la data. Gli stati possibili sono:
- In coda — in attesa di essere elaborato dal cron.
- In corso — in fase di pubblicazione.
- Pubblicato — diffuso con successo; l’identificativo restituito dalla rete viene conservato.
- Fallito — la pubblicazione è fallita dopo il numero di tentativi consentito.
Sono disponibili due azioni: Ripubblica una riga ed Elabora la coda manualmente dalla barra degli strumenti.
Risoluzione dei problemi
- Non viene pubblicato nulla: verifica che il cron venga effettivamente chiamato (URL + token corretti) e che almeno una rete sia attivata con credenziali valide.
- Una sola rete fallisce: usa il pulsante di test di connessione della rete interessata; un fallimento non impedisce alle altre reti di pubblicare.
- Nessuna immagine: alcune reti richiedono un’immagine accessibile pubblicamente; assicurati che il prodotto abbia un’immagine di copertina.
- Duplicati: la coda deduplica le voci; in modalità immediata, evita di combinarla con il cron sullo stesso prodotto.