Prossima EOL per il sistema di rendering dei widget

Sviluppatore
1

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

Tempistiche

Queste sono stime e soggette a modifiche

Luglio 2025:

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

Agosto 2025

  • :white_check_mark: Aggiornare i plugin ufficiali e i componenti tema 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.

Terzo Trimestre 2025:

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

Quarto Trimestre 2025:

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

  • :white_check_mark: 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 questo.

Cosa significa questo per te?

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

Ho installato plugin o temi personalizzati. Devo aggiornarli?

Dovrai aggiornare i tuoi plugin o temi se utilizzano una delle seguenti opzioni:

  • 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 deve essere aggiornato.

: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 i componenti tema attualmente in uso.

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

In che modo questo si collega alla recente modernizzazione del post-stream?

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

Come posso aggiornare?

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/tema:

  • 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.

8 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.

6 Mi Piace
5

La PR che rimuove il sistema di widget da Discourse è stata unita ieri.

3 Mi Piace