Organizzatore di categorie della barra laterale

[Drew-ART (Drew)]

Ho creato un organizzatore per la barra laterale. C’è stata molta discussione al riguardo tempo fa e altri hanno ritenuto che non fosse necessario, ma ho sempre pensato che i miei utenti non fossero molto esperti di tecnologia o non conoscessero bene il funzionamento del forum all’inizio, quindi ho creato questo organizzatore a discesa per aiutarli.

Installa questo componente tema

C’è un piccolo interruttore in alto in modo che gli utenti possano passare tra l’impostazione predefinita e questa, e scegliere quella che preferiscono. L’ho messo lì perché penso che molti utenti esperti vogliano personalizzare la loro barra laterale di navigazione, ma la maggior parte degli utenti meno esperti no.

Organizzatore Categorie Barra Laterale

Un componente tema di Discourse che organizza le categorie della barra laterale in sezioni personalizzabili, codificate a colori e comprimibili con funzionalità avanzate.

Funzionalità

• 10 Sezioni Comprimibili: Raggruppa le categorie in un massimo di 10 sezioni personalizzate
• Personalizzazione Colori: Imposta i colori di sfondo e del testo per l’intestazione di ogni sezione
• Sfondi a Gradiente: Effetto di dissolvenza a gradiente opzionale come nelle foto
• Badge Categoria: I badge colorati predefiniti di Discourse accanto alle categorie possono essere attivati e disattivati
• Supporto Sottocategorie: Attivazione/disattivazione per sezione per mostrare/nascondere le sottocategorie (visualizzazione rientrata)
• Nascondi Categorie: Nasconde categorie specifiche da tutte le visualizzazioni
• Interruttore Bidirezionale: Passa tra le sezioni personalizzate e la visualizzazione predefinita di Discourse (il pulsante di attivazione/disattivazione appare in entrambe le visualizzazioni)
• Stato Persistente: Ricorda quali sezioni sono aperte/chiuse e la preferenza di visualizzazione dell’utente
• Consapevole dei Permessi: Mostra solo le categorie a cui gli utenti hanno accesso
• Categorie Non Raggruppate: Visualizza automaticamente le categorie non categorizzate in una sezione separata
• Adattabile al Mobile: Funziona su tutte le dimensioni dei dispositivi

Installazione

1. Vai su Admin → Personalizza → Temi nella tua istanza di Discourse
2. Clicca su Installa → Da un repository Git
3. Inserisci: https://github.com/focallocal/sidebar-categories-organizer
4. Clicca su Installa
5. Aggiungi il componente al tuo tema attivo

Configurazione

Impostazioni Globali

• Abilita Organizzatore Barra Laterale: Attiva/disattiva la visualizzazione personalizzata
• Mostra Pulsante Interruttore: Visualizza l’icona per passare tra le visualizzazioni (appare nelle intestazioni sia della visualizzazione personalizzata che di quella predefinita)
• Mostra Badge Categoria: Visualizza quadrati colorati accanto ai nomi delle categorie
• Usa Dissolvenza Gradiente: Abilita l’effetto di sfondo a gradiente sulle intestazioni delle sezioni (50% colore solido, 50% dissolvenza a trasparente)
• Categorie da Nascondere: Elenco separato da virgole di slug di categorie da nascondere da tutte le visualizzazioni (es. staff,private)
• Visualizzazione Predefinita: Scegli quale visualizzazione caricare per impostazione predefinita (personalizzata o predefinita)

Impostazioni Sezione (1-10)

Ogni sezione ha:

• Abilitato: Attiva/disattiva la sezione
• Titolo: Testo dell’intestazione della sezione
• Colore Sfondo: Selettore colore per lo sfondo dell’intestazione della sezione
• Colore Testo: Selettore colore per il testo dell’intestazione
• Categorie: Elenco separato da virgole di slug di categorie (es. general,support,feedback)
• Mostra Sottocategorie: Attiva/disattiva la visualizzazione/nascondimento delle sottocategorie per questa sezione
• Aperto per Impostazione Predefinita: Se la sezione inizia espansa o compressa

Trovare gli Slug delle Categorie

Gli slug delle categorie sono nell’URL:

• tuosito.com/c/general/5 → lo slug è general
• tuosito.com/c/feature-requests/12 → lo slug è feature-requests

Utilizzo

Una volta installato e configurato:

1. Visualizzazione Personalizzata: Le categorie sono raggruppate nelle sezioni configurate con intestazioni colorate
2. Espandi/Comprimi: Clicca sulle intestazioni delle sezioni per attivare/disattivare la visibilità del contenuto
3. Interruttore Visualizzazioni: Clicca sull’icona nell’intestazione per passare tra le visualizzazioni personalizzata e predefinita
   • Nella visualizzazione personalizzata: il pulsante di attivazione/disattivazione appare nell’intestazione della visualizzazione personalizzata
   • Nella visualizzazione predefinita: il pulsante di attivazione/disattivazione appare nell’intestazione “Categorie” predefinita
