Seitenleisten-Kategorien-Organisator

Ich habe einen Seitenleisten-Organisator erstellt. Es gab vor einiger Zeit viele Diskussionen darüber, und andere meinten, er sei nicht notwendig, aber ich hatte immer das Gefühl, dass meine Benutzer nicht sehr technikaffin sind oder am Anfang nicht gut wissen, wie das Forum funktioniert. Deshalb habe ich diesen Dropdown-Organisator erstellt, um zu helfen.

Oben gibt es einen kleinen Umschalter, damit Benutzer zwischen den Ansichten wechseln und wählen können, welche sie bevorzugen.

Seitenleisten-Kategorie-Organisator

Eine Discourse-Themenkomponente, die Seitenleistenkategorien in anpassbare, einklappbare, farbcodierte Abschnitte mit erweiterten Funktionen organisiert.

Funktionen

  • 10 Einklappbare Abschnitte: Gruppieren Sie Kategorien in bis zu 10 benutzerdefinierte Abschnitte
  • Farbanpassung: Legen Sie Hintergrund- und Textfarben für jede Abschnittsüberschrift fest
  • Verlaufshintergründe: Optionaler Verlaufseffekt wie auf den Fotos
  • Kategorie-Badges: Standardmäßige Discourse-farbige Abzeichen neben Kategorien können ein- und ausgeschaltet werden
  • Unterkategorie-Unterstützung: Umschaltmöglichkeit pro Abschnitt zum Anzeigen/Ausblenden von Unterkategorien (eingerückte Anzeige)
  • Kategorie ausblenden: Bestimmte Kategorien aus allen Ansichten ausblenden
  • Bidirektionaler Umschalter: Wechseln Sie zwischen benutzerdefinierten Abschnitten und der Standard-Discourse-Ansicht (Umschalttaste erscheint in beiden Ansichten)
  • Persistenter Zustand: Merkt sich, welche Abschnitte geöffnet/geschlossen sind und die Ansichtspräferenz des Benutzers
  • Berechtigungsbewusst: Zeigt nur Kategorien an, auf die Benutzer Zugriff haben
  • Nicht gruppierte Kategorien: Zeigt automatisch alle nicht kategorisierten Kategorien in einem separaten Abschnitt an
  • Mobilfreundlich: Funktioniert auf allen Bildschirmgrößen

Installation

  1. Gehen Sie in Ihrer Discourse-Instanz zu Admin → Anpassen → Themen
  2. Klicken Sie auf InstallierenAus einem Git-Repository
  3. Geben Sie ein: https://github.com/focallocal/sidebar-categories-organizer
  4. Klicken Sie auf Installieren
  5. Fügen Sie die Komponente Ihrem aktiven Thema hinzu

Konfiguration

Globale Einstellungen

  • Seitenleisten-Organisator aktivieren: Schaltet die benutzerdefinierte Ansicht ein/aus
  • Umschalttaste anzeigen: Zeigt das :open_file_folder:-Symbol zum Wechseln zwischen den Ansichten an (erscheint in den Kopfzeilen der benutzerdefinierten und der Standardansicht)
  • Kategorie-Badges anzeigen: Zeigt farbige Quadrate neben den Kategorienamen an
  • Verlaufseffekt verwenden: Aktiviert den Verlaufshintergrundeffekt auf Abschnittsüberschriften (50 % Deckkraft, 50 % Verblassen zu transparent)
  • Ausblendende Kategorien: Durch Kommas getrennte Kategorien-Slugs, die aus allen Ansichten ausgeblendet werden sollen (z. B. staff,private)
  • Standardansicht: Wählen Sie aus, welche Ansicht standardmäßig geladen wird (benutzerdefiniert oder Standard)

Abschnittseinstellungen (1-10)

