Группировка документов по букве

GroupByLetter.php

<?php
/* Пример вызова:
[!GroupByLetter?
&parents=`24`
&depth=`3`
&showParent=`0`
&tpl=`@CODE:<a href="[+url+]">[+pagetitle+]</a><br>`
&wrapTpl=`@CODE:<h1>[+letter+]</h1>[+wrap+]`
&ownerTPL=`@CODE:[+dl.wrap+]`
!]
*/
$tpl = isset($tpl) ? $tpl : '';
$field = isset($field) ? $field : 'pagetitle'; //откуда брать буквы
$wrapTpl = isset($wrapTpl) ? $wrapTpl : '@CODE:[+letter+] [+wrap+]'; //вывод одной буквы
$ownerTPL = isset($ownerTPL) ? $ownerTPL : '@CODE:[+dl.wrap+]'; //вывод всего
$params['saveDLObject'] = '_DL';
$params['tpl'] = '';
$data = array();
$out = '';

$modx->runSnippet('DocLister', $params);

$DLTemplate = DLTemplate::getInstance($modx);
$DL = $modx->getPlaceholder('_DL');
foreach ($DL->docsCollection() as $doc) {
	if (isset($doc[$field])) {
		//тут добавляем дополнительные всякие данные, если нужно
		$doc['url'] = $modx->makeUrl($doc['id']);
		
		$letter = mb_strtoupper(mb_substr($doc[$field],0,1));
		$data[$letter][] = $doc;
	}
}

if (!empty($data)) {
	ksort($data);
	foreach ($data as $letter => $docs) {
		$wrap = '';
		foreach ($docs as $doc) {
			$wrap .= $DLTemplate->parseChunk($tpl, $doc);
		}
		$out .= $DLTemplate->parseChunk($wrapTpl, array('letter' => $letter, 'wrap' => $wrap));
	}
	$out = $DLTemplate->parseChunk($ownerTPL, array('dl.wrap' => $out));
}

return $out;