Social Revolution: configurazione e aiuto

Carica e installa lo ZIP mprsocialrevolution in Moduli > "Module Manager". Apri Social media nel back office. Il modulo offre Pannello di controllo, Account, Collega piattaforma, Scrivi post, Coda di pubblicazione, Articoli pubblicati, Campagne, Modelli didascalia, Impostazioni del feed, Analitica, Conversioni, Impostazioni e Cron e pianificatore, con pagine di configurazione e manutenzione in Impostazioni.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Inizia con un account collegato e un post di prova. Pubblicazione, feed nel negozio e tracciamento pubblicitario usano configurazioni separate. Collegare un account di pubblicazione non configura automaticamente un pixel né crea impostazioni di visualizzazione dei feed.

Seleziona il contesto del negozio previsto prima di modificare configurazione o elementi della coda. Le impostazioni di pubblicazione vengono risolte prima per negozio, poi per gruppo di negozi e infine globalmente. I post in coda sono associati all'identità del negozio e dell'account remoto; un elemento di un altro negozio o di un negozio sconosciuto richiede una riconciliazione.

Apri Collega piattaforma. Salva le credenziali della piattaforma, poi segui il suo flusso di autorizzazione. Dove richiesto, copia l'URL di callback generato dal modulo nella configurazione della tua app presso il provider. Completa l'autorizzazione per l'account, la Pagina, l'organizzazione o la bacheca che intendi usare.

Le credenziali sono inizialmente vuote. Dopo il collegamento, controlla Account. Gli account scaduti, revocati o che richiedono una riconnessione bloccano la pubblicazione. Ricollegali prima di ritentare il lavoro in coda. Un account con scadenza sconosciuta ha un proprio stato; non significa che il token sia valido.

Per pubblicare servono l’interruttore principale attivo, componenti di pubblicazione compatibili, l’account corretto e un negozio autorizzato a pubblicare. I negozi di sviluppo e staging sono bloccati salvo autorizzazione esplicita del tuo amministratore. Una connessione riuscita o una didascalia salvata non significa che un post sia stato pubblicato.

Apri Social media > Impostazioni > Configurazione. Il formulario si intitola Impostazioni Social Revolution e si salva con Salva configurazione.

Pubblicazione

Credenziali app

ID app Meta/App Secret Meta, Client ID LinkedIn/Client Secret LinkedIn, ID app Pinterest/App Secret Pinterest, Client Key TikTok/Client Secret TikTok e Client ID YouTube/Client Secret YouTube sono tutti vuoti per impostazione predefinita. Inserisci le credenziali delle applicazioni per le piattaforme che usi oppure salvale tramite Collega piattaforma. Scope OAuth TikTok ha come valore predefinito user.info.basic. I campi YouTube non attivano un sistema di pubblicazione YouTube funzionante.

Queue

Limite tentativi ha come valore predefinito 3 e diventa il numero massimo di tentativi per l'elemento in coda. Non significa tre nuovi tentativi oltre al primo. Ritardo nuovo tentativo ha come valore predefinito 300 secondi e costituisce la base dell'attesa progressiva tra i tentativi. I tentativi automatici si applicano solo agli errori classificati come ripetibili. Configurazione, autorizzazione, convalida, account non corrispondenti ed esiti remoti incerti possono richiedere una correzione manuale o una riconciliazione.

Analitica

Analytics attivo è attivo per impostazione predefinita. Le statistiche contano i post pubblicati e non riusciti per account. Copertura, impressioni, interazioni, clic e follower mostrano zero perché queste metriche delle piattaforme non sono disponibili; gli zeri non indicano attività del pubblico misurata.

Feed

Giorni conservazione immagini feed ha come valore predefinito 7. Immagini feed da conservare ha come valore predefinito 120 per piattaforma. Controllano conservazione e pulizia delle immagini nella cache. L’installazione salva anche un valore di cache del feed di 3600 secondi (FEED_CACHE_DURATION); questo formulario non offre un controllo per modificarlo.

"Theme styles"

I controlli condivisi degli stili del tema usano i valori rilevati nel tema. I prefissi dei feed Facebook e Instagram sono mprfacebook e mprinstagram. Le relative mappature registrate includono colore primario, primario al passaggio del mouse, testo, testo attenuato, sfondi, bordo, raggio, ombre e transizione. Modifica questi controlli quando gli stili rilevati richiedono un adeguamento.

