Тест вложенности ресурса в контейнер [с блекджеком и плюхами]

Проверить, есть ли контейнер в списке родителей ресурса, можно разными способами:

• Можно сделать это используя карту ресурсов, которую MODX создаёт для каждого контекста после обновления кеша. Для этого необходимо воспользоваться методом $modx->getParentIds. Таким образом нагрузка и время затрачиваемое на проверку будет минимальным.
  
  
• Не заморачиваться и сделать всё исключительно на Fenom, без модификаторов. Тут мы тоже можем воспользоваться методом $_modx->getParentIds, который Василий услужливо вынес в список доступных в Fenom.
  
  
• Можно даже извратиться до того, что на каждую такую проверку получать объект через getObject('modResource') + получать объекты его родителей через getOne('Parent'). К слову, что будет в случае, если нам, к примеру, надо проверить 50 товаров на странице на вложенность в определённую категорию?
  Ради интереса, я воспроизвёл подобную ситуацию на тестовом сайте Modhost:
  
  1. Без каких-либо проверок 50 товаров в списке категории выводятся за 0,0282 сек.
  2. С подобной проверкой, за 0.1304 сек.
  3. С проверкой, которую мы рассматриваем в этом посте, за 0.0307 сек.
  
  А потом заказчики сходят с ума, почему их сайт так долго открывается...

Поймите меня правильно

Дело даже не столько в единичном сниппете, сколько в самом подходе к разработке. Если для исполнителя нет ничего страшного в подобном сниппете, который прибавляет 0.1 секунду ко времени загрузки страницы при определённых условиях, то заказчику потом приходится тратить в двое больше на оптимизацию сайта или жить с тем, что есть.

Преимущества данного решения

В чём же преимущества данного решения в отличие, к примеру, от этого:

1. Скорость работы и низкая нагрузка на сервер,
2. Возможность передавать опции, вроде ключа контекста,
3. Возможность указать уровень вложенности проверки,
4. Основной параметр проверки (id контейнера) не вшит в сниппет, а указывается извне.

Сниппет-модификатор проверки вложенности ресурса в контейнер

Каким же должен быть правильный сниппет-модификатор проверки вложенности ресурса в контейнер:

// Parent
$parent = ($options['parent'] ?: null);
unset($options['parent']);

if (empty($input) || empty($parent)) {
    return null;
}

// Height
$height = ($options['height'] ?: 10);
unset($options['height']);

// Alt keys
foreach (array(
    'context_key' => 'context',
    'ctx' => 'context',
) as $k => $v) {
    if (isset($options[$k])) {
        $options[$v] = $options[$k];
    }
}

if (!$parents = $modx->getParentIds($input, $height, $options)) {
    return null;
}

return in_array($parent, $parents) ?: null;

Создаём сниппет inParent с этим кодом.

Пример использования

Использовать его до безобразия просто:

{if ($_modx->resource['id'] | inParent : [
    'parent' => 2,
    'height' => 3,
    'ctx' => 'web',
])?}
    Родитель с id 2 найден на 3 уровня вверх в контексте web.
{else}
    Не найден.
{/if}

P.S.: За то, что так скрупулёзно отношусь к нагрузке на сервер и скорости работы скрипта, спасибо Михаилу Воеводскому, что ткнул носом однажды. =)

if(!$level_1){
                	$parentID = @$modx->resource->get('parent');
    				$document = @$modx->getObject('modResource',array(
        				'id' => $parentID,
    				));
                	$parentID = @$document->get('parent');
        			$document = @$modx->getObject('modResource',array(
            			'id' => $parentID,
        			));
        			$parentID = @$document->get('parent');
        			$document_parent = @$modx->getObject('modResource',array(
            			'id' => $parentID,
        			));
        			$level_1="";
        			if($document_parent) {
            			$level_1 = $document_parent->get('pagetitle');
            			$level_1= mb_strtolower($level_1, 'UTF-8');
        			};
                };

if (!$parents = $modx->getParentIds($input, $height, $options)) {
    $parents = array();
}