Sezione messaggi per la barra laterale

[Moin]

	Riepilogo	Aggiunge al sidebar collegi alle caselle di messaggi personali e di gruppo, inclusi gli indicatori di messaggi non letti
	Anteprima	Theme Creator
	Repository	GitHub - moin-Jana/sidebar-messages-section: Adds personal and group message inbox links to the sidebar, including unread message indicators. · GitHub
	Guida all’installazione	Come installare un tema o un componente del tema
	Nuovo ai temi di Discourse?	Guida per principianti all’uso dei temi di Discourse

Installa questo componente del tema

Il componente aggiunge una sezione Messaggi al sidebar con collegi alle caselle di messaggi personali: sia la casella personale dell’utente che quelle di gruppo a cui ha accesso. La sezione include anche un pulsante per scrivere un nuovo messaggio personale accanto al titolo della sezione.

Casella personale

Per impostazione predefinita, il componente aggiunge un collegamento alla casella personale per tutti gli utenti. Con l’impostazione show_personal_inbox, gli amministratori possono anche nasconderla completamente o mostrarla solo per gli utenti autorizzati a creare messaggi privati, in base all’impostazione del sito “Gruppi abilitati per i messaggi personali”. Questo riflette il modo in cui appare il collegamento alla casella personale nel menu delle notifiche, nel profilo dell’utente e nella sezione Comunità del sidebar.

Per evitare collegamenti duplicati alla casella personale, potresti voler rimuovere il collegamento ai messaggi nella prima sezione del sidebar. Puoi farlo aprendo il menu Altro e selezionando Personalizza questa sezione, quindi rimuovendo il collegamento ai messaggi dalla sezione.

Caselle di gruppo

Tutte le caselle di gruppo che contengono almeno un messaggio e di cui l’utente è membro appariranno automaticamente nel suo sidebar. Gli amministratori possono nascondere caselle di gruppo specifiche utilizzando l’impostazione hide_group_inboxes, il che può essere utile quando una casella di gruppo non è più attivamente utilizzata.

Un’impostazione separata, use_group_page_inbox, ti permette di scegliere se i collegamenti alle caselle di gruppo si aprono nell’interfaccia dei messaggi dell’utente (/my/messages/group/{group_name}) o nella pagina del gruppo (/g/{group_name}/messages/inbox).

Indicatore di non letto

Ogni collegamento alla casella mostra lo stato attuale dei messaggi in base alla preferenza dell’utente per “Mostra un conteggio dei nuovi elementi”: un punto o il conteggio numerico. I valori superiori a 100 vengono visualizzati come 99+.

Configurazione avanzata delle caselle di gruppo

Per personalizzare l’ordine delle caselle di gruppo o modificare il nome visualizzato nel sidebar, puoi utilizzare l’impostazione advanced_group_inbox_configuration.

In questa impostazione puoi:

• selezionare un gruppo da un menu a discesa
• opzionalmente definire un nome personalizzato che verrà mostrato nel sidebar
• riordinare i gruppi configurati utilizzando i pulsanti in basso

Il nome personalizzato è utile anche all’interno dell’impostazione stessa.
Se non viene fornito un nome, la voce verrà etichettata come gruppo 1, gruppo 2, ecc. (in base alla sua posizione). Aggiungere un nome temporaneo può rendere più facile il riordinamento, e puoi rimuoverlo di nuovo prima di salvare se lo desideri.

I gruppi con messaggi che non sono stati aggiunti alla configurazione avanzata appariranno comunque nel sidebar, elencati dopo quelli configurati e ordinati per ID del gruppo.

I gruppi elencati nell’impostazione hide_group_inboxes saranno sempre nascosti, indipendentemente dal fatto che siano presenti anche nella configurazione avanzata o abbiano messaggi. Un avviso riservato solo agli amministratori aiuta a evidenziare quando un gruppo viene aggiunto a entrambe le impostazioni.

Puoi vedere un esempio di configurazione e come influisce sull’ordine e sui nomi visualizzati negli screenshot seguenti:

Posizione della sezione messaggi

Per cambiare la posizione della sezione messaggi, puoi utilizzare il CSS, ad esempio:

@nathank

/* Assicurati che la sezione Messaggi appaia per prima nel contenitore flexbox */
.sidebar-section-wrapper {
  order: 1;
}
.sidebar-section-wrapper[data-section-name="inbox-section"] {
  order: 0;
}

In alternativa, puoi installare il componente Discourse Sidebar Menu Reorder e utilizzare inbox-section come nome della sezione quando ne modifichi la posizione. Puoi anche utilizzare l’impostazione di ordine del componente Controllo visualizzazione menu di navigazione (sidebar).

[Lilly]

