Integrazione TikTok Feed: configurazione e aiuto

Nelle versioni precedenti di PrestaShop, usa la pagina di installazione dei moduli equivalente. Apri questo modulo tramite "Configure" ogni volta che vuoi tornare alle sue impostazioni.

Il link al profilo/canale nell’intestazione è annidato nel blocco del titolo della sezione. Imposta Titolo sezione per mostrarlo. Il pulsante separato per seguire/iscriversi ha un proprio interruttore.

La griglia usa tre colonne alle larghezze intermedie fino a 991px e l’impostazione mobile sotto i 768px.

Le impostazioni di colonne e spaziatura si applicano alla griglia. Il carosello usa i propri valori predefiniti per colonne e spaziatura. Controllalo alle larghezze del negozio; usa la griglia quando ti serve il numero di colonne configurato.

Non ti servono token né un account aziendale per il feed basato su URL pubblici. Scegli ogni video manualmente. Inserire un nome utente non importa i futuri post dell’account. Il server chiama https://www.tiktok.com/oembed?url=... per ogni URL accettato e salta le risposte non riuscite. Il negozio mostra una miniatura, un indicatore di riproduzione, didascalia/autore facoltativi e un link facoltativo per seguire il profilo. Un clic apre il video su TikTok in una nuova scheda. Il modulo non incorpora un player TikTok nella pagina.

Il modulo salva gli elementi recuperati in:

modules/mprtiktokintegration/mprtiktok_feed_cache.json

Il processo del server web deve poter scrivere questo file nella cartella del modulo. Mantieni i normali permessi di proprietario/gruppo del tuo hosting. Non serve un’attività cron per visualizzare il feed. Una richiesta al negozio recupera i dati dopo la scadenza della cache. Salvare il modulo principale del feed svuota la cache. Il file è condiviso tra i contesti negozio del modulo, senza un file separato per ogni negozio.

Salvare il modulo del feed svuota la cache. L’azione di svuotamento della cache distingue maiuscole e minuscole. La grafia refreshMprTiktokCache non è accettata; il parametro richiesto è refreshMPRTiktokCache. Il modulo principale fornito non ha un pulsante visibile per svuotare la cache. Usa Salva o chiedi all’amministratore di rimuovere solo il file della cache.

Vengono salvati solo i risultati non vuoti. Un recupero vuoto o non riuscito nasconde il feed e può essere ritentato con richieste successive al negozio. Se gli elementi sembrano obsoleti, controlla la fonte e svuota la cache. Conteggi API e date relative riflettono la risposta in cache, non un abbonamento in tempo reale nel browser.

Il modulo separato "Automatic TikTok submission" contiene:

Il pannello "TikTok submissions" richiede MPR Blog Revolution. Offre "Submit to TikTok" e "Check status". Lo stato può essere "Not submitted", in elaborazione, "Confirmation required in TikTok", Pubblicato, "Blocked" o "Failed". Un ID di pubblicazione restituito indica che TikTok ha accettato l’invio per elaborarlo. Usa "Check status" prima di riprovare. Se l’account richiede conferma, completala in TikTok.

La visualizzazione del feed e la pubblicazione sono separate. Il publisher invia un URL video alla Content Posting API di TikTok con PULL_FROM_URL e privacy SELF_ONLY. Il controllo della connessione richiede attualmente un token di accesso non vuoto; la mappa di configurazione include anche la chiave client. Qui il modulo non offre un flusso di autorizzazione OAuth.

Gli invii dal blog usano l’immagine in evidenza dell’articolo da img/mprblogrevolution/posts/, ma la pubblicazione su TikTok richiede un video. Una normale immagine del blog non può essere pubblicata come video TikTok. Mantieni l’invio automatico disattivato finché la tua installazione non fornisce contenuti video adatti.

Salvare il modulo principale del feed elabora anche le chiavi separate dell’invio automatico e può reimpostare l’interruttore/la didascalia. Configura prima il feed, poi salva il modulo di invio separato e ricontrollalo dopo i futuri salvataggi del feed. La policy di scrittura in uscita può bloccare host di sviluppo/staging o non risolti. Il pannello ne indica il motivo. Anche il flag di presa in carico TikTok di Social Revolution impedisce la pubblicazione autonoma.

