Manual:Tags/cs

Značky změn nebo značky revizí jsou anotace spojené s revizí nebo záznamem v protokolu. Zobrazují se na různých místech při odkazování na revize, například v historii stránky, v rozdílech, v posledních změnách a jinde.

Úplný seznam všech dostupných tagů je zobrazen na Special:Tags. Uživatelé s oprávněním managechangetags Uživatelská práva – ve výchozím nastavení administrátoři – mohou tuto speciální stránku použít k vytváření a mazání značek. (Podívejte se na stránku Nápověda:Tagy (značky).)

Rozšíření (například AbuseFilter a VisualEditor) označují úpravy provedené prostřednictvím jejich rozhraní pomocí tagů.

Názvy stránek

Pokud plánujete do rozšíření pevně naprogramovat tagy, zvolte poněkud unikátní název, abyste předešli konfliktům. Například VisualEditor používá visualeditor, visualeditor-needcheck, visualeditor-switched. Názvy tagů nesmí obsahovat znaky , nebo /.

Pokud vaše rozšíření umožňuje uživatelům zadávat vlastní názvy tagů, můžete k ověření těchto názvů použít funkci ChangeTags::canCreateTag( $tag ). (Pro tento účel není nutné předávat volitelný parametr $authority.) Tato funkce odmítne neplatné názvy tagů a také názvy tagů, které jsou již rezervovány jiným rozšířením nebo uživateli na wiki.

Ujistěte se, že jste zaregistrovali všechny tagy, které vaše rozšíření používá (ať už pevně kódované nebo zadané uživatelem), implementací háčku ListDefinedTags. Pokud je tag aktivně používán (tj. není zakázán), měli byste ho také uvést pomocí háčku ChangeTagsListActive.

Pokud chcete uživatelům zabránit ve vytváření určitých tagů, můžete implementovat háček ChangeTagCanCreate. Například rozšíření OAuth používá tento háček k rezervaci všech tagů začínajících na OAuth CID:. (Viz zdroj.)

Používání tagů z rozšíření

Všechny tagy použité alespoň v jedné revizi a všechny tagy uvedené v háčku ListDefinedTags jsou zobrazeny na Special:Tags.

Každá značka je známá pod kódovým názvem, který slouží jako její jedinečný identifikátor. Toto kódové jméno se zobrazuje na Special:Tags. Ke každé značce jsou přiřazeny dvě zprávy:

  • Hodnotu MediaWiki:tag-$name lze použít k nastavení "zobrazovaného názvu" nebo "přátelského názvu" tagu. Pokud je nastavena, bude se tato zpráva používat na stránkách historie atd. místo kódového názvu tagu.
  • MediaWiki:tag-$name-description poskytuje popis, který se zobrazí na Special:Tags.

Chcete-li přidat tag k revizi, záznamu o posledních změnách nebo záznamu v protokolu, použijte ChangeTags::addTag(). Pro tento účel může být užitečný háček RecentChange_save.

Rozšíření Special:Tags

Ve výchozím nastavení nelze tagy definované rozšířeními z hodnoty Special:Tags vůbec manipulovat. Veškeré úkoly správy tagů jsou ponechány na rozšíření.

Pokud chcete, můžete uživatelům povolit smazat značku definovanou vaším rozšířením z běžného rozhraní Special:Tags. Abyste to mohli provést, musíte implementovat háček ChangeTagCanDelete, který označí tag jako smazatelný, a poté implementovat háček ChangeTagAfterDelete, který provede akce čištění specifické pro dané rozšíření poté, co MediaWiki odstraní tag ze všech revizí a položek protokolu, na které je použit.

Seznam tagů změn jádra

Verze MediaWiki:
1.40
  • mw-contentmodelchange – změna Content model
  • mw-new-redirect, mw-removed-redirect, mw-changed-redirect-target – převedení stránky na přesměrování / přesměrování na normální stránku / změna směru přesměrování
  • mw-blank – prázdná stránka
  • mw-replace – změna více než 90 % textu stránky
  • mw-rollback, mw-undo, mw-manual-revert – různé druhy revertů
  • mw-reverted – úprava, která byla vrácena zpět
  • mw-server-side-upload – soubor nahraný pomocí údržbového skriptu


Související odkazy

Návrhy:

Category:Documentation/cs
Category:Documentation/cs