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.

C’è un piccolo interruttore in alto in modo che gli utenti possano passare da una modalità all’altra e scegliere quella che preferiscono.

Organizzatore Categorie Barra Laterale

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

Funzionalità

• 10 Sezioni a Scomparsa: Raggruppa le categorie in un massimo di 10 sezioni personalizzate
• Personalizzazione Colori: Imposta i colori di sfondo e del testo per l’intestazione di ciascuna sezione
• Sfondi a Gradiente: Effetto di sfumatura a gradiente opzionale come nelle foto
• Badge Categoria: I badge colorati predefiniti di Discourse accanto alle categorie possono essere attivati o 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 → Customize → Themes nella tua istanza di Discourse
2. Clicca su Install → From a Git repository
3. Inserisci: https://github.com/focallocal/sidebar-categories-organizer
4. Clicca su Install
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 da una visualizzazione all’altra (appare nelle intestazioni di entrambe le visualizzazioni, personalizzata e predefinita)
• Mostra Badge Categoria: Visualizza quadrati colorati accanto ai nomi delle categorie
• Usa Sfumatura Gradiente: Abilita l’effetto di sfondo a gradiente sulle intestazioni delle sezioni (50% colore solido, 50% sfumatura trasparente)
• Categorie da Nascondere: Slug di categorie separati da virgole 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 di colore per lo sfondo dell’intestazione della sezione
• Colore Testo: Selettore di colore per il testo dell’intestazione
• Categorie: Slug di categorie separati da virgole (es. general,support,feedback)
• Mostra Sottocategorie: Attiva/disattiva la visualizzazione delle sottocategorie per questa sezione
• Aperta per Impostazione Predefinita: Se la sezione inizia espansa o compressa

Trovare gli Slug delle Categorie

Gli slug delle categorie sono nell’URL:

• yoursite.com/c/general/5 → lo slug è general
• yoursite.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 la visualizzazione personalizzata e quella predefinita
   • In visualizzazione personalizzata: il pulsante di attivazione/disattivazione appare nell’intestazione della visualizzazione personalizzata
   • In visualizzazione predefinita: il pulsante di attivazione/disattivazione appare nell’intestazione predefinita “Categories”
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 “Other Categories”
7. Preferenze: La tua scelta di visualizzazione e lo stato aperto/chiuso vengono salvati per browser

Funzionalità Avanzate

Sfondi a Gradiente

Quando abilitate, le intestazioni delle sezioni utilizzano un gradiente uniforme:

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

Nascondi Categorie

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

• Utile per categorie riservate allo staff o obsolete
• Si applica a entrambe le visualizzazioni, personalizzata e predefinita
• 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

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

Licenza

Licenza MIT - Vedi il file LICENSE

Supporto

Segnala problemi: GitHub · Where software is built

[Lilly (Lillian Louis)]

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: