Réorganisation du menu latéral de Discourse

[Lilly (Lillian)]

| | |
|— | — | —|
| | Résumé | Permet de réorganiser les sections par défaut et personnalisées du menu de la barre latérale|
| | Aperçu | https://discourse.theme-creator.io/theme/Lilly/discourse-sidebar-menu-reorder|
| | Dépôt | https://github.com/Lillinator/discourse-sidebar-menu-reorder|
| | Guide d’installation | Comment installer un thème ou un composant de thème|

Installer ce composant de thème

Introduction

J’ai remarqué de nombreuses demandes de la part d’administrateurs Discourse souhaitant réorganiser les sections du menu de la barre latérale, y compris les sections personnalisées globales. Comme ce n’est actuellement ni très intuitif ni simple pour la plupart des gens à réaliser avec du CSS, et que cela peut être difficile à gérer et à modifier, j’ai créé un composant de thème qui rend cette tâche beaucoup plus facile depuis l’interface d’administration.

Aperçu

Ce composant de thème Discourse permet aux administrateurs de réorganiser les sections du menu de la barre latérale de leur forum dans l’interface d’administration, y compris toutes les sections par défaut ainsi que toutes les sections personnalisées visibles globalement.

Le composant fonctionne pour les vues de la barre latérale sur ordinateur et mobile, ainsi que pour le mode déroulant de l’en-tête (bien qu’il soit idéalement conçu pour le mode barre latérale).

---

Installation & Configuration

• Installez ce composant de thème conformément au Guide pour débutants sur l’utilisation des thèmes Discourse.
• La section community fait référence à la section supérieure par défaut de la barre latérale — le menu avec l’en-tête Sujets et inclut le sous-menu déroulant Plus ; il est recommandé de ne déplacer qu’une ou deux sections (par défaut ou personnalisées) au-dessus de la section community.
• Ne supprimez aucune des sections par défaut dans les paramètres, sinon elles seront désordonnées (vous pouvez toujours les réajouter ou réinitialiser le paramètre).
• La meilleure façon de configurer ce composant est d’avoir l’écran d’administration du composant avec le paramètre de liste de réorganisation dans une fenêtre de navigateur, et la vue de la barre latérale du forum en tant qu’utilisateur test dans une autre fenêtre à côté ; rechargez la page après chaque changement d’ordre des sections du menu dans la liste.
• Dans le paramètre d’administration du composant, assurez-vous d’utiliser le format de nommage par slug pour les sections personnalisées, sinon elles seront ignorées (c’est-à-dire utilisez custom-menu-name pour « Custom Menu Name », useful-links pour « Useful Links », etc.)

---

Paramètres

Paramètre

Description

Sidebar menu order

Un paramètre de liste contenant les sections du menu par défaut. (community est la section supérieure par défaut dans la barre latérale et inclut le sous-menu déroulant More. ) Réorganisez les sections du menu à l’aide des flèches haut et bas sur le côté. Des sections personnalisées visibles globalement peuvent également être ajoutées — utilisez le slug du nom du menu (par exemple, pour un menu personnalisé intitulé Test Menu, ajoutez test-menu dans le paramètre).

Le composant de thème possède initialement les paramètres par défaut. Les administrateurs doivent ajouter toutes les sections de menu personnalisées globales qu’ils souhaitent intégrer à la liste de réorganisation, puis les réorganiser avec les sections par défaut.

capture d'écran des paramètres par défaut du composant

---

Captures d’écran

Les captures d’écran ci-dessous montrent la section community, et deux exemples de sections de menu personnalisées appelées « Dev Links » (dev-links) et « Toolbox » (toolbox) telles qu’elles apparaissent dans le panneau d’administration du composant à gauche, et pour un utilisateur régulier à droite. Les flèches permettant de déplacer une section de menu vers le haut et vers le bas dans le paramètre d’administration du composant sont indiquées dans le petit cadre rouge.

---

Ici, le paramètre est configuré pour afficher la section par défaut categories au-dessus de la section community (modes réduit et développé) :

Voici un exemple utilisant deux sections personnalisées : l’une appelée dev-links qui se trouve au-dessus de la section par défaut community, et une autre appelée toolbox qui se situe sous la section par défaut tags.

Remarquez également la section appelée inbox-section dans la capture d’écran d’administration ci-dessus — il s’agit de la section Messages que le composant Section Messages pour la barre latérale insère dans la barre latérale (sous le menu personnalisé toolbox ci-dessus), montrant que ce composant peut également être utilisé pour la déplacer.

De plus, ce composant de thème peut être utilisé conjointement avec les composants Group sidebar menus et Indented subcategories (voir dans la capture d’écran ci-dessus).

---

Remarques

• Après avoir ajouté de nouvelles sections personnalisées globales au paramètre sidebar_menu_order, les utilisateurs du forum verront le nouvel ordre correct du menu lorsqu’ils rechargeront leur navigateur ou plieront/déplieront la barre latérale.
• Créer de nouvelles sections de menu personnalisées globales pendant que ce composant est activé peut entraîner des sections temporaires en double pour l’administrateur jusqu’à ce que la barre latérale soit rendue à nouveau, soit par un rafraîchissement de la page, soit en la pliant et la dépliant.
• Les sections de menu personnalisées créées par les utilisateurs apparaîtront toujours en bas de la barre latérale pour cet utilisateur, mais ne sont autrement pas affectées.
• Si le paramètre Admin -> Tous les paramètres du site -> Mode de barre latérale séparée pour le chat est défini sur Toujours, le bouton de chat apparaîtra comme d’habitude en bas, et le composant ignorera les sections de menu de chat par défaut (chat-dms, chat-channels et chat-search).

---

