Manual:Hooks/ListDefinedTags/cs

From Linux Web Expert

ListDefinedTags
<translate> Available from <tvar name=1><translate> version <tvar </tvar></translate>
Může být použit rozšířeními k registraci změn značek (tagů).
<translate> Define function:</translate>
public static function onListDefinedTags( &$tags ) { ... }
<translate> Attach hook:</translate> <translate> In <tvar name=1>extension.json</tvar>:</translate>
{
	"Hooks": {
		"ListDefinedTags": "MediaWiki\\Extension\\MyExtension\\Hooks::onListDefinedTags"
	}
}
<translate> Called from:</translate> <translate> File(s):</translate> ChangeTags.php
<translate> Interface:</translate> ListDefinedTagsHook.php

<translate> For more information about attaching hooks, see <tvar name=1>Příručka:Háčky </tvar>.</translate>
<translate> For examples of extensions using this hook, see <tvar name=cat>Category:ListDefinedTags extensions/cs</tvar>.</translate>

Podrobnosti

  • &$tags: Seznam značek. Přidejte do tohoto pole značky svého rozšíření.

Poznámky

Pokud tento háček neimplementujete, značky používané vaším rozšířením se na Special:Tags zobrazí jako "již se nepoužívají" (no longer in use) a administrátoři je budou moci smazat.

Vždy byste měli také implementovat háček ChangeTagsListActive. Pokud jsou všechny definované tagy aktivní, lze pro oba použít stejný handler (viz příklad níže).

Příklad

Toto pomyslné rozšíření registruje dva tagy, které jsou oba aktivní. Jeden se používá k označení automatických úprav, zatímco druhý se používá k označení úprav vyžadujících pozornost.

V extension.json:

{
	"Hooks": {
		"ListDefinedTags": "MediaWiki\Extension\MyExtension\Hooks::onRegisterTags",
		"ChangeTagsListActive": "MediaWiki\Extension\MyExtension\Hooks::onRegisterTags"
	}
}

V extensions/MyExtension/includes/Hooks.php:

namespace MediaWiki\Extension\MyExtension;
class MyExtensionHooks {
    public static function onRegisterTags( array &$tags ) {
        $tags[] = 'my-extension-automated-edit';
        $tags[] = 'my-extension-attention-required';
        return true;
    }
}

Související stránky