Albireo CMS 2025.01.17

Функция hIMG() Albireo CMS

Константа в «@XXX@» где XXX заранее определённая php-константа
hIMG('@UPLOADS_URL@pages/file.jpg', ['width'=>'200', 'height'=>'100', 'alt'=>'text', 'title'=>'text', 'test']);
эквивалентно:
hIMG(UPLOADS_URL . 'pages/file.jpg', ['width'=>'200', 'height'=>'100', 'alt'=>'text', 'title'=>'text', 'test']);

    <img src="...../pages/file.jpg" width="200" height="100" alt="text" title="text" test="test">


Если адрес начинается с «//», то это UPLOADS_URL
     hIMG('//pages/file.jpg', ...);
  это тоже самое, что и:
     hIMG('@UPLOADS_URL@pages/file.jpg', ...);


-------------------------
Использование данных страницы («xxx» - произвольное поле):
images-dir: [UPLOADS_URL]pages/

где «images-dir» - произвольное поле в «[xxx]»:
hIMG('[images-dir]file.jpg', ['width'=>'200', 'height'=>'100', 'alt'=>'text', 'title'=>'text']);

    <img src="данные-images-dir/pages/file.jpg" width="200" height="100" alt="text" title="text" test="test">

hIMG('[images-dir]file.jpg', ['alt/title'=>'text']);

-------------------------
Сокращения: w->width, h->height, символ «/» разделяет ключи:
hIMG('file.jpg', ['w'=>'200', 'h'=>'100', 'alt/title'=>'text']);

    <img src="file.jpg" width="200" height="100" alt="text" title="text">

-------------------------
Ключ «auto» — получить реальные размеры изображения из файла
hIMG('file.jpg', ['auto', 'alt/title'=>'text']);

    <img src="file.jpg" width="854" height="346" alt="text" title="text">


/**
 * Хелпер для формирования <IMG>
 * @param string $src — путь к изображению
 * @param array $attr— прочие параметры
 * @param $link — нужно ли обрамлять IMG ссылкой
 * @param $linkClass — css-класс этой ссылки
 * @param $linkAdd — прочие атрибуты ссылки
 * @return string
 */
function hIMG(string $src, array $attr = [], $link = null, $linkClass = '', $linkAdd = '')