Apri Scrivi post e controlla Pubblica su. Scrivi Didascalia base, poi controlla il campo della didascalia di ogni piattaforma selezionata. La didascalia di base viene copiata nelle didascalie delle singole piattaforme. Controlla il testo copiato prima di salvare o pubblicare.

Aggiungi URL link e Titolo dove disponibili. Usa URL di contenuti multimediali accessibili. Instagram, Pinterest e TikTok richiedono contenuti multimediali nel compositore. La pubblicazione su YouTube non è disponibile.

Scegli la pubblicazione immediata o una pianificazione futura. Usa in modo coerente l'ora configurata per negozio/server e controlla la data e l'ora salvate nella coda. La convalida della pianificazione applica la finestra massima e l'intervallo LinkedIn. Un post pianificato richiede cron per essere pubblicato.

I dati salvati usano nomi quali:

platforms[]=facebook
platforms[]=linkedin
platform_data[facebook][caption]=Specific Facebook caption
platform_data[facebook][link]=https://example.com/article
platform_data[linkedin][caption]=Specific LinkedIn caption
platform_data[linkedin][link]=https://example.com/article
platform_data[linkedin][title]=Article title
media_urls[]=https://example.com/image.jpg
schedule_at=2026-11-01 09:30:00
id_campaign=12

Il formulario effettivo usa anche un token di invio. Non reinviare i dati come alternativa al flusso protetto del back office.

In Campagne, imposta Nome, Descrizione facoltativa, Piattaforme, Stato, Data di inizio e Data di fine. Lo stato iniziale è Bozza; le altre opzioni sono Attivo, In pausa e Completato. Apri una campagna salvata per aggiungere post tramite il compositore. Controlla le righe della coda risultanti; le sole date di una campagna non creano il contenuto dei post.

In Modelli didascalia, inserisci Nome, Piattaforma facoltativa oppure Tutte le piattaforme, Modello e Predefinito. I nuovi campi di testo sono inizialmente vuoti; Predefinito è una scelta booleana. Usa un modello specifico per piattaforma quando lunghezza o formulazione della didascalia differiscono.

Il modulo sostituisce le variabili fornite dalla fonte del contenuto, tra cui {title}, {excerpt}, {url}, {shop_name} e il valore facoltativo {hashtags}. I contenuti automatici di prodotti e blog non forniscono hashtag per impostazione predefinita. Le variabili in minuscolo non risolte vengono rimosse. Per esempio:

{title}

{excerpt}

Shop now: {url}

{hashtags}

I formati di ripiego inclusi per le piattaforme sono:

facebook:  {title}\n\n{excerpt}\n\nRead more: {url}
instagram: {title}\n\n{excerpt}\n\n{url}
x:         {title}\n\n{url}
linkedin:  {title}\n\n{excerpt}\n\n{url}
pinterest: {excerpt}
tiktok:    {title} {url}

Apri Cron e pianificatore e copia l'URL esatto generato con il relativo token. Configura il pianificatore per richiamarlo ogni minuto. Ecco un esempio senza riscrittura URL:

curl 'https://yourshop.com/index.php?fc=module&module=mprsocialrevolution&controller=cron&token=YOUR_TOKEN'

Il token è obbligatorio. Il controller restituisce 401 se il token manca, 403 se non è valido e 503 quando cron è disattivato. Invia X-Robots-Tag: noindex, nofollow, noarchive. I parametri di esecuzione facoltativi includono max_tasks e max_seconds; usa le istruzioni del pianificatore generate per la tua installazione.

Le attività registrate includono elaborazione della coda ogni 60 secondi, aggiornamento dei feed ogni 1800 secondi, rinnovo dei token e recupero delle immagini mancanti dei feed ogni 3600 secondi, analisi quotidiana alle 06:00 ed elaborazione della coda conversioni dei provider ogni 300 secondi. Sono intervalli di scadenza delle attività; l'invocazione esterna deve essere effettivamente eseguita.

