扩展手册

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Extensions and the translation is 86% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Mirandés • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎العربية • ‎سنڌي • ‎پښتو • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Gnome-preferences-other.svg 扩展: 开发 标签扩展 手册:解析器函数 钩子 特殊页面 手册:皮肤 手册:魔術字 API Content models

扩展允许您定制MediaWiki的外观和工作方式。

虽然许多扩展由MediaWiki的开发者维护,但其他由第三方开发者编写。 这样会导致一个结果,会出现bug,他们不能保证能够和其他扩展相互兼容。 一些扩展不能被维护,并不是所有的扩展都能工作在所有的MediaWiki版本。 使用任何扩展,特别是那些标记着不稳定的扩展,当你使用时会有所风险。 当使用一个扩展需要修补MediaWiki核心代码或者数据库将会为空时,请确认备份好你的数据库和MediaWiki核心代码,避免导致你的wiki从此中断。

Types of extensions

OOjs UI icon markup.svg Parser tags

Parser tags extend the built-in wiki markup with additional capabilities, whether simple string processing, or full-blown information retrieval.


Learn more about parser tags

OOjs UI icon code.svg Parser functions

Parser functions are special wiki markup syntax that can 'interact' with other wiki elements in the page, and give a specific output.


Learn more about parser functions

Plug-in Noun project 4032.svg Hooks

Hooks allow custom code to be executed when some defined event (such as saving a page or a user logging in) occurs.


Learn more about hooks

Noun Policy 1320312 4380c9.svg Special pages

Special pages are pages that are created by the software on demand to perform a specific function.


Learn more about special pages

Paint palette icon from the Noun Project.svg Skins

Skins allow users to customize the look and feel of MediaWiki.


Learn more about skins

Font Awesome 5 solid magic.svg Magic words

Magic words are a technique for mapping a variety of wiki text strings to a single ID that is associated with a function.


Learn more about magic words

API - The Noun Project.svg API

MediaWiki provides an action API, a web service that allows access to some wiki-features like authentication, page operations, and search.


Learn more about the MediaWiki API

OOjs UI icon article-ltr.svg Page content models

The ContentHandler introduced in MediaWiki 1.21 makes it possible for wiki pages to be composed of data other than wikitext, such as JSON or Markdown.


Learn more about content models

OOjs UI icon lock.svg Authentication

MediaWiki provides SessionManager and AuthManager, two authentication-related frameworks to enhance security via custom authentication mechanisms.


Learn more about authentication

浏览扩展插件

您可浏览分类:按分类排列的扩展 以了解已有插件的功能范围。 关于如何安装这些插件或者如何编写自己的插件,参见后续章节。

检查已安装的扩展

只有那些具备访问服务器文件系统的管理员可以安装用于MediaWiki的扩展插件,但是任何人都可以点击Special:Version页面获得当前有哪些扩展插件被用在这个MediaWiki网站上的信息。 例如,点击这里可以了解哪些扩展插件被用在了英文维基百科。

安装扩展插件

安装完MediaWiki后即可安装扩展插件。 添加一个插件需要下面几个步骤:

  1. 在您开始之前
    少数扩展插件需要安装补丁。其中大多数提供了专为unix安装命令而设计的使用说明。 这需要命令行权限(SSH)来运行这些在扩展插件帮助页面上给出的命令。
  2. 下载您的扩展。
    Extension Distributor可帮你选择和下载最受欢迎的扩展插件。
    扩展插件通常以模块的程序包形式发布。 它们通常位于$IP /extensions/的子目录中。 在维基媒体Git存储库存储的扩展列表位于git:mediawiki/extensions。 一些不使用版本控制的扩展都不推荐使用。
    bundlescomposer 包存储库中也提供了一些扩展。
  3. 安装您的扩展。.
    通常, 在LocalSettings.php 文件的结尾(但应在PHP代码结束符"?>"之前)添加下列代码:
    wfLoadExtension( 'ExtensionName' );
    
    这一条将强制PHP解释器来读取文件扩展,从而使其到MediaWiki访问。
    某些扩展可能与维护脚本冲突,例如,例如能直接访问$_SERVER(不推荐)。
    在这种情况下,他们可以被包裹在条件下进行运行,以让维护脚本仍然可以运行。
if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}
对于任何需要自定义命名空间的扩展,维护脚本importDump.php 将失败,这些命名空间在上面的条件中被“包含”,例如Extension:Semantic MediaWiki Extension:Semantic Forms
确保为扩展设置了所需的权限!
虽然此安装过程对于大多数扩展来说已足够,但某些扩展需要不同的安装过程 检查您的扩展文档以获取详情。
如果要在LocalSettings.php中更改配置变量,则必须在包含扩展名的之后执行此操作。 否则,分机中定义的默认值将覆盖您的设置。


升级扩展

当你升级你的MediaWiki时,部分扩展插件也需要升级,而其他部分扩展插件则可能支持向上兼容。 升级某个扩展插件到新版本:

  1. 下载新版本扩展插件
  2. 替换extension/ExtensionName目录下所有文件为新版本的文件。 不要删除LocalSettings.php中存在的扩展插件的配置。
  3. 根据不同的扩展插件,你可能需要运行Update.php维护脚本。 多数扩展插件会提及是否需要运行这个脚本 (Perform backup of your data before executing the script). 如果你没有使用命令行的权限,你也可以使用网络更新
這手冊包含超過99%的拓展 如果該拓展有與你不同的標準,請跟隨該標準。

卸载一个扩展

Remove the line from LocalSettings.php with the extension name to uninstall it:

wfLoadExtension( 'ExtensionName' );
  • You must remove any lines pertaining to the configuration of the extension.
  • If the extension provides any database changes, you must run update.php to remove them.

参见

扩展 : 分类 所有 申请手册:标签扩展 扩展FAQ 扩展钩子注册扩展默认名字空间