MediaWiki创建页面内容模型基础

创建MediaWiki页面内容模型，开发扩展来实现，包含三个必要文件。

例：自定义名称Goat。

• extension.json。扩展配置文件。
• GoatContent.php。内容管理器。
• GoatContentHandler.php。控制器。

注册扩展

"ContentHandlers": {
	"goat": "MediaWiki\\Extension\\GoatExt\\GoatContentHandler"
}

创建内容模型

"namespaces": [
	{
		"id": 555,
		"constant": "NS_GOAT",
		"name": "Goat",
		"subpages": false,
		"content": true,
		"defaultcontentmodel": "goat"
	},
	{
		"id": 556,
		"constant": "NS_GOAT_TALK",
		"name": "Goat_talk",
		"subpages": true,
		"content": false,
		"defaultcontentmodel": "wikitext"
	}
]

添加内容管理器和控制器

<?php

namespace MediaWiki\Extension\GoatExt;

class GoatContentHandler extends \ContentHandler {

	public function __construct( $modelId = 'goat' ) {
		parent::__construct( $modelId, [ CONTENT_FORMAT_TEXT ] );
	}

	public function serializeContent( \Content $content, $format = null ) {
	}

	public function unserializeContent( $blob, $format = null ) {
	}

	public function makeEmptyContent() {
		return new GoatContent();
	}

	public function supportsDirectEditing() {
		return true;
	}
}

<?php

namespace MediaWiki\Extension\GoatExt;

class GoatContent extends \AbstractContent {

	public function __construct( $modelId = 'goat' ) {
		parent::__construct( $modelId );
	}

	public function getTextForSearchIndex() {
	}

	public function getWikitextForTransclusion() {
	}

	public function getTextForSummary( $maxLength = 250 ) {
	}

	public function getNativeData() {
	}

	public function getSize() {
	}

	public function copy() {
	}

	public function isCountable( $hasLinks = null ) {
	}

	public function getName() {
		return 'Garry';
	}
}

内置模版如图：

上面代码是官方文档内容，建议复制一组出来，在其基础上修改。文档讲的很笼统，加上版本差异，实际操作起来还是需要一些功底的。

简单总结：先写配置文件，然后添加两个php模版文件，再接着开发功能。

整理了一个基础模版拓展，拿过来可以直接用。内容模型直接用的原版JSON模型（版本1.30）。在LocalSettings.php中添加后便能看到效果。

wfLoadExtension( 'Goat' );

GitHub地址：Goat Demo。

参考配置文件：

{
	"name": "Goat",
	"author": [ "Pury" ],
	"type": "other",
	"requires": {
		"MediaWiki": ">= 1.30.0"
	},
	"ContentHandlers": {
		"goat": "GoatContentHandler"
	},
	"namespaces": [
		{
			"id": 467,
			"constant": "NS_GOAT",
			"name": "Goat",
			"subpages": false,
			"content": true,
			"defaultcontentmodel": "goat"
		},
		{
			"id": 468,
			"constant": "NS_GOAT_TALK",
			"name": "Goat_talk",
			"subpages": true,
			"content": false,
			"defaultcontentmodel": "wikitext"
		}
	],
	"AutoloadClasses": {
		"GoatContent": "GoatContent.php",
		"GoatContentHandler": "GoatContentHandler.php"
	},
	"manifest_version": 1
}

官方推荐示例扩展：examples，有详细注释，有些用法未必是最优解，不包含任何编辑功能，可以参考看看。

官方文档：页面内容模型