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 aktuálního uživatele (vice o jeho použití se dozvíte se souboru $IP/includes/Title.php)

$action
action (string) concerning the title in question

$result

 * reference na objekt result se postupně předává všem funkcí navěšeným na tenhle háček (viz $IP/includes/Hooks.php)
 * $result can be left untouched, or set to  or , according to the opinion of the particular hook function
 * 'true' znamená, že je uživateli povoleno pokračovat dál a 'false' znamená že $user je pro $action neaktivní v případě aktuálního objektu $title.
 * pokud funkce nevrátí žádnou hodnotu, pak to znamená, že za dané situace nedělá nic.

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

 * na funkci, kterou volá tento háček lze navěsit další funkce, které se budou zpracovávat podle toho v jakém pořadí se zavolají; funkce navěšené na háček, se postupně zpracovávají podle toho, v jakém pořadí jsou na něm navěšeny, dokud se nedojde na konec seznamu, nebo se některý z háčků nevrátí
 * kterákoliv z funkcí, navěšených na tento háček, přeruší další proces zpracování, pokud vrátí.

intentional side effect of the chain of hook function

 * $result given by reference to each hook function contains the resulting opinion of the hook functions processed so far
 * to be the first in the list of hooks has the disadvantage, that later hook functions have the opportunity to change the $result
 * 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