Découvrez mes autres créations Discourse

[David_Ghost]

C’est tellement cool. J’aime vraiment utiliser la configuration catégories (1) puis chat (2). Merci beaucoup pour votre excellent travail Lilly

[R23D_Printing]

Est-ce toujours pris en charge ? J’ai essayé d’installer et j’ai obtenu l’erreur suivante. J’ai essayé à partir d’ici et aussi en utilisant les instructions manuelles.

[Moin]

Oui, c’est le cas. Le lien dans le bouton « installer ce composant de thème » est obsolète, mais le lien en haut est toujours correct et vous pouvez l’utiliser pour installer le composant manuellement

Ou essayez ce bouton

Installer ce composant de thème

[nathank (Nathan Kershaw)]

Je viens de corriger le lien dans le bouton d’installation dans le message initial, donc tout va bien maintenant.

[nathank (Nathan Kershaw)]

J’ai rencontré un petit bug, où l’ordre spécifié ne fonctionne pas lorsque j’ai un écran d’ordinateur de bureau inhabituellement étroit.

Voici à quoi je veux que cela ressemble :

   

Lorsque j’ai un écran de taille étrange (c’est-à-dire mon téléphone pliable - semble avoir une largeur d’environ 640-820), je perds l’ordre :

Mais dans l’in

[Lilly (Lillian)]

oh mon dieu le retour de la barre latérale à 2 colonnes. je pensais que ce truc avait disparu ? je vais jeter un œil…

[nathank (Nathan Kershaw)]

C’était effectivement moi qui étais un peu bête ! J’utilisais l’ancien composant et je ne l’avais même pas remarqué.

J’ai cependant remarqué une chose : ce qui était appelé community est maintenant appelé the-forum. Voici une PR pour nettoyer cela dans les paramètres par défaut :

Update settings.yml (#3)

[Moin]

@nathank

ce qui était appelé community est maintenant appelé the-forum à la place

Sur mon forum, il est toujours appelé community et ici aussi sur Meta.

Je me demande comment vous l’avez changé.

[nathank (Nathan Kershaw)]

C’est vraiment bizarre ! Je me souviens avoir changé le texte à un moment donné maintenant que j’y pense. Mais je ne sais pas comment c’est arrivé dans le HTML !

Je vais retirer cette PR et réfléchir un peu plus. Il se pourrait que cela reste une « particularité » de mon site !

[Lilly (Lillian)]

vous devriez être en mesure d’exécuter quelques commandes rails pour le renommer. si votre section s’appelle bien the-forum, alors je pense que cela devrait fonctionner depuis la console rails :

cd /var/discourse
./launcher enter app
rails c

section = SidebarSection.find_by(title: 'the-forum', public: true)
if section
  section.update!(title: 'community')
  puts "Terminé : renommé en 'community'."
else
  puts "Section non trouvée."
end

faites absolument une sauvegarde d’abord.

[nathank (Nathan Kershaw)]

Je l’ai enfin essayé. Cependant, il n’a pas trouvé la section :

Je pense que cela risque de rester une particularité du site, n’est-ce pas ?

[Lilly (Lillian)]

(message supprimé par l’auteur)

[Lilly (Lillian)]

Remarque : je viens de pousser des correctifs mobiles pour ce composant — il commençait à afficher les lignes horizontales entre les sections de la barre latérale, qui ne devraient apparaître que sur les vues bureau/tablette.

[tobiaseigen]

J’utilise ce magnifique composant de thème en parallèle du tout aussi charmant composant de Lilly : Discourse Group Sidebar Menus. Mon cas d’usage consiste à créer des menus personnalisés pour les clients, afin que chaque membre d’une organisation ait accès à des liens rapides qui lui sont spécifiquement pertinents, juste en haut, après la section communautaire.

Je tenais à noter pour les futurs voyageurs (y compris moi-même) que le nom de la section de la barre latérale est très sensible et doit correspondre exactement, les espaces dans le nom étant remplacés par des tirets. Ainsi, « Doing business » devient « doing-business ».

Tout cela est très bien, mais lorsque j’ai créé la section de la barre latérale du groupe, j’ai accidentellement ajouté un espace à la fin du nom du groupe, ce qui a donné « doing-business- ». Il m’a fallu un certain temps de dépannage avec les outils de développement pour découvrir cela.

Ces fonctionnalités sont si importantes pour moi que je serais vraiment reconnaissant qu’elles soient envisagées pour être intégrées au cœur du système, afin qu’elles soient plus facilement accessibles et simples à utiliser sur n’importe quel site Discourse.

[Lilly (Lillian)]

@tobiaseigen

Je voulais signaler aux futurs voyageurs (y compris moi-même) que le nom de la section de la barre latérale est très sensible et doit correspondre exactement, les espaces dans le nom étant remplacés par des tirets. Ainsi, « Doing business » devient « doing-business ».

Merci, Tobias. J’ai en fait mentionné d’utiliser les identifiants de section dans la description du paramètre, et cela est également indiqué dans les exemples d’captures d’écran (voir « dev-links » = LIENS DEV).

@Lilly

Des sections personnalisées visibles globalement peuvent également être ajoutées — utilisez l’identifiant du nom de menu (par exemple, pour un menu personnalisé intitulé Test Menu, ajoutez test-menu dans le paramètre).

Peut-être devrais-je l’ajouter ailleurs que dans les descriptions de paramètres.

edit : fait

@Lilly

• Dans le paramètre d’administration du composant, assurez-vous d’utiliser le format de nommage par identifiant pour les sections personnalisées, sinon elles seront ignorées (par exemple : utilisez custom-menu-name pour « Custom Menu Name », useful-links pour « Useful Links », etc.)