Руководство:Метки

Метки правок или метки версий — это аннотации, связанные с версией или записью в журнале. Они отображаются в разных местах при обращении к версиям, например, в истории страниц, различиях, свежих правках и других местах.

Полный список всех доступных меток отображается на Special:Tags. Users with the managechangetags user right – administrators by default – can use this special page to create and delete tags. (See Help:Tags .)

Extensions (for example AbuseFilter and VisualEditor ) mark edits made through their interface with tags.

Названия меток

Если вы планируете жёстко закодировать метки в своём расширении, выберите несколько уникальное название, чтобы избежать конфликтов. Например, визуальный редактор использует visualeditor, visualeditor-needcheck, visualeditor-switched. Названия меток не могут содержать символы , или /.

If your extension allows users to enter their own tag names, you can use the ChangeTags::canCreateTag( $tag ) function to validate those names. (There is no need to pass the optional $user parameter for this purpose.) Эта функция будет отклонять недопустимые названия меток, а также названия меток, которые уже зарезервированы другим расширением или пользователями на вики.

Обязательно зарегистрируйте все метки, которые использует ваше расширение (жёстко закодированные или предоставленные пользователем), внедрив хук ListDefinedTags . Если метка активно используется (т. е., не отключен), вы также должны перечислить её через хук ChangeTagsListActive .

Если вы хотите запретить пользователям создавать определённые метки, вы можете реализовать хук ChangeTagCanCreate . For example, the OAuth extension uses this hook to reserve all tags beginning with OAuth CID:. (See source.)

Использование меток из расширений

Все метки, используемые хотя бы в одной версии, и любые метки, перечисленные в хуке ListDefinedTags , показаны на Special:Tags.

Каждая метка известна под кодовым названием, которое действует как её уникальный идентификатор. Это кодовое название отображается на Special:Tags. С каждой меткой связаны два сообщения:

• MediaWiki:tag-$name can be used to set the "display name" or "friendly name" of the tag. If set, this message will be used on history pages etc. instead of the tag's code name.
• MediaWiki:tag-$name-description provides a description to be displayed on Special:Tags.

To add a tag to a revision, recent changes entry, or log entry, use ChangeTags::addTag(). The RecentChange_save hook can be useful for this purpose.

Расширение Special:Tags

By default, tags defined by extensions cannot be manipulated from Special:Tags at all. All tag management tasks are left up to the extension.

If you wish, you can allow users to delete a tag defined by your extension from the regular Special:Tags interface. To do this, you must implement the ChangeTagCanDelete hook to mark the tag as deletable, then implement the ChangeTagAfterDelete hook to perform extension-specific cleanup actions after MediaWiki has removed the tag from all revisions and log entries to which it is applied.

Список основных меток правок

Версия MediaWiki:

1.40

• mw-contentmodelchange: changing the content model
• mw-new-redirect, mw-removed-redirect, mw-changed-redirect-target: turning a page into a redirect / a redirect into a normal page / changing where a redirect goes
• mw-blank: blanking the page
• mw-replace: changing more than 90% of the page text
• mw-rollback, mw-undo, mw-manual-revert: various kinds of reverts
• mw-reverted: edit that got reverted
• mw-server-side-upload: file uploaded using maintenance script

См. также

• Documentation about Wikipedia tags
• Extensions that define tags
• Database tables: change_tag, valid_tag (removed), tag_summary (removed)
• Magic word #tag (unrelated to the feature described on this page)

Предложения:

• Revision tagging use cases like editing channels, see etherpad:p/RevisionTags
• On Phabricator