Gli esempi seguenti descrivono i valori da inserire nei moduli del back office. Non sono comandi shell. Sostituisci nomi degli account, ID di pin/video e credenziali con valori reali. L’hook del tema deve corrispondere a Hook di visualizzazione.

Aggiungi video TikTok pubblici, uno per riga:

https://www.tiktok.com/@yourbrand/video/1234567890123456789
https://www.tiktok.com/@yourbrand/video/9876543210987654321
https://www.tiktok.com/@yourbrand/video/1122334455667788990

Configurazione della griglia in homepage:

ENABLED=1
DISPLAY_HOOK=displayHome
TITLE=Watch us on TikTok
LAYOUT=grid
POST_COUNT=6
COLUMNS=3
MOBILE_COLUMNS=1
GAP=16
BORDER_RADIUS=8
SHOW_FOLLOW_BTN=1
FOLLOW_TEXT=Follow

Configurazione di uno slider compatto sopra il footer:

DISPLAY_HOOK=displayFooterBefore
LAYOUT=slider
POST_COUNT=6
COLUMNS=3
MOBILE_COLUMNS=1
AUTO_SCROLL=1
SCROLL_SPEED=5000
LAZY_LOAD=1
CACHE_DURATION=3600

Renderizza manualmente l’hook selezionato in un template del tema se il tema supporta gli hook Smarty:

{hook h='displayHome' mod='mprtiktokintegration'}

Usa le classi CSS del feed nel foglio di stile del tema o nel CSS personalizzato:

.mprfeed-tiktok .mprfeed-title {
  font-size: 24px;
}

.mprfeed-tiktok .mprfeed-grid {
  --mprfeed-gap: 20px;
}

.mprfeed-tiktok .mprfeed-follow-btn {
  border-radius: 4px;
}

Segnaposto facoltativi del template della didascalia per la pubblicazione automatica:

{title}

{excerpt}

Read more: {url}

Segnaposto disponibili per il template di pubblicazione:

{title}
{excerpt}
{url}
{shop_name}

Per un carosello, verifica il limite effettivo di dimensionamento descritto sopra. Mantieni le modifiche CSS e ai template nel tema.

• Se la sezione non compare, controlla Attiva modulo, i campi delle fonti, Mostra su mobile e l’hook selezionato. Il modulo non restituisce alcuna sezione quando non ci sono elementi disponibili.
• Verifica che il tema chiami displayHeader per caricare il foglio di stile e JavaScript e renderizzi l’hook di visualizzazione selezionato.
• Se le immagini restano vuote, controlla gli errori di rete del browser. Prova a disattivare il caricamento differito e verifica gli URL delle immagini.
• Se il layout è errato, prova prima la griglia, poi verifica il carosello alle larghezze desktop e mobile.
• Se MPR Social Revolution ha l’impostazione TIKTOK_ACTIVE attiva, questo feed autonomo viene soppresso. Il controllo legge il flag salvato; non richiede che Social Revolution sia attualmente attivo come modulo.

Apri la pagina "Integrity" del modulo per i controlli di configurazione e hook. Licenza, Assistenza e Aggiorna sono pagine di manutenzione. Prova le destinazioni effettive dopo aver modificato gli identificativi degli account o le fonti del feed.

Imposta Attiva modulo su No e salva per nascondere il feed mantenendo la configurazione. L’interruttore del feed non disattiva la pubblicazione. Disattiva anche l’interruttore di pubblicazione separato, se lo usi. Salva il modulo di pubblicazione dopo quello principale del feed. Disinstalla dal gestore moduli per rimuovere configurazione, cache locale e voci del menu amministrativo del modulo. Le tabelle condivise mpr_social_publish e mpr_social_queue sono contrassegnate come condivise e mantenute alla disinstallazione. La disinstallazione non elimina i post già inviati alla piattaforma.