Usa Coda di pubblicazione per controllare gli stati in attesa, falliti, bloccati e di riconciliazione. Usa Articoli pubblicati per gli esiti remoti registrati. Controlla la destinazione reale prima di ritentare un esito sconosciuto: il post remoto può esistere anche se non è stato possibile salvarne la ricevuta. Ricollegare un account diverso non cambia la destinazione di una vecchia riga della coda; componi un nuovo post per una destinazione diversa.

La visualizzazione dei feed è implementata solo per Facebook e Instagram. Il modulo può visualizzarli in displayHome, displayFooterBefore, displayFooter, displayLeftColumn e displayRightColumn, purché esistano un account attivo e una configurazione del feed corrispondente.

Impostazioni del feed mostra lo stato degli account collegati e l’azione "Optimize existing feed images". L’attivazione del feed, la posizione, il layout e i dettagli visualizzati non si possono configurare da questa schermata e non vengono impostati durante l’installazione. Collegare un account e assegnare un hook non completa la configurazione del feed.

Chiedi al tuo amministratore o all’assistenza di configurare il feed, poi controllalo nel negozio. Le seguenti chiavi di configurazione servono per questa integrazione e non sono campi della schermata delle impostazioni:

FEED_FACEBOOK_ENABLED=1
FEED_FACEBOOK_DISPLAY_HOOK=displayHome
FEED_FACEBOOK_POST_COUNT=8
FEED_FACEBOOK_LAYOUT=grid
FEED_FACEBOOK_COLUMNS=4
FEED_FACEBOOK_MOBILE_COLUMNS=2

FEED_INSTAGRAM_ENABLED=1
FEED_INSTAGRAM_DISPLAY_HOOK=displayFooterBefore
FEED_INSTAGRAM_LAYOUT=slider
FEED_INSTAGRAM_AUTO_SCROLL=1
FEED_INSTAGRAM_SCROLL_SPEED=5000

Per ogni prefisso FEED_{PLATFORM}_, il sistema di visualizzazione legge queste opzioni:

L'aggiornamento del feed conserva l'ultima cache utilizzabile se un recupero fallisce. Lo strumento per la cache immagini ridimensiona e genera i formati supportati da GD/Imagick sul tuo server. Richiede permessi di modifica e percorsi della cache scrivibili. I feed sono disponibili solo per Facebook e Instagram.

I selettori del tema includono .mprfacebook-section, .mprfacebook-grid, .mprfacebook-follow-btn, .mprinstagram-section, .mprinstagram-grid e .mprinstagram-slider-btn. Controlla il markup effettivamente generato prima di applicare CSS. Non presumere che esista un selettore generico di social wall unificato per ogni percorso di output.

Le credenziali degli account di pubblicazione e quelle del tracciamento pubblicitario sono separate. Apri la scheda di tracciamento del provider in Impostazioni > Configurazione, attiva il suo tag nel browser e inserisci l'identificatore di tracciamento corretto. Lascia attivi solo gli eventi che intendi usare. Configura poi separatamente l'invio dal server, se necessario.

Il tracciamento è implementato per Facebook, Pinterest, Microsoft Ads, Google Ads, LinkedIn, TikTok, X, Snapchat, Reddit, Taboola e Outbrain. L'invio dal server richiede credenziali del provider e attività di conversione pianificate. L'accodamento delle conversioni da clic di Google Ads è attivo per impostazione predefinita, mentre il caricamento API è disattivato.

Usa i controlli di assegnazione del tracciamento nella pagina di configurazione se più moduli installati competono per gli stessi identificatori dei provider. Il traffico interno è controllato dalla sezione condivisa delle regole negozio/modulo/funzionalità. I moduli dei singoli provider non includono più Escludi dipendenti; usa la regola condivisa per il traffico interno.

Rispetta consenso cookie è attivo per impostazione predefinita per ogni provider. Il modulo legge i cookie di consenso MPR supportati e il relativo stato. Senza una decisione di consenso marketing concessa, il tracciamento che richiede consenso resta bloccato; l'assenza di un modulo di consenso non lo autorizza automaticamente. Prova sia il rifiuto sia l'accettazione, incluso l'invio dal server tramite coda.

Vuoto significa che il modulo non fornisce credenziali o identificatori. Un interruttore evento con valore predefinito 1 non attiva il tracciamento se l'interruttore principale del provider è disattivato. Il tuo tema deve anche inviare gli eventi di interazione corrispondenti.