Jeder Abschnitt hat:

  • Aktiviert: Abschnitt ein-/ausschalten
  • Titel: Text der Abschnittsüberschrift
  • Hintergrundfarbe: Farbauswahl für die Hintergrundfarbe der Abschnittsüberschrift
  • Textfarbe: Farbauswahl für die Überschrift
  • Kategorien: Durch Kommas getrennte Kategorien-Slugs (z. B. general,support,feedback)
  • Unterkategorien anzeigen: Umschalten zum Anzeigen/Ausblenden von Unterkategorien für diesen Abschnitt
  • Standardmäßig geöffnet: Ob der Abschnitt erweitert oder eingeklappt beginnt

Kategorie-Slugs finden

Kategorie-Slugs befinden sich in der URL:

  • ihreseite.com/c/general/5 → Slug ist general
  • ihreseite.com/c/feature-requests/12 → Slug ist feature-requests

Verwendung

Nach der Installation und Konfiguration:

  1. Benutzerdefinierte Ansicht: Kategorien werden in Ihren konfigurierten Abschnitten mit farbigen Überschriften gruppiert
  2. Ein-/Ausklappen: Klicken Sie auf Abschnittsüberschriften, um die Sichtbarkeit des Inhalts umzuschalten
  3. Ansichten umschalten: Klicken Sie auf das :open_file_folder:-Symbol in der Kopfzeile, um zwischen benutzerdefinierter und Standardansicht zu wechseln
    • In der benutzerdefinierten Ansicht: Die Umschalttaste erscheint in der Kopfzeile der benutzerdefinierten Ansicht
    • In der Standardansicht: Die Umschalttaste erscheint in der Standard-Kopfzeile „Kategorien“
  4. Unterkategorien: Wenn pro Abschnitt aktiviert, erscheinen Unterkategorien eingerückt unter den übergeordneten Kategorien
  5. Kategorie-Badges: Kleine farbige Quadrate (falls aktiviert) zeigen die Farbe jeder Kategorie an
  6. Nicht gruppierte Kategorien: Alle Kategorien, die keinem Abschnitt zugeordnet sind, werden unter „Andere Kategorien“ angezeigt
  7. Einstellungen: Ihre Ansichtswahl und der offene/geschlossene Zustand werden pro Browser gespeichert

Erweiterte Funktionen

Verlaufshintergründe

Wenn aktiviert, verwenden Abschnittsüberschriften einen sanften Verlauf:

  • 50 % Deckkraft (Ihre gewählte Hintergrundfarbe)
  • 50 % Verblassen zu transparent
  • Erzeugt ein modernes, elegantes Erscheinungsbild

Kategorien ausblenden

Geben Sie Kategorien-Slugs an, um sie vollständig aus der Seitenleiste auszublenden:

  • Nützlich für nur für Mitarbeiter oder veraltete Kategorien
  • Gilt für benutzerdefinierte und Standardansichten
  • Durch Kommas getrennte Liste (z. B. staff,private,archived)

Unterkategorien

  • Umschalten pro Abschnitt (nicht global)
  • Eingerückte Anzeige mit etwas kleinerer Schriftart
  • Reduzierte Deckkraft für visuelle Hierarchie
  • Behält die Farben der Kategorie-Badges bei

Version

  • Aktuell: 1.0.1
  • Mindest-Discourse: 3.3.0
  • Autor: Andy@Focallocal

Lizenz

MIT-Lizenz – Siehe LICENSE-Datei

Support

Probleme melden: GitHub · Where software is built

Tolle Arbeit :clap:

Tipp zu den Kategorieeinstellungen

Anstatt Administratoren die Eingabe von Kategorieschnecken (slugs) zu überlassen, können Sie dies beispielsweise in Ihrer settings.yml-Datei verwenden:

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

was Ihnen eine Einstellung wie diese gibt:

Sie können dasselbe auch mit Gruppen tun, falls Sie jemals ein Gruppen-Dropdown wünschen:

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

was etwas wie dies ergibt:

2 „Gefällt mir“