Seitenleisten-Kategorien-Organisator

[Drew-ART (Drew)]

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.

Dieses Theme-Komponente installieren

Oben gibt es einen kleinen Umschalter, damit Benutzer zwischen Standard und dieser Ansicht wechseln und wählen können, was ihnen lieber ist. Ich habe ihn dort platziert, weil ich denke, dass viele erfahrene Benutzer ihre Navigations-Seitenleiste anpassen möchten, die meisten neueren Benutzer dies jedoch nicht.

Sidebar Categories Organizer (Seitenleisten-Kategorie-Organisator)

Eine Discourse-Theme-Komponente, 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: Optionale Verlaufsausblendeeffekt 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, um Unterkategorien ein- oder auszublenden (eingerückte Anzeige)
• Kategorien ausblenden: Bestimmte Kategorien aus allen Ansichten ausblenden
• Bidirektionaler Umschalter: Wechseln Sie zwischen benutzerdefinierten Abschnitten und der Standard-Discourse-Ansicht (Umschaltfläche 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 → Themes
2. Klicken Sie auf Installieren → Aus 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 Theme hinzu

Konfiguration

Globale Einstellungen

• Seitenleisten-Organisator aktivieren: Schaltet die benutzerdefinierte Ansicht ein/aus
• Umschaltfläche anzeigen: Zeigt das -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
• Verlaufsausblendung verwenden: Aktiviert den Verlaufshintergrundeffekt auf Abschnittsüberschriften (50 % Volltonfarbe, 50 % Verblassen zu transparent)
• Ausblendende Kategorien: Durch Kommas getrennte Kategorieschnecken, 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: Schaltet den Abschnitt ein/aus
• Titel: Text der Abschnittsüberschrift
• Hintergrundfarbe: Farbauswahl für die Hintergrundfarbe der Abschnittsüberschrift
• Textfarbe: Farbauswahl für die Überschrift
• Kategorien: Durch Kommas getrennte Kategorieschnecken (z. B. general,support,feedback)
• Unterkategorien anzeigen: Umschalten, um Unterkategorien für diesen Abschnitt anzuzeigen/auszublenden
• Standardmäßig geöffnet: Ob der Abschnitt erweitert oder eingeklappt beginnt

Finden von Kategorieschnecken

Kategorieschnecken befinden sich in der URL:

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

Verwendung

Nach der Installation und Konfiguration:

1. Benutzerdefinierte Ansicht: Kategorien sind in Ihren konfigurierten Abschnitten mit farbigen Überschriften gruppiert
2. Ein-/Ausklappen: Klicken Sie auf Abschnittsüberschriften, um die Sichtbarkeit des Inhalts umzuschalten
3. Ansichten wechseln: Klicken Sie auf das -Symbol in der Kopfzeile, um zwischen benutzerdefinierter und Standardansicht zu wechseln
   • In der benutzerdefinierten Ansicht: Die Umschaltfläche erscheint in der Kopfzeile der benutzerdefinierten Ansicht
   • In der Standardansicht: Die Umschaltfläche erscheint in der Standard-„Kategorien“-Kopfzeile
4. Unterkategorien: Wenn pro Abschnitt aktiviert, erscheinen Unterkategorien eingerückt unter den Hauptkategorien
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, erscheinen unter „Andere Kategorien“
7. Einstellungen: Ihre Ansichtswahl und der geöffnete/geschlossene Zustand werden pro Browser gespeichert

Erweiterte Funktionen

Verlaufshintergründe

Wenn aktiviert, verwenden Abschnittsüberschriften einen sanften Verlauf:

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

Kategorien ausblenden

Geben Sie Kategorieschnecken 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

[Lilly]

Tolle Arbeit

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:

[jenmck (jen)]

Das gefällt mir wirklich gut und ist definitiv etwas, das mir auch schon durch den Kopf gegangen ist, also vielen Dank!

Frage: Wenn ein Benutzer in einem bestimmten Bereich keinen Zugriff auf Kategorien hat, wird ihm der Bereich selbst dann trotzdem angezeigt?

[NateDhaliwal]

Ja, das tut es:

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

[Drew-ART (Drew)]

Nein, die Kategorie/Unterkategorie wird ausgeblendet, wenn sie keinen Zugriff darauf haben. Sie können über die Einstellungen auch manuell alle ausblenden, die Sie möchten.

[Drew-ART (Drew)]

Danke, Lilly. Ich werde das und meine anderen aktuellen Komponenten aktualisieren, um sie zu verbessern.

[Drew-ART (Drew)]

Das Plugin wurde jetzt mit schönen Dropdown-Auswahlfeldern aktualisiert.

[jenmck (jen)]

Richtig, das habe ich verstanden – aber ich meine den eigentlichen Abschnitt, nicht nur die Kategorie.

Angenommen, ich habe dieses Setup:

Tiere

• Katzen
• Hunde

Wolken

• Nimbus
• Cumulus

Tage

• Samstag
• Sonntag

Angenommen, ein Benutzer hat keinen Zugriff auf die Kategorien Nimbus oder Cumulus. Würde der Abschnitt „Wolken“ dem Benutzer trotzdem angezeigt, aber ohne Kategorien, so wie hier:

Tiere

• Katzen
• Hunde

Wolken

Tage

• Samstag
• Sonntag

Oder würde der Abschnitt „Wolken“ überhaupt nicht angezeigt, so wie hier:

Tiere

• Katzen
• Hunde

Tage

• Samstag
• Sonntag

[Drew-ART (Drew)]

Wenn ein Benutzer keine Berechtigung hat, Kategorien in einem Bereich anzuzeigen, wird der gesamte Bereich (Tab) ausgeblendet.

[Heliosurge (Dan DeMontmorency)]

Das ist ziemlich cool!

Bringt mich dazu, Ideen zu überdenken, lol.

Ich habe mit der Idee gespielt, das Doc Categories Plugin zur Darstellung benutzerdefinierter Abschnitte mit fokussierten Menüs zu verwenden. Aber es braucht ein „Ankleiden“, um Farben und Symbole zu ermöglichen.

Es gibt ein Markdown, um die „Install component“ zu Op hinzuzufügen.

Hat sich bei Meta etwas geändert? Ich kann hier auf Android etwas nicht markieren, um es zu zitieren. - ok, scheint behoben zu sein.

[Heliosurge (Dan DeMontmorency)]

Hallo Lily, könnten wir das Markdown für „Komponente installieren“ haben?

[NateDhaliwal]

Hier ist eines für diese Komponente:

Diese Themenkomponente installieren

Markdown-Format (ersetzen Sie repoName und repoUrl):

[wrap=theme-install-button repoName="Name der Komponente" repoUrl="Link zum GitHub-Repository"]
Diese Themenkomponente installieren
[/wrap]

[Heliosurge (Dan DeMontmorency)]

Danke Nate. Habe versucht zu suchen, aber vielleicht waren die Begriffe zu allgemein.

[NateDhaliwal]

Oh, ich bin mir nicht sicher, ob es überhaupt irgendwo erwähnt wird. Ich habe es aus der #theme-component-Themenvorlage entfernt .

[Heliosurge (Dan DeMontmorency)]

Das ist sicher cool. Meta sollte vielleicht das andere TC von zOp in Betracht ziehen, da es beim Erstellen eines Themas eine Vorlage einfügen kann.