Menu laterali delle categorie di Discourse

:information_source: Riepilogo Crea menu laterali personalizzati con accesso limitato a gruppi selezionati
:eyeglasses: Anteprima Unisciti a questo gruppo di Theme Creator e poi visualizza l’anteprima qui
:hammer_and_wrench: Repository \u003chttps://github.com/Lillinator/discourse-group-sidebar-menus\u003e
:question: Guida all’installazione Come installare un tema o un componente tema
:open_book: Nuovo ai temi di Discourse? Guida per principianti all’utilizzo dei temi di Discourse

Installa questo componente tema

:woman_technologist:t2: Panoramica

Questo componente tema di Discourse offre agli amministratori del forum la possibilità di creare menu laterali personalizzati accessibili solo ai membri di gruppi selezionati.

Caratteristiche principali:

  • Controllo degli accessi basato sui gruppi - Le sezioni del menu vengono visualizzate solo per gli utenti autorizzati
  • Configurazione tramite interfaccia amministrativa - Tutte le impostazioni per la creazione di sezioni di menu di gruppo si trovano nell’interfaccia amministrativa del componente tema
  • Sezioni multiple - Crea un numero illimitato di sezioni di menu per gruppi diversi (ragionevolmente)
  • Sicurezza lato client - Gli utenti non autorizzati non possono vedere le sezioni del menu nel DOM, nell’ispettore web o in modalità sicura
  • Nessun inquinamento globale - Non richiede la creazione di sezioni della barra laterale globali
  • Collegamento rapido di modifica per amministratori - L’icona a forma di matita nelle intestazioni dei menu collega direttamente gli amministratori alle impostazioni del componente

:briefcase: Casi d’uso

  • Risorse e collegamenti rapidi solo per lo staff
  • Scorciatoie per i moderatori di categoria
  • Portali di gruppo personalizzati (team di progetto, gruppi di studio, club del libro, membri VIP)
  • Collegamenti a risorse del sito web principale o partner

:gear: Impostazioni

Sezioni del menu (menu_sections)

Apre l’editor delle impostazioni degli oggetti per configurare le sezioni del menu di gruppo personalizzate.

Proprietà della sezione

Proprietà Descrizione
Titolo del menu Titolo visualizzato come intestazione della sezione della barra laterale
Gruppi consentiti Gruppi autorizzati a visualizzare questa sezione del menu (max: 20 gruppi per sezione)
Link del menu Raccolta di link da visualizzare in questa sezione (max: 20 link per sezione)

Proprietà del link

