club-1 / flarum-ext-cross-references
当讨论被另一讨论提及时,添加交叉引用链接。
v1.1.1
2023-05-10 18:12 UTC
Requires
- php: >=7.3
- flarum/core: ^1.6.3
Requires (Dev)
- flarum/phpstan: dev-main
- flarum/testing: ^1.0.0
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-mockery: ^1.1
- phpstan/phpstan-phpunit: ^1.2
Suggests
- club-1/flarum-ext-chore-commands: Allows to reparse all the comment posts with the new formatter's configuration
README
这是一个Flarum 扩展。当讨论被另一讨论提及时,添加交叉引用链接。
功能
这个扩展主要受到 GitHub 交叉链接功能的启发。它将类似功能添加到 Flarum 论坛中。
- 目标讨论中的 EventPost
- 在引用它的帖子保存时创建
- 回链到源并显示其标题
- 显示源 ID(可选)
- 显示源的主要标签(可选)
- 显示源的次要标签(可选)
- 源讨论中的链接
- 在文本与 href 相同时,显示目标讨论的标题
- 如果它指向特定评论,则具有
(评论)
指示 - 由于使用 FrontEnd Router,因此可以更快地加载目标讨论
- 在预览中显示的方式与发布后将看到的方式相同
- 从
#<id>
文本(例如#42
)自动创建(可选) - 在输入
#
时通过选择框自动完成 - 显示目标 ID(可选)
- 显示目标的主要标签(可选)
- 显示目标的次要标签(可选)
- 讨论列表
- 显示讨论 ID(可选)
- HeaderRow
- 显示讨论 ID(可选)
已知问题
有时在渲染的帖子中,讨论链接显示为纯链接而不是讨论标题,但在预览中按预期显示。
这是因为在调用 Formatter->render()
或 CommentPost->formatContent()
时,渲染器使用 $request = null
。这可能是由于另一个扩展在调用时未设置此参数。
启用 Flarum 的调试模式 然后检查 Flarum 的日志 以找到问题的来源。
以下是如何在所述扩展中修复此问题的示例:the-turk/flarum-diff#35
安装
使用 composer 安装
composer require club-1/flarum-ext-cross-references:"*"
建议
此扩展本身不会将格式更改应用于之前发布的评论。如果您想重新解析数据库中所有评论帖子,建议安装并启用 club-1/flarum-ext-chore-commands
扩展并使用其 chore:reparse
命令。
更新
composer update club-1/flarum-ext-cross-references:"*"
php flarum migrate
php flarum cache:clear