Onebox per il polling RSS

[Sailor (Peter Petrik)]

	Riepilogo	RSS Polling Onebox rende le importazioni di RSS Polling come onebox dell’articolo originale, con facoltativi riassunti dei feed, descrizioni di YouTube e formati del titolo
	Link al repository	Peter-Petrik/discourse-rss-onebox
	Guida all’installazione	Come installare i plugin in Discourse

Funzionalità

1. Rendering onebox: le importazioni di RSS Polling nelle categorie scelte diventano una onebox dell’URL dell’articolo - titolo, immagine e descrizione dalla pagina dell’articolo - invece del corpo del feed troncato al primo paragrafo. Le importazioni in altre categorie restano invariate.
2. “Mostra post completo” nascosto solo nelle categorie scelte.
3. Riassunti dei feed (facoltativo): quando una pagina dell’articolo non ha una descrizione propria, il riassunto dal feed appare all’interno della onebox, o sotto il link se non è possibile costruire una onebox.
4. Descrizioni di YouTube (facoltativo): la descrizione completa del video dal feed del canale appare sotto il player, con a capo e link cliccabili.
5. Formati del titolo (facoltativo): formati separati per argomenti di blog e YouTube utilizzando %{title} e %{source}, ad esempio %{source} blog: %{title}. Le rinomine sono silenziose - nessuna revisione, bump o notifica - e i vecchi link continuano a funzionare.
6. Nomi di visualizzazione: una pagina di amministrazione elenca ogni feed di RSS Polling con il suo nome pubblicato, dove è possibile impostare il nome utilizzato per %{source}. Il salvataggio ri-renderizza i titoli di quel feed.
7. Protezione dagli aggiornamenti del feed: un post sorgente modificato o un formato del feed cambiato non sovrascrive più un argomento oneboxato.
8. Task Rake per gli argomenti esistenti: rss_onebox:convert trasforma le importazioni precedenti in onebox, e rss_onebox:enhance integra riassunti, descrizioni e titoli. Entrambi predefiniti su dry run.

Motivazione

Gestiamo un forum che porta i blog e i canali YouTube dei membri in un’unica categoria. Gli estratti di RSS Polling rendevano molti feed in modo scadente - formattazione rotta, immagini mancanti, un pulsante “Mostra post completo” che ri-scrapava la pagina - mentre lo stesso URL incollato in un post produceva una onebox pulita. Questo plugin fa sì che ogni importazione assomigli a quel link incollato, e completa ciò che le pagine da sole non potevano fornire.

Configurazione

Dopo l’installazione, vai su Amministrazione → Plugin → RSS Polling Onebox:

1. Impostazioni: abilita il plugin, seleziona le categorie le cui importazioni devono essere oneboxate e attiva le funzionalità facoltative.
2. Nomi di visualizzazione: imposta il nome utilizzato per %{source} nei titoli, per feed, o lascialo vuoto per usare il nome pubblicato dal feed. Aggiorna nomi pubblicati legge ogni feed abilitato.

Per gli argomenti importati prima dell’installazione, esegui rake rss_onebox:convert e poi rake rss_onebox:enhance all’interno del container (entrambi dry run; aggiungi APPLY=1 per scrivere). Il README documenta ogni impostazione e task, e il CHANGELOG elenca ogni rilascio.

Avvertenze

1. Testato su Discourse 2026.7 ESR; la compatibilità con main al settembre 2026 è verificata nel codice. Le versioni più vecchie non sono state testate.
2. Richiede RSS Polling, che è incluso con Discourse.
3. Alcune funzionalità avvolgono gli interni di RSS Polling e TopicEmbed perché gli hook documentati non esistono ancora; vedi RSS Polling: punti di estensione per i plugin.
4. La lettura nativa delle descrizioni di YouTube in RSS Polling è in discussione in RSS Polling: leggi la descrizione del video dai feed dei canali YouTube; se verrà implementato nel core, questo plugin lo utilizzerà.
5. La qualità della onebox dipende dai tag Open Graph di ogni pagina dell’articolo.

Domande e problemi: rispondi qui, o apri un issue su GitHub.