4. Sottocategorie: Quando abilitate per sezione, le sottocategorie appaiono rientrate sotto le categorie principali
5. Badge Categoria: Piccoli quadrati colorati (se abilitati) mostrano il colore di ogni categoria
6. Categorie Non Raggruppate: Qualsiasi categoria non assegnata alle sezioni appare in “Altre Categorie”
7. Preferenze: La tua scelta di visualizzazione e lo stato aperto/chiuso vengono salvati per browser

Funzionalità Avanzate

Sfondi a Gradiente

Quando abilitati, gli header delle sezioni utilizzano un gradiente uniforme:

• 50% colore solido (il colore di sfondo scelto)
• 50% dissolvenza a trasparente
• Crea un aspetto moderno ed elegante

Nascondi Categorie

Specifica gli slug delle categorie da nascondere completamente dalla barra laterale:

• Utile per categorie solo per lo staff o obsolete
• Si applica sia alle visualizzazioni personalizzate che a quelle predefinite
• Elenco separato da virgole (es. staff,private,archived)

Sottocategorie

• Attivazione/disattivazione per sezione (non globale)
• Visualizzazione rientrata con carattere leggermente più piccolo
• Opacità ridotta per la gerarchia visiva
• Mantiene i colori dei badge delle categorie

Versione

• Corrente: 1.0.1
• Discourse Minimo: 3.3.0
• Autore: Andy@Focallocal

Licenza

Licenza MIT - Vedi file LICENSE

Supporto

Segnala problemi: GitHub · Where software is built

[Lilly]

Bel lavoro

Suggerimento per le impostazioni delle categorie

Invece di far inserire agli amministratori gli slug delle categorie, puoi usare questo nel tuo file settings.yml, ad esempio:

categories_to_hide:
  type: list
  list_type: category
  default: ""
  description:
    en: "Categories to hide from sidebar completely."

il che ti darà un’impostazione simile a questa:

Puoi fare la stessa cosa anche con i gruppi se mai volessi un menu a discesa per i gruppi:

groups_this_setting_applies_to:
  type: list
  list_type: group
  default: ""
  description:
    en: "Groups this setting will apply to."

il che darà qualcosa di simile a questo:

[jenmck (jen)]

Mi piace molto e questo mi è sicuramente passato per la testa, quindi grazie!

Domanda: se un utente non ha accesso a nessuna categoria in una data sezione, la sezione stessa appare comunque all’utente?

[NateDhaliwal]

Sì, lo fa:

javascripts%2Fdiscourse%2Fapi-initializers%2Fsidebar-organizer.js

[Drew-ART (Drew)]

No, la categoria/sottocategoria è nascosta se non vi si ha accesso. È anche possibile nasconderne manualmente una qualsiasi tramite le impostazioni.

[Drew-ART (Drew)]

Grazie Lilly. Aggiornerò quello e i miei altri componenti recenti per migliorarli.

[Drew-ART (Drew)]

Il plugin è aggiornato con dei graziosi selettori a discesa ora.

[jenmck (jen)]

Giusto, ho capito quella parte, ma intendo la sezione vera e propria, non solo la categoria.

Ad esempio, se ho questa configurazione:

Animali

• Gatti
• Cani

Nuvole

• Nimbus
• Cumulo

Giorni

• Sabato
• Domenica

Supponiamo che un utente non abbia accesso né alla categoria Nimbus né a quella Cumulo. La sezione Nuvole apparirebbe comunque all’utente ma senza categorie, così:

Animali

• Gatti
• Cani

Nuvole

Giorni

• Sabato
• Domenica

Oppure la sezione Nuvole non apparirebbe affatto, così:

Animali

• Gatti
• Cani

Giorni

• Sabato
• Domenica

[Drew-ART (Drew)]

se un utente non ha il permesso di vedere alcuna categoria in una sezione, l’intera sezione (scheda) verrà nascosta

[Heliosurge (Dan DeMontmorency)]

Questo è piuttosto interessante!

Mi fa ripensare alle idee lol.

Stavo giocherellando con l’idea di usare il plugin Doc Categories per disporre sezioni personalizzate con menu mirati. Ma ho bisogno di un abbellimento per consentire colori e icone.

C’è un markdown per aggiungere il “Componente di installazione” a Op.

È cambiato qualcosa in Meta? Non riesco a evidenziare qualcosa per citare su Android qui. - ok sembra risolto.

[Heliosurge (Dan DeMontmorency)]

Ehi Lily, potremmo avere il Markdown per “Install Component”?

[NateDhaliwal]

Ecco uno per questo componente:

Installa questo componente tema

Formato Markdown (sostituisci repoName e repoUrl):

[wrap=theme-install-button repoName="Nome del componente" repoUrl="Link al repository GitHub"]
Installa questo componente tema
[/wrap]

[Heliosurge (Dan DeMontmorency)]

Grazie Nate. Ho provato a fare una ricerca ma forse con termini troppo generici.

[NateDhaliwal]

Oh, non sono sicuro che sia menzionato da qualche parte. L’ho tolto dal template dell’argomento Theme component .

[Heliosurge (Dan DeMontmorency)]

Questo è sicuramente interessante. Meta potrebbe voler considerare l’altro TC di zOp poiché può pre-inserire un modello alla creazione dell’argomento.