Prossima EOL per il sistema di rendering dei widget

Sviluppatore
1

Ciao a tutti! Come ultimo passo del nostro sforzo per abbandonare il vecchio sistema di rendering “widget”, stiamo deprecando l’uso dei widget in Discourse e presto lo disattiveremo completamente.

Tempistiche

Queste sono stime e soggette a modifiche

Luglio 2025:

  • :white_check_mark: Aggiungere avvisi di deprecazione nel core e un’impostazione sperimentale del sito per disattivarli
  • :white_check_mark: Pubblicare un annuncio su Meta

Agosto 2025

  • :white_check_mark: Aggiornare i plugin e i componenti tema ufficiali per utilizzare i Glimmer Components.
  • :white_check_mark: Eseguire Meta con i widget disattivati.
  • :white_check_mark: Abilitare i messaggi di deprecazione con un banner di avviso per gli amministratori.

Q3 2025:

  • I plugin e i temi di terze parti devono essere aggiornati.

Q4 2025:

  • :white_check_mark: Il sistema di rendering dei widget sarà disabilitato per impostazione predefinita utilizzando deactivate_widgets_rendering: true. Ci sarà un breve periodo di tempo in cui potrà essere riattivato manualmente.

  • 17 novembre: Rimuovere il codice legacy e disattivare il sistema di rendering dei widget.

:police_car_light: I plugin e i temi non compatibili smetteranno di funzionare correttamente dopo questa data.

Cosa significa questo per te?

Se uno qualsiasi dei tuoi plugin o temi utilizza le API dei “widget”, dovrai aggiornarli per utilizzare le API più recenti o i Glimmer Components prima della scadenza del Q4 2025.

Ho installato plugin o temi personalizzati. Devo aggiornarli?

Dovrai aggiornare i tuoi plugin o temi se utilizzano uno dei seguenti elementi:

  • createWidget
  • decorateWidget, changeWidgetSetting, reopenWidget o attachWidgetAction
  • Il componente MountWidget

:bulb: Suggerimento Pro: Se hai estensioni che utilizzano queste personalizzazioni, vedrai un avviso nella console che identifica quale plugin o componente necessita di un aggiornamento.

:warning: Importante: Se utilizzi più di un tema nella tua istanza, assicurati di controllarli tutti poiché gli avvisi appariranno solo per i plugin attivi e i temi e componenti tema attualmente in uso.

L’ID di deprecazione è: discourse.widgets-end-of-life

Come si collega questo alla recente modernizzazione del post-stream?

Il post-stream è stata l’ultima parte importante di Discourse a utilizzare ancora il sistema di rendering dei widget. Con la sua modernizzazione, possiamo ora procedere al completo ritiro del sistema dei widget. Dai un’occhiata alla guida all’aggiornamento per maggiori dettagli su queste modifiche.

Come aggiorno?

Se utilizzi un plugin o un tema di terze parti: Verifica se l’autore ha rilasciato una versione aggiornata compatibile con il nuovo sistema.

Se sei un autore di plugin/temi:

  • Sostituisci i tuoi widget personalizzati con i Glimmer Components
  • Utilizza i connettori plugin-outlet per inserirli nell’interfaccia utente

Consulta le nostre Guide per sviluppatori per maggiori informazioni su come apportare queste modifiche.

7 Mi Piace
4

Al prossimo aggiornamento della tua installazione di Discourse, il sistema di rendering dei widget sarà disabilitato e qualsiasi personalizzazione basata sui widget non verrà più visualizzata.

Per ora, sui siti non compatibili, l’amministratore può riattivare il vecchio comportamento modificando i valori della seguente impostazione:

  • deactivate_widgets_rendering

Questa è la fase finale prima della rimozione del vecchio codice dalla codebase di Discourse, prevista tra circa un mese. Successivamente, non sarà più possibile riattivare i widget.

5 Mi Piace