Proprietà Descrizione
Icona Nome dell’icona FontAwesome (es. circle-info, star, user-group). Potrebbe essere necessario aggiungerla a Admin \u003e Tutte le impostazioni del sito \u003e subset di icone svg
Testo Etichetta di visualizzazione per il link
URL Destinazione del link - supporta percorsi relativi (/faq, /my/preferences) e URL assoluti (https://example.com)

:wrench: Installazione e configurazione

  1. Installa il componente tema come descritto in Installing a theme or theme component.
  2. Vai all’ Editor delle impostazioni degli oggetti
  3. Fai clic sul pulsante + new_menu_section per configurare la prima sezione del menu personalizzata
  4. Assegna un titolo al nuovo menu nel campo Titolo del menu, quindi seleziona i gruppi che devono avere accesso ad esso.
  5. Fai clic su + new_menu_section per aggiungere un’altra sezione, oppure Salva modifiche.
Screenshot della configurazione amministrativa con impostazione di esempio

Installazione fresca - vai all’Editor delle impostazioni degli oggetti.

\u003e #### Scenario di esempio con 2 menu personalizzati e 3 utenti, uno dei quali è un amministratore:
\u003e * @Catra ama i gatti ed è membro del gruppo pink, che avrà accesso al Menu Gatto :grinning_cat:
\u003e * @HelloKitty ama i cani ed è membro del gruppo purple, che avrà accesso al Menu Cane :dog_face:
\u003e * @Lilly è membro di purple perché possiede un cane e i cani sono migliori. Tuttavia, è anche un amministratore del forum e gli amministratori avranno accesso al Menu Gatto perché i gatti hanno bisogno di più supervisione :dog_face: :cat_with_wry_smile:

Crea un nuovo menu personalizzato - per il nostro esempio, crea Menu Gatto e aggiungi i gruppi autorizzati ad accedervi - pink e admins. Quindi fai clic sul pulsante + menu_link per configurare i link per il nuovo menu.

Aggiungi i link del menu - 1. nome icona Fontawesome, 2. testo da visualizzare per il link e 3. l’URL, relativo o assoluto. Fai clic sul pulsante + menu_link per aggiungere un altro link a questo menu.

Crea un’altra sezione del menu personalizzata chiamata Menu Cane, consenti l’accesso solo al gruppo purple e configura i link:

Screenshot dell'accesso al menu laterale risultante

L’utente @Catra ha il menu Gatto! :grinning_cat:

L’utente @HelloKitty ha il menu Cane! :dog_face:

L’utente amministratore @Lilly ha entrambi i menu e può modificarli! :smiling_cat_with_heart_eyes:

Esempio di configurazione

Titolo Menu: "Risorse Staff"
Gruppi Consentiti: staff
Link:
  - Icona: wrench
    Testo: Guida alla moderazione
    URL: /t/moderation-guide/123
  - Icona: chart-line
    Testo: Dashboard Analisi
    URL: /admin/dashboard

:light_bulb: Note importanti

Accesso Amministrativo

  • Gli amministratori devono aggiungersi ai gruppi per vedere i menu configurati per tali gruppi. Lo stato di amministratore da solo non garantisce l’accesso a tutti i menu personalizzati. Questo è intenzionale!
  • Gli amministratori che appartengono ai gruppi consentiti di un menu vedranno un’icona a forma di matita nell’intestazione della sezione che collega alle impostazioni del componente.

Configurazione del gruppo

  • Il gruppo everyone non è supportato - Utilizza l’interfaccia utente del piè di pagina della barra laterale nativa per creare menu personalizzati globali per tutti gli utenti, inclusi i visitatori anonimi.
  • Massimo 20 gruppi per sezione di menu. Se ne hai bisogno di più, crea sezioni duplicate con assegnazioni di gruppo diverse.
  • Gli utenti in più gruppi vedranno tutte le sezioni del menu a cui hanno accesso.

Test e organizzazione

  • Usa account di prova per verificare l’accesso corretto per le diverse combinazioni di gruppi.
  • Tieni traccia delle configurazioni dei menu per evitare confusione man mano che la complessità aumenta; si consiglia una matrice di accesso o una documentazione simile per i forum più grandi con molti gruppi.

Considerazioni sulla sicurezza

Questo componente fornisce il controllo degli accessi a livello di interfaccia utente. Controlla l’accesso al menu, non l’accesso alle risorse - non sostituisce le autorizzazioni di sicurezza delle categorie.

Cosa protegge questo componente:

  • :white_check_mark: Le sezioni del menu non possono essere accessibili da gruppi di utenti non autorizzati
  • :white_check_mark: Link non scopribili tramite ispettore/console/modalità sicura
  • :white_check_mark: UX pulita senza ingombro nel menu

Pratiche consigliate per gli amministratori:

  • Configura separatamente le autorizzazioni di sicurezza di qualsiasi categoria collegata e l’appartenenza al gruppo pertinente prima di configurare questo componente - pianifica la tua configurazione.
  • Gli amministratori sono responsabili di garantire che i link a risorse esterne siano appropriatamente autorizzati per i gruppi selezionati.

Altre note :pen:

  • Questo componente è compatibile con Discourse Sidebar Menu Reorder, che è stato utilizzato per posizionare le due sezioni del menu di esempio negli screenshot in cima alla barra laterale. Utilizza semplicemente il titolo della sezione del menu personalizzata in formato slug, ad esempio: cat-menu.
  • Questo è stato un progetto collaborativo con @Moin - il suo contributo, ispirazione e feedback sono stati inestimabili.
7 Mi Piace

Sembra che stia ottenendo un 404 sul repository.

EDIT: Tutto a posto ora!

1 Mi Piace

haha riprova. ho dimenticato di renderlo pubblico! :laughing:

4 Mi Piace