wow, ben fatto Moin!

[NateDhaliwal]

Suggerimento minore: forse javascripts/discourse/api-initializers/group-inboxes-in-sidebar.gjs dovrebbe essere un file JS invece che GJS?

Ottimo componente!

---

Ho passato gli ultimi 10 minuti a esaminare il codice e le classi principali e devo dire quanto sia notevole che Discourse sia stato (ed è) realizzato in modo che tutto si integri così bene.

[Moin]

Sì, l’API offre quasi tutto il necessario per far sì che la sezione abbia lo stesso aspetto e funzionamento di tutte le altre. Anche la chat la utilizza, il che probabilmente ha influenzato lo sviluppo. Le funzionalità sono state sviluppate contemporaneamente.
Purtroppo, get badgeText(), che visualizza il numero di argomenti non letti nelle sezioni principali, non è supportato, quindi ho dovuto usare un po’ di creatività con i numeri.

[putty (Derek Putnam)]

@Moin

Per evitare collegamenti duplicati alla casella di posta personale, potresti voler rimuovere il collegamento ai messaggi nella prima sezione della barra laterale.

Non sono riuscito a trovare un’impostazione di amministrazione per questo, quindi avviso che questo lo nasconderà tramite CSS:

.sidebar-section-link[data-link-name="my-messages"] {
    display: none;
}

[Moin]

Perché preferisci nascondere il link con il CSS invece di utilizzare l’opzione esistente per gli amministratori per personalizzare la barra laterale? Nascondere con il CSS sembra più propenso a rompersi rispetto all’utilizzo delle opzioni integrate di Discourse.

@Moin

Per personalizzare questa sezione:

1. Fai clic su Altro nella barra laterale
2. Seleziona Personalizza questa sezione in fondo al menu esteso

[putty (Derek Putnam)]

Derp, hai ragione. Stavo pensando troppo, pensando che fosse un’impostazione nella console di amministrazione e/o una funzionalità principale.

[Heliosurge (Dan DeMontmorency)]

Non sei l’unico che stava guardando lì.

---

Questo è un componente fantastico!

[Moin]

Ho ampliato la nota:

@Moin

Per evitare link duplicati alla casella di posta personale, potresti voler rimuovere il link Messaggi nella prima sezione della barra laterale. Puoi farlo aprendo il menu Altro e selezionando Personalizza questa sezione, quindi rimuovendo il link Messaggi dalla sezione.

[Heliosurge (Dan DeMontmorency)]

Sì, l’hai fatto. Ma come amministratori siamo spesso abituati a passare attraverso il pannello di amministrazione. . Quindi, quando scorriamo le istruzioni, potremmo trascurare alcuni dettagli.

Anche con gli aggiornamenti principali, sono sicuro che molti di noi non leggono sempre tutti i minimi dettagli finché qualcosa che usiamo non è stato spostato in un’altra area.

Tanto tempo fa, con Android, se ben ricordo, Gingerbread aveva Navigazione e Mappe. Ho passato circa 10 minuti a cercare Navigazione dopo che l’hanno unita a Mappe in un aggiornamento.

[nathank (Nathan Kershaw)]

Questo è un Componente Tema brillante che si adatta ai siti che fanno molto affidamento sui Messaggi! Grazie @moin per il tuo eccellente lavoro!

Per renderlo ancora migliore per coloro che utilizzano molto i Gruppi (i Messaggi sono una componente importante di questo), potresti considerare questi suggerimenti?

Posizione selezionabile sulla barra laterale

Per enfatizzare maggiormente i Messaggi nell’interfaccia utente, vorrei che fossero in cima alla Barra laterale (cioè subito sotto i link). In sostanza, voglio che le persone possano vedere facilmente i loro Messaggi recenti (per gruppo) a colpo d’occhio senza fare affidamento sulle notifiche.

Ho usato questo CSS per ottenerlo, ma sospetto di non essere l’unico per cui questo sarebbe utile:

/* Assicura che la sezione Messaggi appaia per prima nel contenitore flexbox */
.sidebar-section-wrapper {
  order: 1;
}
.sidebar-section-wrapper[data-section-name="inbox-section"] {
  order: 0;
}

Aprire le caselle di posta dei gruppi nel contesto del gruppo

Voglio che i miei utenti possano trovare e interagire facilmente con i loro Gruppi. Ha senso per me che lavorino con i Messaggi nella Posta in arrivo a cui si accede dalla pagina del Gruppo (cioè /g/the-group/messages/inbox) invece che dalla loro pagina Posta in arrivo personale (cioè /my/messages/group/the-group)

Questo fornisce loro una bella pagina pulita incentrata sul gruppo, con facile accesso agli altri membri del gruppo e alle impostazioni:

