Картинки

Картинки в системе CuteSITE один из самых часто используемых объектов. Система обладает всеми нужными средствами для работы с картинками.

В первую очередь усвойте, что вы не можете:

• скопировать текст с картинками из Word, нажать Ctrl-V в WISIWIG редакторе и тем самым вставить картинку в текст
• загрузить картинку в систему управления находясь в том же WISIWIG редакторе
• загрузить картинку вручную в папку на сервере с помощью FTP клиента и тем самым подключить ее к системе

(и вообще постарайтесь забыть что такое FTP при работе с CuteSITE)

Это картинка в web-формате (GIF, JPG, PNG) загруженная в определенную папку в структуре сайта. CuteSITE складывает все загруженные картинки в свое хранилище в папке /images на сервере, предварительно задав им уникальные имена. Вручную ковыряться в этом хранилище не стОит, все испортите.

Для этого в CuteSITE API существуют две функции:

image(string name[, int width[, int height[, string template[, string params]]]])

и

image_src(string name[, int width[, int height[, string template[, string params]]]])

Параметры у обеих функций одинаковые. Первая image(), результатом ее работы будет HTML код для отображения картинки на сайте, результатом работы image_src() будет просто абсолютный путь к картинке (src).

Вызов <?= image(”Picture”) ?> означает: “сгенерировать html код который мне покажет картинку по имени Picture которую я загрузил в текущую папку если ее там нет, то попробовать найти ее в корне сайта”. Вызов <?= image(”/images/Picture”) ?> означает: “отобразить HTML код для картинки Picture которая находится в папке /images в структуре сайта (не в папке на сервере!), если ее там нет, то возникнет ошибка”.

Обязательный параметр name это имя картинки либо абсолютный путь к ней в структуре сайта (никоим образом не в файловой системе).

Забегая вперед скажу что вместо обязательного параметра name в функцию image() или image_src() можно подставить сам объект картинки и именно этот объект и будет отображен в результатах работы этих функций, т.е. не будет производится поиск картинки.

Не обязательные int width, int height - если вы их укажете, то размеры картинки установятся те которые вы указали, а не исходные для этой картинки, таким образом можно вручную изменять размер картинок.

Параметр string template это имя шаблона в контекст которого вы подставите эту картинку. Если вы укажете имя шаблона то произойдет следующее: будет произмеден поиск шаблона, он может находится в текущей папке или в корне сайта, он будет вызван на выполнение и переменная $that в этом шаблоне будет являться ссылкой на объект этой вашей картинки. Разберем следующий пример:

В корне сайта создадим шаблон по имени BorderedImage, его содержимое:

<TABLE cellpadding="1" cellspacing="0" border="0">
<TR>
<TD bgcolor="black"><IMG src="<?= $that->src ?>" width="<?= $that->width ?>" height="<?= $that->height ?>" border="0"></TD>
</TD>
<TABLE>

Теперь, если в каком либо шаблоне нам нужно вывести картинку с однопиксельной черной рамкой вокруг нее, то мы делаем так:

Bordered image: <?= image("Picture", 0, 0, "BorderedImage") ?>

Результатом его работы будет что-то вроде:

Bordered image:
<TABLE cellpadding="1" cellspacing="0" border="0">
<TR>
<TD bgcolor="black"><IMG src="/images/Picture1234567890.jpg" width="100" height="200" border="0"></TD>
</TD>
<TABLE>

С помощью последнего необязательного параметра string params в HTML код можно дабавить специфические параметры, например:

Right floated image: <?= image("Picture", 0, 0, "", "align=right") ?>

Результат:

Right floated image: <IMG src="/images/Picture1234567890.jpg" width="100" height="200" border="0" align=right>

Шаблон для вывода картинки в фоне таблицы:

<TABLE cellpadding="1" cellspacing="0" border="0">
<TR>
<TD background="<?= image_src("/images/Background") ?>">Lorem ipsum dolor sit amet</TD>
</TD>
<TABLE>

Предварительная проверка найдена ли будет картинка default в текущем контексте, если нет, то вывести надпись “No image”

<?php if (cs_is_image("default")): ?>
 <?= image("default") ?>
<?php else: ?>
 No image
<?php endif; ?>