Данный объект хранит в себе разные свойства дерева меню (при этом не изменяет само дерево), такие, как какие элементы являются выделенными, какие переменные переданы и д.р. Экземпляр дерева, умеет отобразить на экране конечный пункт меню.

Экземпляр объекта возвращается всегда. Когда мы хотим получить какой-то кусок дерева. Например, при получении текущего меню, при помощи команды:

\Eva\menuTreeManipulator::getByDepth

Принимает целочисленное значение, отвечающее за уровень погружения в меню.

Вернет evaMenuItemsIterator.

\Eva\menuTreeManipulator::renderAll()

Вернет текстовую строку, в которой будет сгенерированный HTML.

В большинстве случаев генерация идет по следующему алгоритму:

Генерация контентной части
Генерация шапки
Генерация футера

Если контентной части нет (в случае с обработчиками), текущего пункта меню нет (и нет обработчика у последнего пункта), то будет сгенерирована 404-ая ошибка. Сгенерированный HTML берется из пути: /system:404/.

Если к пункту меню нет доступа, то будет сгенерирована 403-я ошибка. Сгенерированный HTML берется из /system:403/.

Если системных путей не будет найдено, то вернется пустая строка.

В большинстве случаев, данный метод не понадобится при разработке сайтов.