Sarebbe fantastico se questo fosse governato da un’impostazione nel TC.

[Moin]

@nathank

Sarebbe fantastico se fosse governato da un’impostazione nel TC.

Ci ho pensato, a quale percorso sia un’impostazione migliore e quale sia la predefinita, ma l’ho rimossa per qualche motivo che non ricordo al momento. Darò un’occhiata domani più tardi. Penso che riguardasse l’indicatore dei messaggi non letti. Preferiresti comunque questa strada se la conseguenza fosse che non ci sarebbe alcun indicatore per i messaggi non letti?

Penso che la posizione attuale sia la stessa della sezione messaggi che era nel core.
Esiste già un ottimo componente per cambiare l’ordine delle sezioni nella barra laterale: Navigation (sidebar) menu display control
Per evitare conflitti poiché entrambi i componenti tentano di sovrascrivere l’ordine, potrebbe avere senso che gli amministratori che desiderano un ordine diverso utilizzino il componente esistente (l’autore ha confermato che funziona usando “inbox-section” come nome della sezione).
Dovrò vedere se posso offrire un’impostazione aggiuntiva per questo. In ogni caso, voglio evitare che i componenti interferiscano tra loro.

[nathank (Nathan Kershaw)]

@Moin

Ci ho pensato, su quale percorso sia un’impostazione predefinita migliore e quale una configurazione, ma l’ho rimosso per qualche motivo che non ricordo al momento. Darò un’occhiata domani più tardi. Penso che riguardasse l’indicatore dei messaggi non letti. Preferiresti comunque questo percorso se la conseguenza fosse che non ci fosse alcun indicatore per i messaggi non letti?

Ho giocherellato con questo nel mio fork e ho riscontrato la stessa cosa. Funziona, ma perde sia l’indicatore dei messaggi non letti sia l’evidenziazione del link nella barra laterale. Entrambe queste cose hanno davvero un grande valore!

Ho fatto una PR per quello che sono riuscito a fare:

Add group page inbox as an option

Ma per funzionare davvero bene, ha davvero bisogno che l’indicatore dei messaggi non letti e l’evidenziazione del link funzionino, eh?

@Moin

Esiste già un ottimo componente per modificare l’ordine delle sezioni nella barra laterale: Controllo visualizzazione menu (barra laterale) di navigazione

Punto ben sollevato! Questa è un’idea molto migliore. Con mia vergogna, sono in realtà uno degli autori di quel TC!

[Moin]

Perché hai usato href invece di route? Penso che href non funzionasse affatto con gli indicatori di non letto. Ero più preoccupato che i numeri sulla rotta group.messages.inbox non fossero disponibili nel modo in cui puoi usarli su userPrivateMessages.

[nathank (Nathan Kershaw)]

Perché sono uno sviluppatore incompetente e ho provato un sacco di cose finché qualcosa non ha funzionato! Probabilmente anche a causa della mia insana dipendenza da AI generativa non proprio intelligente .

Ho provato a utilizzare le rotte, ma non sono riuscito a sovrascrivere quelle esistenti. Quindi mi sono arreso.

Mi sono chiesto se fosse possibile ottenere quei numeri/comportamenti semplicemente dirottando il link per indirizzarlo a una posizione diversa. Ma è un po’ troppo complesso per me, un vecchio semplice.

Sentitevi liberi di ‘migliorarlo’!

(A proposito, il meraviglioso @moin ha fatto esattamente questo, aggiungendo la funzionalità e facendola funzionare correttamente!)

[nathank (Nathan Kershaw)]

@Moin

Penso che la posizione attuale sia la stessa della sezione messaggi che era nel core.
Esiste già un ottimo componente per cambiare l’ordine delle sezioni nella barra laterale: Navigation (sidebar) menu display control
Per evitare conflitti poiché entrambi i componenti tentano di sovrascrivere l’ordine, potrebbe avere senso che gli amministratori che desiderano un ordine diverso utilizzino il componente esistente (l’autore ha confermato che funziona usando “inbox-section” come nome della sezione).

Questo funziona davvero molto bene. In modo un po’ imbarazzante, sono uno degli autori (molto secondario rispetto a @lilly) di quel TC !

Sarebbe fantastico averlo nell’OP.

[Moin]

@nathank ha chiesto un’opzione per cambiare l’ordine delle caselle di posta dei gruppi nella barra laterale. In precedenza avevo chiesto idee su come affrontare al meglio questo problema in Configuring the order of groups in theme component settings, e penso di aver trovato una soluzione.
Ho combinato questo con la richiesta di visualizzare il nome completo di un gruppo anziché il suo nome breve. Poiché il nome completo non è facilmente disponibile in questo contesto, la soluzione è consentire agli amministratori di definire invece un nome visualizzato personalizzato. Il campo che in precedenza sarebbe stato utilizzato solo per visualizzare il nome del gruppo nelle impostazioni è ora utilizzato anche per controllare il nome mostrato nella barra laterale.

