 |
Riepilogo | Consente di importare automaticamente i contenuti da feed RSS/ATOM nel tuo sito Discourse come argomenti |
 |
Guida all’installazione | Questo plugin è incluso nel nucleo di Discourse. Non è necessario installare il plugin separatamente. |
Questa documentazione illustra come configurare e utilizzare il plugin RSS Polling per importare automaticamente i contenuti dai feed RSS nella tua community Discourse come argomenti.
Configurare i feed RSS
Per abilitare il plugin, vai su Amministratori → Plugin installati, trova il plugin RSS Polling e attiva l’interruttore.
Una volta abilitato, clicca su Impostazioni e poi sul pulsante Aggiungi feed per configurare il tuo primo feed.
Dovrai inserire le seguenti informazioni:
- URL del feed: L’URL del feed RSS o Atom da importare.
- Filtro categoria (opzionale): Limita quali elementi del feed vengono importati in base ai metadati della categoria dell’elemento. Verranno importati in Discourse solo gli elementi la cui categoria nel feed corrisponde al valore inserito. Ad esempio, se un feed include elementi contrassegnati con più categorie, puoi inserire un termine di categoria specifico per importare solo quegli elementi.
- Autore: Un utente Discourse esistente che verrà elencato come autore di tutti gli argomenti importati da questo feed.
- Categoria: La categoria Discourse in cui verranno pubblicati gli argomenti importati.
- Tag: Uno o più tag che verranno applicati a tutti gli argomenti provenienti da questo feed.
Clicca su Salva per aggiungere il feed.
🎥 Esempio comune: Feed YouTube
Importare una playlist YouTube
Utilizza il punto di accesso del feed RSS di YouTube per le playlist:
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 corretto è:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Importare 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.
L’uso diretto di un URL del canale standard, un URL del nome utente o un URL del canale personalizzato non funzionerà. Il plugin RSS Polling richiede il formato esplicito dell’URL del feed
id_canale.
Testare i feed
Prima di salvare un feed nuovo o modificato, clicca su Testa feed per recuperare e analizzare il feed senza importare nulla. Vedrai:
- Un conteggio riepilogativo di quanti elementi verrebbero importati, sono già importati o verrebbero ignorati.
- Un dettaglio riga per riga dei primi elementi del feed, ciascuno con una spiegazione in linguaggio chiaro del motivo per cui verrebbe importato o ignorato.
Questo è utile per verificare la tua configurazione — in particolare il filtro categoria — prima che influisca sulla tua community.
Sondaggi recenti
Nella pagina di modifica di qualsiasi feed esistente, l’area Sondaggi recenti mostra gli ultimi tentativi di polling. Ogni tentativo visualizza i conteggi degli elementi importati, aggiornati, ignorati e falliti. Puoi espandere qualsiasi tentativo per vedere i dettagli per elemento, inclusi i link agli argomenti che sono stati creati o aggiornati.
Quando clicchi su Polling ora, i risultati appaiono in tempo reale senza aggiornare la pagina.
Impostazioni
La scheda Impostazioni collega alle impostazioni del sito rilevanti per RSS Polling.
| Nome | Descrizione |
|---|---|
rss polling feed request timeout |
Quanto tempo (in secondi) attendere prima di rinunciare a una richiesta di feed lenta. Il valore predefinito è di 30 secondi. |
rss polling verbose logging |
Abilita la registrazione dettagliata per elemento per ogni tentativo di polling. Disattivato per impostazione predefinita; utile per la risoluzione dei problemi. |
rss polling use pubdate |
Utilizza la data di pubblicazione originale dall’elemento del feed come data dell’argomento, invece della data di importazione. |
rss polling update tags |
Aggiorna i tag dell’argomento quando un argomento viene aggiornato; quando disabilitato, recupera solo i tag iniziali. |
Controllare la visibilità degli argomenti
Impedire che gli argomenti siano non elencati
Per impostazione predefinita, gli argomenti incorporati non sono elencati fino a quando non ricevono una risposta. Per impedire che gli argomenti importati da RSS siano non elencati:
- Vai su Amministratore → Tutte le impostazioni del sito.
- Cerca
embed unlisted. - Disabilita questa impostazione.
Mostrare il contenuto completo del post
Se l’impostazione embed truncate è abilitata (il valore predefinito), gli argomenti del feed mostreranno solo un estratto. Per mostrare il contenuto completo:
- Vai su Amministratore → Tutte le impostazioni del sito.
- Cerca
embed truncate. - Disabilita questa impostazione.
Se il contenuto completo del post non viene ancora visualizzato correttamente, configura l’impostazione embed whitelist selector per specificare quali elementi HTML devono essere importati.
Problemi comuni
Il feed non si aggiorna
- Conferma che l’URL del feed sia valido e pubblicamente accessibile.
- Controlla che
rss polling frequencynon sia impostata troppo in alto. - Verifica che ci siano nuovi elementi nel feed dall’ultimo polling.
- Usa il pulsante Testa feed per controllare cosa vede il plugin nel feed senza eseguire un polling completo.
- Abilita
rss polling verbose loggingper maggiori dettagli su ciò che accade durante ogni polling.
Argomenti creati con date errate
Abilita l’impostazione rss polling use pubdate per utilizzare la data di pubblicazione originale dall’elemento del feed invece della data di importazione.
Ogni URL del feed viene importato una sola volta
Eliminare e aggiungere nuovamente lo stesso URL del feed non reimporterà gli elementi elaborati in precedenza. Ogni elemento RSS viene importato una sola volta.