Как получить текущую категорию товара?

Я вот натолкнулся на отсутствие элементарной функции для объекта товара. Есть у Вас и GetCost(), есть и getShortDescription(), есть и inDir(). А где же GetCurentDir()?????

Возникает вопрос -  как ее получить?
Все эти костыли в виде $pathids - это конечно не очень понятно, разбирать массив и получать оттуда последнюю категорию ???
Может в ядро добавить функцию получения текущей категории? вам спасибо скажут многие люди ....

Ну и вопрос не снимаю - как получить текущую категорию объекта-товара ?
Сделал бы сам, да документация  https://readyscript.ru/dev-manual/dev_behaviors.html не очень подробная. Был бы признателен за обхяснение как этот сделать? как использовать модули для того чтобы добавить новую функцию к классу товара ?? Все вроде написано ... а куда это все добавлять ?? куда писать этот код.. К какому событию ? Если бы была более подробная инструкция ... С примерами. Порог входа очень высок, вот и страдает хорошая система, дальше верстки шаблонов  особо не пойдешь... Если ты конечно не альтруист... и не готов потратить оооочень много времени на штудирование документации и копание в коде.....