Discourse 侧边栏菜单重新排序

[Lilly (Lillian)]

	摘要	允许重新排序默认和自定义侧边栏菜单部分
	预览	https://discourse.theme-creator.io/theme/Lilly/discourse-sidebar-menu-reorder
	仓库	https://github.com/Lillinator/discourse-sidebar-menu-reorder
	安装指南	如何安装主题或主题组件

安装此主题组件

简介

我注意到许多 Discourse 管理员希望重新排序侧边栏菜单部分，包括全局自定义部分。由于目前使用 CSS 实现这一点对大多数人来说并不直观或简单，而且这样做难以管理和修改，因此我创建了一个主题组件，使其在管理界面中变得更容易操作。

概述

此 Discourse 主题组件允许管理员在管理用户界面中重新排序论坛的侧边栏菜单部分，包括所有默认部分以及任何全局可见的自定义部分。

该组件适用于桌面和移动侧边栏视图，以及标题下拉模式（尽管理想情况下，它是为侧边栏模式设计的）。

---

安装与配置

• 按照 Discourse 主题使用入门指南 安装此主题组件。
• community 部分指的是侧边栏顶部的默认部分——带有 Topics 标题的菜单，并包含 More 下拉子菜单；建议不要将超过一两个部分（默认或自定义）移到 community 部分之上。
• 请勿在设置中删除任何默认部分，否则它们将失去顺序（您随时可以重新添加它们或重置设置）。
• 配置此组件的最佳方法是：在一个浏览器窗口中打开带有重新排序列表设置的组件管理屏幕，在另一个相邻窗口中以测试用户身份查看论坛侧边栏；每次更改列表中的菜单部分顺序后，请刷新页面。

---

设置

设置	描述
Sidebar menu order	一个包含默认菜单部分的列表设置。（community 是侧边栏顶部的默认部分，包含 More 下拉子菜单。）使用侧面的上下箭头重新排序菜单部分。还可以添加全局可见的自定义部分——请使用菜单名称的 slug（例如，对于名为 Test Menu 的自定义菜单，在设置中添加 test-menu）。

该主题组件初始使用默认设置。管理员需要添加他们希望混合到排序列表中的任何全局自定义菜单部分，然后与默认部分一起重新排序。

默认组件设置截图

---

截图

以下截图展示了 community 部分以及两个示例自定义菜单部分，分别名为 “Dev Links”（dev-links）和 “Toolbox”（toolbox）。左侧显示组件管理面板中的样子，右侧显示普通用户看到的样子。用于在组件管理设置中上下移动菜单部分的箭头显示在红色小框中。

---

此处，设置已配置为在 community 部分之上显示默认的 categories 部分（折叠和展开模式）：

这是一个使用两个自定义部分的示例：一个名为 dev-links 的部分位于默认 community 部分之上，另一个名为 toolbox 的部分位于默认 tags 部分之下。

此外，请注意上述管理截图中的 inbox-section 部分——这是 侧边栏消息部分 组件插入到侧边栏中的 Messages 部分（位于上述 toolbox 自定义菜单之下），表明此组件也可用于移动它。

此外，此主题组件可与 群组侧边栏菜单 和 缩进子分类 组件一起使用（请参见上方截图）。

---

注意事项

• 向 sidebar_menu_order 设置添加新的全局自定义部分后，论坛用户在刷新浏览器或折叠/展开侧边栏时将看到新的正确菜单顺序。
• 在此组件启用时创建新的全局自定义菜单部分可能会导致管理员暂时看到重复的部分，直到侧边栏重新渲染（通过刷新页面或折叠/展开）。
• 用户创建的自定义菜单部分将始终出现在该用户侧边栏的底部，但除此之外不受影响。
• 如果 Admin -> All Site Settings -> Chat Separate Sidebar Mode 设置设为 Always，聊天按钮将照常出现在底部，并且该组件将忽略默认的聊天菜单部分（chat-dms、chat-channels 和 chat-search）。

---

查看我的其他 Discourse 内容

[David_Ghost]

太棒了。我真的很喜欢使用分类 (1) 然后聊天的 (2) 设置。非常感谢您莉莉（Lilly）出色的工作。

[R23D_Printing]

这还支持吗？我尝试安装时遇到了以下错误。我从这里和使用手动说明都试过了。

[Moin]

是的，确实如此。 “安装此主题组件”按钮中的链接已过时，但顶部的链接仍然正确，您可以使用它来手动安装该组件。

或者您可以尝试此按钮

安装此主题组件

[nathank (Nathan Kershaw)]

我已经修复了OP中安装按钮的链接，所以现在一切都好了。

[nathank (Nathan Kershaw)]

我遇到了一个小错误，当我的“桌面”屏幕特别窄时——比如在我的折叠手机上——指定的顺序不起作用。

我希望它看起来是这样的：

   

当我的屏幕尺寸很奇怪时（似乎宽度在 640-820 左右），顺序就乱了：

[Lilly (Lillian)]

哦，天哪，两栏侧边栏又回来了。我以为那个东西已经消失了？我去看看……

[nathank (Nathan Kershaw)]

原来是我有点糊涂了！我当时用的是旧组件，都没注意到。

不过我发现了一件事——原来被称为 community 的现在改成了 the-forum。这是个整理默认设置的拉取请求（PR）：

Update settings.yml (#3)

[Moin]

@nathank

之前被称为 community 的现在被称为 the-forum

在我的论坛上它仍然被称为 community，在这里的 Meta 上也是如此。

我想知道你是如何更改它的。

[nathank (Nathan Kershaw)]

那确实很奇怪！我现在回想起来，确实记得在某个阶段更改过上面的文本。但不确定那段 HTML 是怎么进来的！

我将撤回那个 PR，再仔细琢磨一下。这可能只能成为我网站的一个“怪癖”了！

[Lilly (Lillian)]

你应该能够使用一些 rails 命令将其重命名回来。如果你的版块确实叫做 the-forum，那么我认为从 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 "完成：已重命名为 'community'。"
else
  puts "未找到版块。"
end

一定要先备份。

[nathank (Nathan Kershaw)]

终于试了一下这个。不过它没有找到该部分：

我想这可能只是网站的一个小怪癖吧，对吧？

[Lilly (Lillian)]

(帖子已被作者删除)

[Lilly (Lillian)]

注意：我刚刚为此组件推送了一些移动端修复——它之前开始渲染侧边栏区块之间的水平线，而这些线条本应仅在桌面或平板视图中显示。