nc_folder_path()
nc_folder_url()
nc_infoblock_path()
nc_infoblock_url()
nc_object_path()
nc_object_url()
Функции для получения ссылок на объекты системы являются универсальными — работают как при включенном модуле маршрутизации, так и при использовании стандартных путей к ресурсам.
При использовании модуля маршрутизации функции могут вернуть false
при явной невозможности определить путь к ресурсу (в случае передачи функции некорректных аргументов), или объект класса nc_routing_path
, который может быть использован как обычная строка (объект имеет метод __toString()
). Промежуточный объект создаётся с целью оптимизации (в некоторых частях системы — например, в списке объектов — могут создаваться переменные, содержащие пути, но фактически они могут не использоваться в шаблонах; вычисление пути происходит только при первом приведении значения такой переменной к строке).
Если модуль маршрутизации отключен, функции получения адресов возвращают false
в случае невозможности формирования пути, или строку с адресом.
Каждая из функций для получения пути на сайте — nc_folder_path
, nc_infoblock_path
, nc_object_path
— имеет аналогичную функцию для получения пути с именем домена (nc_folder_url
, nc_infoblock_url
, nc_object_url
). Пути с указанием имени домена начинаются с «//» — это так называемые protocol-relative URL (запрос будет осуществлён по тому же протоколу, http или https, который использовался для получения на страницы, содержащей ссылку).