Manual:Hooks/userCan/cs

$title
reference na objekt title se kterým se pracuje v dotazu (více o tomhle objektu viz $IP/includes/Title.php)

$user
reference na objekt user, ve kterém je vše co se týče aktuálního uživatele (více o tomhle objektu viz $IP/includes/Title.php)

$action
action je řetězec (string), který identifikuje aktuální akci, která se v danou chvíli na základě dotazu aplikuje na objekt title

$result

 * reference na result se postupně předává všem funkcím, ve stejném pořadí, jak jsou navěšené na tenhle háček (viz $IP/includes/Hooks.php)
 * $result můžete nechat na pokoji, nebo ho nastavit na  nebo , podle toho jaký bude výsledek vaší funkce navěšené na háček
 * 'true' znamená, že uživatel může pokračovat dál ve zpracování obsahu stránky a 'false', že uživatel $user akci předanou přes $action na objekt $title aplikovat nemůže.
 * pokud funkce nevrátí žádnou hodnotu, pak to znamená, že za dané situace zůstává její postoj neutrální.

co způsobí návratová hodnota funkce, navěšené na tento háček

 * funkce, které jsou navěšené na tento háček zpracovávají, v tom pořadí jak jsou na něj navěšeny, dokud se nedojde na konec seznamu, nebo dokud některá z nich nevrátí
 * kterákoliv z funkcí, navěšených na tento háček, další proces zpracování přeruší, tím že vrátí.

záměrný postranní efekt zřetězení funkcí na tomto háčku

 * obsah proměnné $result, která je předaná navěšeným funkcím přes referenci, se průběžně mění, podle toho, jaký je výsledek zpracování funkce
 * i když ji některá ze seznamu funkcí navěšených na háčku vypne, tak jiná, co za ní bude následovat, může dojít k jinému závěru a $result opět povolí
 * to be the last in the list of hooks has the disadvantage, that the processing of the hooks will simply not reach that point, hence less chance to have an impact on the $result

The final decision concerning the $title - $user - $action triple is the value can be found in $result, when the processing of the list of hooks is finished.

Viz též

 * for hooking into non-title-specific permission checks
 * for a similar hook that can also return a message
 * for a similar hook that can also return a message