README

ID生成器 扩展提供了一个简约的序列数字ID生成功能。它由 Professional.Wiki 创建。

维基文本 {{#next_number:}} 第一次使用时输出 1，然后是 2，等等。

无需运行“update.php”维护脚本即可安装和使用。作为 IDProvider 扩展的替代品创建，因为它无法通过 Composer 安装，并且还需要额外的数据库表。

用法

获取新的数字ID

{{#next_number:}}

上述函数将在每次重新解析页面时输出新的数字。如果您想要生成一次数字，可以使用以下 MediaWiki 的 subst 函数

{{subst:#next_number:}}

您可以通过提供 ID 类型来拥有多个 ID 序列。此类型可以是任意长至60个字符的字符串。

{{#next_number:project}}

数字增量详情

示例

带有 {{#next_number:}} {{#next_number:}} 的页面将输出 1 2，假设扩展刚刚安装。如果ID计数器已经达到100，您将得到 101 102。如果您然后刷新此页面，您将得到 103 104。

推荐使用 Composer 和 MediaWiki 内置的 Composer 支持来安装 ID 生成器。

切换到您的 MediaWiki 安装的基础目录。如果您还没有 "composer.local.json" 文件，请创建一个并添加以下内容到其中

{
	"require": {
		"professional-wiki/id-generator": "~1.0"
	}
}

如果您已经有了 "composer.local.json" 文件，请将以下行添加到文件中 "require" 部分的末尾

"professional-wiki/id-generator": "~1.0"

请记住在此部分末尾添加逗号。

在您的 shell 中运行以下命令

php composer.phar update --no-dev

注意：如果您在系统上安装了 Git，请向上述命令添加 --prefer-source 标志。

将以下行添加到您的 "LocalSettings.php" 文件的末尾

wfLoadExtension( 'IdGenerator' );

如果您想为项目做出贡献，请订阅开发者邮件列表并查看贡献指南。

发布于 2020 年 1 月 27 日。

首次发布