Manual:タグ
This page contains technical documentation relating to change tags; its content is aimed at MediaWiki extension developers. For help and documentation aimed at users and administrators, please see タグ . |
変更タグまたは版タグは、版や記録項目に関連付けられた注釈です。 これらは、版に言及する際に、ページ履歴、差分表示、最近の更新など、さまざまな場所で表示されます。
利用できるタグの完全な一覧は Special:Tags に表示されます。
Users with the managechangetags
利用者権限 – administrators by default – can use this special page to create and delete tags.
(See Help:タグ .)
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.)
拡張機能からのタグの使用
少なくとも 1 つの版で使用されるすべてのタグと、ListDefinedTags フックに列挙されているタグは、Special:Tags で表示されます。
各タグにはコード名があり、それがそのユニークな識別子として機能します。 このコード名は Special:Tags に表示されます。 2 つのメッセージは各タグに関連付けられます:
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
— Content model の変更mw-new-redirect
,mw-removed-redirect
,mw-changed-redirect-target
— ページのリダイレクト化 / リダイレクトを通常のページに変更 / リダイレクト先の変更mw-blank
— ページの白紙化mw-replace
— ページテキストの90%以上を変更mw-rollback
,mw-undo
,mw-manual-revert
— 各種差し戻しmw-reverted
— 差し戻された編集mw-server-side-upload
— メンテナンススクリプトを使用してアップロードされたファイル
関連項目
- 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