Entrambe le funzionalità sono gestite tramite la nuova impostazione advanced_group_inbox_configuration.

In questa impostazione è possibile:

• selezionare un gruppo da un menu a discesa
• definire facoltativamente un nome personalizzato che verrà mostrato nella barra laterale
• riordinare i gruppi configurati utilizzando i pulsanti in basso

Il nome personalizzato è utile anche all’interno dell’impostazione stessa.
Se non viene fornito alcun nome, la voce verrà etichettata come gruppo 1, gruppo 2, ecc. (in base alla sua posizione). Aggiungere un nome temporaneo può facilitare il riordino, ed è possibile rimuoverlo prima di salvare, se lo si desidera.

I gruppi con messaggi che non sono aggiunti alla configurazione avanzata appariranno comunque nella barra laterale, elencati dopo quelli configurati e ordinati in base al loro ID di gruppo.
I gruppi elencati nell’impostazione hide_group_inboxes saranno sempre nascosti, indipendentemente dal fatto che siano presenti anche nella configurazione avanzata o abbiano messaggi.

In questo esempio, non è stato inserito alcun nome personalizzato per il gruppo moderatori, motivo per cui appare come gruppo 1 nella configurazione. Gli altri gruppi hanno nomi personalizzati.

Questa configurazione si traduce in:

Qui è possibile vedere che le caselle di posta ‘doggo-daily’ e ‘cat_pics’ hanno scambiato posizione e vengono visualizzate senza trattini o underscore. La casella di posta ‘Team’ appare sotto quelle configurate nell’impostazione avanzata.
È inoltre possibile vedere un avviso visibile solo agli amministratori, che appare perché il gruppo ‘admin’ è stato aggiunto alla configurazione avanzata e contemporaneamente all’impostazione hide_group_inboxes.

[nathank (Nathan Kershaw)]

Questo è semplicemente brillante per coloro che utilizzano i gruppi per le comunicazioni. Ottimo lavoro, @Moin!

Grazie per aver ascoltato e interagito attivamente con i feedback degli altri (e miei) - e per aver prodotto un componente tema così ben progettato e pragmatico che risolve un problema di lunga data in modo così elegante.

[agit (Bren Typo)]

Ciao @Moin, ottimo lavoro e grazie mille.

Stavo chiedendo se una funzionalità, specialmente quando si lavora con molti gruppi, possa far parte di questo plugin. La vista combinata di tutti i messaggi di gruppo. Nella vista PN c’è già un modo per visualizzare con un piccolo badge che questo messaggio va anche nel gruppo, perché non mostrare tutti i messaggi con badge a quale gruppo appartengono:

[Moin]

@agit

Stavo chiedendo se una funzionalità, specialmente quando si lavora con molti gruppi, possa far parte di questo plugin.

Non credo che questo si adatti bene a questo componente tema. L’obiettivo di questo componente è molto ristretto: aggiunge una sezione messaggi alla barra laterale. Non sono favorevole a un componente che supporti funzionalità completamente diverse, poiché ciò rende più difficile da capire e mantenere. Questo tipo di funzionalità sarebbe meglio gestito come una personalizzazione separata.

Ancora più importante, questo non è qualcosa per cui un componente tema è ben adatto. I componenti tema possono funzionare solo con dati già presenti sul frontend, o che possono essere ragionevolmente recuperati dagli endpoint backend esistenti. Ecco perché questo componente può mostrare le caselle di posta dei gruppi nella barra laterale: molte parti di Discourse hanno già bisogno di sapere a quali gruppi appartiene un utente, quindi tale informazione è prontamente disponibile.

Ciò che stai descrivendo, tuttavia, richiederebbe l’accesso ai dati dei messaggi attraverso tutte le caselle di posta dei gruppi. Attualmente, Discourse non espone questo in un unico posto. Un componente tema potrebbe teoricamente recuperare ogni casella di posta di gruppo una alla volta, ma ciò diventa rapidamente inefficiente. Ogni richiesta restituisce solo i primi 30 messaggi, quindi dovresti caricare più pagine per casella di posta. Per poi ordinare i messaggi per attività, avresti effettivamente bisogno di tutti i messaggi da tutte le caselle di posta contemporaneamente.

A causa di queste limitazioni, un componente tema sarebbe una scelta sbagliata qui. Un plugin che aggiunge un endpoint backend appropriato per restituire questi dati sarebbe un approccio molto più sensato e scalabile.