Tracciamento Facebook

Tracciamento Pinterest

Tracciamento Microsoft Ads

Tracciamento Google Ads

Tracciamento LinkedIn

Tracciamento TikTok

Tracciamento X

Tracciamento Snapchat

Tracciamento Reddit

Tracciamento Taboola

Tracciamento Outbrain

La scheda Tracciamento Facebook include anche un pannello di stato/verifica della connessione e una guida di configurazione. Usa i suoi campi esatti per ID pixel, token di accesso ed eventi di prova per verificare la connessione al server.

Il formulario attuale e il runtime non offrono la vecchia configurazione JSON di eventi personalizzati con selettori di clic arbitrari. Non aggiungere i precedenti esempi GalleryBrowse, conversion_label o x_event_id come valori di configurazione non documentati. Le etichette Google e gli ID X per evento nelle tabelle sono controlli supportati.

Pubblicazione

Collega un account, lascia l’opzione Pubblicazione attiva su Sì e crea una didascalia specifica per una destinazione selezionata. Pianificala a breve, confermala in Coda di pubblicazione, richiama il cron configurato e verifica il post remoto e la ricevuta in Articoli pubblicati. Ripeti una pubblicazione immediata solo se intendi creare un altro post reale.

Se la pubblicazione è bloccata, leggi la causa segnalata. Controlla l'interruttore principale, lo stato dell'account, l'identità della destinazione, le regole dell'host, l'accesso di modifica del dipendente e la compatibilità del pacchetto condiviso. Un esito remoto sconosciuto richiede riconciliazione prima di ritentare. Un post pianificato fallito non è necessariamente idoneo a un nuovo tentativo automatico.

Feed

Controlla che il feed della piattaforma sia attivo, che l'hook esatto sia configurato, che l'account collegato sia attivo e che esistano post nella cache o dall'API. Controlla il negozio nei layout desktop e mobile. Un feed compare solo dove ha una posizione attiva, qualunque sia lo stato mostrato in Impostazioni del feed.

Tracciamento

Esegui le prove come visitatore consentito dalle regole sul traffico interno. Verifica prima il rifiuto del marketing e poi l'accettazione. Attiva i flussi scelti di prodotto, carrello, checkout, ricerca, registrazione e acquisto supportati dal tuo negozio. Controlla gli strumenti browser del provider, i risultati delle conversioni del modulo, gli esiti di cron e i rapporti di prova del provider. Conferma che un acquisto sia associato all'ordine e agli ID del provider previsti.

Se il tag browser manca, controlla l'interruttore del provider, l'ID di tracciamento, l'assegnazione, il traffico interno, il consenso e le risorse caricate. Se gli eventi server non arrivano, controlla gli interruttori di invio dal server, i token del provider, le regole/etichette di conversione, gli errori della coda e cron. Il caricamento Google richiede anche i suoi identificatori cliente/azione e una chiave dell'account di servizio leggibile. Attivare un interruttore da solo non completa la configurazione del provider.

Usa Integrità per gli errori del database e degli hook. Le metriche del pubblico non sono disponibili. Usa gli strumenti della piattaforma per rispondere ai commenti e gestire la posta in arrivo.

Prima di disinstallare, annota la configurazione degli account, lo stato della coda e la cronologia. La disinstallazione rimuove la registrazione del tema, le attività cron, i menu amministrativi, la configurazione, le righe della coda conversioni del modulo e le tabelle dello schema di proprietà del modulo, come account, campagne, modelli e analisi. Le tabelle condivise di pubblicazione/coda sono contrassegnate come condivise e non vengono eliminate dalla pulizia dello schema. La disinstallazione lascia sul disco i file di cache dei feed e delle immagini. Se rimuovi il pacchetto, controlla separatamente i file del modulo rimasti.

La disinstallazione del modulo non elimina i post social remoti né i record delle piattaforme pubblicitarie. Se la pulizia della registrazione del tema fallisce, la disinstallazione restituisce un errore prima delle restanti operazioni di rimozione. Disattiva il modulo quando vuoi conservare i dati installati interrompendo i suoi normali hook.