Функция generatePageLink()

Функция генерирует ссылку на конкретную страницу при постраничном отображении.
Вызов функции: 
function generatePageLink($paginationParams, $page) { ; }
Набор параметров: 
// $page		- номер страницы, для которой будет генерироваться ссылка
// $paginationParams	- массив с параметрами, необходимыми для генерации URL'ов страниц [соответствуют параметрам функции generatePluginLink(), generateLink()]
// * 'pluginName'	- ID плагина
// * 'pluginHandler'	- наименование обработчика
// * 'params'		- "основные параметры" (см. параметр $params функций generatePluginLink(), generateLink())
// * 'xparams'		- "дополнительные параметры" (см. параметр $xparams функций generatePluginLink(), generateLink())
// * 'paginator'	- массив с параметрами, позволяющий идентифицировать наименование переменной, в которой прописывается номер страниц
// * * '0'			- название переменной с номером страницы
// * * '1'			- местоположение переменной с номером страницы (0 - в основных параметрах, 1 - в дополнительных параметрах)
// * * '2'			- флаг: "заполнять переменную с номером страницы для первой страницы" (0 - нет, 1 - да)
Пример использования функции: 
$myLink = generatePageLink(
	array(
		'pluginName' => 'news'				// - плагин 'news'
		'pluginHandler' => 'by.year'),			// - обработчик 'by.year'
		'params' => array(				// - [основные параметры]
			'year' => 2010,				// - год = 2010
			'page' => 3),				// - страница = 3
		'xparams' => array(				// - [дополнительные параметры]
			'referer' => 'ivan'),			// - referer = 'ivan' (в реальности такой переменной не существует)
		'paginator' => array(				// - [идентификация переменной постраничной навигации]
			'page',					// - переменная 'page'
			0,					// - переменная находится в основных параметрах
			0)					// - на первой странице переменную page не отображать
	)	
	3,							// - генерируем ссылку для страницы #3
);

print "Generated link for page 3 is: ".$myLink;			// Выводится текст "Generated link for page 3 is: <тут ссылка на страницу плагина news>"