 |
Riepilogo | Consente di importare automaticamente contenuti da feed RSS/ATOM nel tuo sito Discourse come argomenti |
 |
Guida all’installazione | Questo plugin è incluso nel nucleo di Discourse. Non è necessario installarlo separatamente. |
Questa guida spiega come configurare e utilizzare il plugin RSS Polling per importare automaticamente contenuti da feed RSS/ATOM nel tuo sito Discourse come argomenti.
Livello utente richiesto: Amministratore
Riepilogo
Questa documentazione copre l’attivazione del plugin RSS Polling, la configurazione degli URL dei feed, la gestione delle impostazioni e la risoluzione dei problemi comuni. Imparerai a configurare i feed per pubblicare in categorie specifiche, assegnare autori e controllare come i contenuti vengono visualizzati sul tuo sito.
Attivare il plugin RSS Polling
Siti self-hosted
Vai al pannello di amministrazione in Admin > Plugin e individua il plugin RSS Polling. Attivalo usando l’interruttore:
Ospitati da Discourse
Se il tuo sito è ospitato da Discourse, contatta il team di supporto per richiedere l’attivazione del plugin RSS Polling. Il plugin è disponibile su tutti i piani ospitati.
Configurare i feed RSS
Una volta attivato il plugin, accedi alla pagina di configurazione di RSS Polling visitando direttamente Admin > Plugin > RSS Polling, oppure navigando in /admin/plugins e selezionando “RSS Polling” dal menu laterale.
Aggiungere un nuovo feed RSS
- Inserisci l’URL del feed RSS o ATOM nel campo “URL del feed”
- Seleziona un utente esistente del tuo sito come “Autore” - questo utente sarà il proprietario di tutti i post creati dal feed
- Scegli una categoria Discourse in cui verranno pubblicati gli argomenti del feed
- Clicca sul pulsante di salvataggio
Opzionale: Aggiungi tag che verranno applicati a tutti gli argomenti di questo feed e/o inserisci un filtro di categoria del feed per limitare quali elementi del feed vengono importati
Filtro di categoria del feed
L’impostazione del filtro di categoria del feed ti consente di limitare quali elementi del feed vengono pubblicati in base ai metadati di categoria dell’elemento. Quando inserisci un termine di categoria in questo campo, solo gli elementi del feed che corrispondono a quella specifica categoria verranno importati in Discourse.
Ad esempio, se esamini il feed all’indirizzo https://blog.discourse.org/feed.xml, vedrai che ogni voce ha informazioni sulla categoria. Dovresti inserire il valore della proprietà term della categoria per filtrare per categorie specifiche.
Configurazione dei feed YouTube
esempi comuni
YouTube è una delle piattaforme più comuni utilizzate con RSS Polling, ma è anche facile configurarla in modo errato. Di seguito sono riportati i formati di URL dei feed raccomandati e supportati per i casi d’uso YouTube più comuni.
Importare una playlist YouTube
Per importare video da una playlist YouTube, devi utilizzare l’endpoint RSS di YouTube per le playlist.
Il formato corretto è:
https://www.youtube.com/feeds/videos.xml?playlist_id=<ID-PLAYLIST>
Dove <ID-PLAYLIST> è il token trovato nell’URL della playlist.
Ad esempio, dato questo URL della playlist:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
L’URL del feed RSS corretto sarebbe:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Importare un canale YouTube
Per importare video da un canale YouTube, utilizza il formato del feed RSS del canale:
https://www.youtube.com/feeds/videos.xml?channel_id=ID_CANALE
Puoi trovare l’ID_CANALE su YouTube sotto Impostazioni avanzate per il canale.
Utilizzare direttamente un URL del canale, un URL con nome utente o un URL di canale personalizzato non funzionerà. Il plugin RSS Polling richiede l’URL del feed esplicito con
channel_id.
Errori comuni da evitare
- Utilizzare URL di pagine YouTube standard invece di URL di feed RSS
- Utilizzare URL di playlist o canali senza estrarre l’ID corretto
- Mescolare parametri di playlist e canale nello stesso URL del feed
Se un feed YouTube è configurato in modo errato, il plugin RSS Polling potrebbe fallire silenziosamente o smettere di importare nuovi argomenti.
Configurare la frequenza di polling
L’impostazione del sito rss polling frequency controlla la frequenza con cui Discourse verifica i feed RSS per nuovi contenuti. Il valore predefinito è 30 minuti, con un valore minimo consentito di 10 minuti e un massimo di 180 minuti (3 ore).
Siti self-hosted
Per regolare la frequenza di polling:
- Vai a
/admin/site_settings - Cerca “rss polling frequency”
- Imposta l’intervallo desiderato in minuti
Siti ospitati
Contatta il team di supporto per richiedere una modifica all’impostazione del sito rss_polling_frequency.
Gestire le impostazioni dei feed
Modificare l’autore del feed
Puoi modificare l’autore di tutti gli argomenti associati a un feed RSS specifico aggiornando il campo “Autore” nella pagina delle impostazioni di RSS Polling. Questo aggiornerà automaticamente tutti gli argomenti esistenti di quel feed con il nuovo autore. Queste modifiche appaiono come eventi di modifica post di sistema nei tuoi log di amministrazione.
Modificare la categoria o i tag del feed
Modificare la categoria o i tag di un URL di feed RSS non aggiornerà automaticamente gli argomenti esistenti. Dovrai:
- Utilizzare le Operazioni di massa amministrative per spostare manualmente gli argomenti esistenti nella nuova categoria o aggiornare i tag
- Aggiornare le impostazioni del feed RSS in modo che i nuovi argomenti utilizzino la categoria e i tag corretti
Limitazioni dell’URL del feed
Ogni URL di feed RSS unico verrà importato una sola volta in Discourse. Quando configuri per la prima volta un feed RSS, Discourse importa l’intero feed. Eliminare e riaggiungere lo stesso URL del feed non causerà la riesportazione degli elementi già elaborati.
Controllare la visibilità degli argomenti
Impedire che gli argomenti vengano rimossi dall’elenco
Di default, gli argomenti incorporati vengono rimossi dall’elenco fino a quando non ricevono una risposta. Questo comportamento non ha senso per gli argomenti importati via RSS. Per impedire che gli argomenti RSS vengano rimossi dall’elenco:
- Vai a
/admin/site_settings - Cerca “embed unlisted”
- Disabilita questa impostazione
Mostrare il contenuto completo del post
Se l’impostazione del sito embed truncate è abilitata (predefinito), gli argomenti del feed mostreranno solo un estratto. Gli utenti possono visualizzare il contenuto completo cliccando sul pulsante “Mostra post completo”.
Per mostrare sempre il contenuto completo:
- Vai ad Admin > Impostazioni sito
- Cerca “embed truncate”
- Disabilita questa impostazione
Se il contenuto completo del post non viene visualizzato correttamente, configura l’impostazione del sito embed whitelist selector per specificare quali elementi HTML devono essere importati.
Problemi comuni e soluzioni
Il feed non si aggiorna
Controlla che:
- L’URL del feed RSS sia valido e accessibile
- La frequenza di polling non sia stata impostata troppo alta
- Ci siano effettivamente nuovi elementi nel feed RSS dall’ultimo polling
L’interfaccia del plugin non risponde
Alcuni utenti segnalano problemi con l’interfaccia di configurazione di RSS Polling che non risponde. Questo è spesso causato da ad-blocker del browser che interferiscono con l’interfaccia di amministrazione. Prova a:
- Disabilitare gli ad-blocker per il tuo sito Discourse
- Utilizzare un browser diverso
- Aggiornare forzatamente la pagina
Argomenti creati con date errate
Di default, gli argomenti RSS utilizzano la data corrente quando importati. Se desideri utilizzare la data di pubblicazione originale dal feed RSS, abilita l’impostazione rss polling use pubdate.
FAQ
Quanto spesso posso fare polling sui feed RSS?
La frequenza di polling minima è 10 minuti, la massima è 180 minuti (3 ore).
Posso importare risposte dai feed RSS?
No, il plugin RSS Polling importa solo gli elementi principali del feed come argomenti individuali. Non importa commenti o risposte.
Eliminare e riaggiungere un feed causerà argomenti duplicati?
No, ogni elemento del feed RSS viene importato una sola volta. Riaggiungere un feed non creerà duplicati.
Come posso risolvere i problemi di polling RSS?
Attualmente, il plugin ha una registrazione limitata. Controlla i log di Discourse in Amministratori > Sicurezza > Pannello Log per eventuali messaggi di errore relativi al polling RSS.
Questo plugin è ora incluso nel core di Discourse come parte di 