Функцию AddEventHandler() лучше писать в файл local/php_interface/init.php или если этого файла нет, то в bitrix/php_interface/init.php . Файл init.php подключается всегда, поэтому обработчик будет точно добавлен.
Помимо функции AddEventHandler() в старом ядре есть метод addEventHandler() у объекта \Bitrix\Main\EventManager в новом ядре, пример его использования:
<?php
$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler("main", "OnEpilog", "myOnEpilog");В статье приводится пример кода для получения ID текущего покупателя в bitrix.
В статье приводится пример регистрации собственного события в bitrix и добавления на него обработчика.
Так как bitrix состоит из большого количества различных модулей, знать как их правильно подключать просто необходимо.
Статья о том как разместить свои настройки не создавая велосипеды и костыли, а используя возможности системы.
В статье приводится пример кода подключения bitrix без подключения шаблона сайта. Так же описано когда это может пригодится.
В статье приводится пример кода для получения директории в которой находится файл компонента.