Improving documentation for PaginatorHelper::sort() Fixes #210

This commit is contained in:
mark_story 2009-10-27 13:28:43 -04:00
parent 5a093e5627
commit 00d7c655ce

View file

@ -207,10 +207,12 @@ class PaginatorHelper extends AppHelper {
return $this->__pagingLink('Next', $title, $options, $disabledTitle, $disabledOptions);
}
/**
* Generates a sorting link
* Generates a sorting link. Sets named parameters for the sort and direction. Handles
* direction switching automatically.
*
* @param string $title Title for the link.
* @param string $key The name of the key that the recordset should be sorted.
* @param string $key The name of the key that the recordset should be sorted. If $key is null
* $title will be used for the key, and a title will be generated by inflection.
* @param array $options Options for sorting link. See #options for list of keys.
* @return string A link sorting default by 'asc'. If the resultset is sorted 'asc' by the specified
* key the returned link will sort by 'desc'.