В контроллерах и моделях через свойство progroman_city_manager доступен объект класса \progroman\CityManager\CityManager:
$this->progroman_citymanager->getCountryId();
Объект можно получить также из Registry
$progroman_citymanager = $registry->get('progroman_citymanager');
В шаблонах tpl
<?= $progroman_citymanager->getCityName(); ?>
В шаблонах twig
{{ progroman_citymanager.getCityName() }}
Методы объекта:
getCountryId() // ID страны в Opencart
getCountryName() // название страны
getZoneId() // ID региона в Opencart
getZoneName() // название региона
getDistrictName() // название района области, если есть, например: "Одинцовский"
getPostcode() // почтовый индекс
getFullCityName() // название города с районом, если есть, например: "Одинцовский р-н, г. Одинцово"
getCityName() // название города
getPrefixCityName() // тип населенного пункта (г, д, пос и т.д.)
getFiasCountryId() // ID страны в таблице fias (в базе модуля)
getFiasZoneId() // ID региона в таблице fias (в базе модуля)
getFiasId() // ID населенного пункта в таблице fias (в базе модуля)
getCountryName(), getZoneName(), getDistrictName(), getFullCityName(), getCityName() могут возвращать значения в родительном или предложном падеже, для этого нужно первым параметром указать 'gc' или 'pc'
Если вторым параметром передать true, к названию добавится тип населенного пункта.
$this->progroman_citymanager->getCountryName(); // Россия
$this->progroman_citymanager->getCountryName('gc'); // России
$this->progroman_citymanager->getCountryName('pc'); // России
$this->progroman_citymanager->getZoneName(); // Московская
$this->progroman_citymanager->getZoneName('', true); // Московская обл.
$this->progroman_citymanager->getZoneName('gc', true); // Московской обл.
$this->progroman_citymanager->getCityName(); // Воронеж
$this->progroman_citymanager->getCityName('gc'); // Воронежа
$this->progroman_citymanager->getCityName('pc'); // Воронеже
$this->progroman_citymanager->getCityName('', true); // г. Воронеж