Как ссылаться на статичные файлы

Файлы, как данные, закачиваются на сайт через окно редактирования. Это самый простой и предпочтительный для пользователя системы сайтом способ вставки файлов в страничку. При этом файл может быть автоматически подвергнут преобразованиям размера, формата и имени и помещен в папку ./dataFiles. В эту папку желательно ничего вручную не закачивать.

Как ссылаться из файлов .tpl (из шаблонов)

Второй (ручной) способ вставки файлов в страничку рассматривается в статье "Вставка нештатных изображений", когда файлы закачиваются в папку доп. файлов: ./xFiles, и в шаблоне делается запись вида:

<img src="xFiles/photo.jpg">

Файлы оформления сайта (логотип, фон и т.п.) можно использовать аналогичным образом. При этом, для того чтобы придерживаться принципа разделения данных и оформления, файлы оформления лучше закачивать не в папку ./xFiles, а в папку ./templates. В этом случае, в коде шаблона нужно сделать запись следующего вида:

<img src="templates/logo.gif">

Если бы мы разрабатывали статичный сайт, то имя папки в этом коде не нужно было бы указывать, так как и шаблон, и картинка находятся в одной папке. Но в Blox CMS, путь к файлу нужно указывать именно из корневой папки сайта, так как шаблоны не открываются самостоятельно, а подключаются из главного файла index.php, находящегося в корневом каталоге.

Если вы хотите, чтобы на одном комплекте шаблонов в дальнейшем смогли работать несколько сайтов (например, версии сайта на других языках), то в шаблонах лучше вместо имени папки (templates) использовать глобальную переменную $GLOBALS['templatesUrl']:

<img src='{$GLOBALS['templatesUrl']}/logo.gif'> (PHP-шаблон)
<img src='{$smarty.globals.templatesUrl}/logo.gif'> (Smarty-шаблон)

Можно пойти еще дальше, и для того, чтобы не путаться между файлами шаблонов и файлами изображений, поместить последние в подпапку, например images. Тогда код для изображений будет следующим: <img src='{$GLOBALS['templatesUrl']}/images/logo.gif'>

Как ссылаться из файлов .css и .js

.bg {background: url(aaa.gif)}

Соответственно, если стилевые изображения находятся не в папке templates, а в подпапке, например images, то стиль должен задаваться так: .bg {background: url(images/aaa.gif)}