Я понимаю, что этот ответ не поможет вам ... через шесть месяцев, но в любом случае, на всякий случай, если это поможет кому-то еще: я согласен, документы по API не очень полезны, если вы еще не знаете, как это сделать Zencart, они больше справочные.
У вас есть несколько руководств в Zencart wiki . Ни один из них не является полным решением для того, что вам нужно, но из этих мест вы можете многому научиться (по крайней мере, я это сделал).
С другой стороны, мой совет - использовать код из других шаблонов и особенно из шаблона по умолчанию Zencart и файлов header.php в / modules / pages. Но даже дальше, я бы попытался использовать функциональность Zencart без предварительного редактирования какого-либо файла.
Например, если вам нужно перечислить все категории и их миниатюры, у вас уже есть эта функциональность. Если вы вызываете index.php с cPath категории, вы получите этот список, зачем вам все это делать с нуля?
Если вам действительно нужно включить листинг в другом месте, я бы начал с просмотра «tpl_tabular_display.php» и «tpl_columnar_display.php» в папке / common шаблона по умолчанию. Они выполняют всю работу по выводу списков товаров и категорий соответственно. И в большинстве случаев вызовы SQL выполняются в файлах header.php внутри / includes / modules / pages или в файлах / includes / modules.