搜索flamarkt / taxonomies
讨论、用户和产品的分类。
Requires
- ext-json: *
- flamarkt/backoffice: ^0.1.0
- flarum/core: ^1.2
Requires (Dev)
- flarum/tags: *
Replaces
README
为Flarum讨论、用户和Flamarkt产品提供分类。
此扩展可以与或没有Flamarkt安装一起使用。
安装
此扩展将遵循Flamarkt未来的发布周期，在测试版期间可能会有几个主要的0.x版本。虽然这个扩展相当稳定，但可能需要在主要版本之间进行手动操作。因此，我建议使用^要求（下面命令将使用它），而不是使用*，这样你将来就不会在阅读此README的情况下意外更新。
composer require flamarkt/taxonomies
- 转到管理员面板，启用后台办公室扩展。
- 转到后台办公室，启用分类扩展。
- 点击后台办公室侧边栏顶部的“分类”进行配置。
如果你将来安装Flamarkt，你可能需要通过SSH运行php flarum migrate以完成两个扩展之间的集成。
目前所有类型的分类都在一个页面上显示，没有适当的分隔。在未来的版本中，将引入专用页面。
Scout集成
当两个扩展都启用时，分类将自动与Scout扩展集成。仅支持Scout的0.3+版本。使用Taxonomies与Scout的旧版本将导致错误。
使用此集成，分类术语名称可以成为讨论、用户和产品索引的一部分。
此功能可以手动切换每个单独的分类。如果您更改现有分类的设置或删除分类（同时术语仍附加到资源），则必须手动重新构建搜索索引。
由于Scout的设计方式，相同的搜索索引被用于所有用户。一旦成为索引的一部分，任何具有列出资源权限的用户（“查看论坛”用于讨论，“搜索用户”用于用户以及所有人用于产品）都将能够使用搜索查询中的术语，即使他们没有权限查看分类。除非你确定所有这些资源类型的数据都是公开的，或者整个论坛都关闭了未经授权的用户，否则你可能不应该启用此功能。
已知问题
术语管理后台办公室当前未分页。这可能导致大量术语时后台办公室性能问题，这在允许自定义值时更有可能发生。
更改论坛主页可能会导致问题。将主页设置为用户列表或产品列表可能会引起问题。将主页设置为非可搜索资源列表的自定义页面应该没问题。
可用的分类和术语列表将通过REST API泄漏给任何允许使用其中任何一个的用户。这包括用户分类，即使用户只被允许编辑讨论分类也是如此。
标签范围讨论分类和术语也将通过REST API对每个用户可见，即使他们看不到它们范围到的标签。不支持更改具有范围分类的现有讨论的标签。如果您更改讨论的标签，您可能无法再次编辑其分类。
Flamarkt产品支持仍在进行中。
支持
本扩展得到积极支持。请使用 Flarum Discuss 讨论版来讨论功能和报告问题。
请只为具有可靠重现步骤的bug创建 GitHub 问题。