Wiki
Clone wikiCMS / Изображения_к_материалу
Начиная с версии Atom-M 1.1.9, в системе появилась возможность прикрепления к материалам, таким как новости, статьи и загрузки, изображений. Количество, размер и вес этих изображений настраиваются в панели администратора.
Админка -> [новости|статьи|загрузки] -> настройки -> изображения
В данной вкладке мы имеем ряд настроек
- Размер по оси Х - ширина изображений будет подогнана под этот размер
- Размер по оси Y - высота изображений будет подогнана под этот размер
- Максимальный "вес" - максимальный размер изображений в Кб.
- Максимальное кол-во - максимальное количество прикрепляемых к одному материалу изображений
После выбора изображений в форме добавления материала вы можете выводить их в любом месте вашего текста, путем вставки меток вида {IMAGEn}. Где "n" - номер изображения. При этом все изображения будут подгоняться под настроенный в админке размер. Заметьте, что все настройки для каждого модуля индивидуальны. То есть в новостях вы можете выводить картинки в одном размере, а в статьях уже в другом.
Изображения загруженные таким образом хранятся в папке data/images/[module]/.
В версии Atom-M 4 адреса были другими: /data/files/[module]/. А до версии Atom-M 4 такими: /sys/files/[module]/.
Если необходимо с обтеканием прижать картинку в левую или правую сторону, можно использовать метки {LIMAGEn} и {RIMAGEn} соответственно.
Миниатюры
Если эта функция не отключена, для загруженных картинок автоматически создаются миниатюры. В стандартном дизайне с помощью FancyBOX по клику по миниатюре открывается во весь экран полное изображение.
Начиная с Atom-M 2.3.1 (22.08.13) настройки миниатюр поделены на глобальные и локальные.
Глобальные настройки - настройки миниатюр, затрагивающие все модули. Чтобы их открыть перейдите в Админка -> Дополнительно -> Настройки миниатюр. Здесь можно включить или отключить создание миниатюр на сайте, выставить ширину и высоту миниатюр.
Локальные настройки - настройки миниатюр, затрагивающие только определённый модуль. Они имеют больший приоритет, чем глобальные настройки. Это может быть полезно, чтобы с помощью глобальных настроек выставить одни настройки миниатюр для всех модулей, а с помощью локальных настроек выставить индивидуальные настройки для определённого модуля. Чтобы их открыть перейдите в Админка -> [новости|статьи|загрузки] -> настройки -> изображения. Здесь можно включить или отключить локальные настройки, остальное аналогично глобальным.
Кстати, смена размеров миниатюр действует сразу на все миниатюры, а не только на вновь загруженные, так что смело экспериментируйте.
Дополнительная информация по миниатюрам
Миниатюры хранятся и выводятся по адресу data/images/[module]/WxH/название_картинки.jpg, где WxH максимально возможный размер миниатюры по ширине и высоте.
До версии Atom-M 5 адреса были другими. Адрес миниатюр хотя и имел вид /image/модуль/название_картинки.jpg, на самом деле миниатюры хранились в sys/tmp/img_cache/размер_миниатюр/модуль/название_картинки.jpg.
Если вы запрашиваете миниатюру, но миниатюры нет по её адресу, то она "на лету" генерируется из оригинала, кладется по запрошенному адресу и выводится пользователю.
До версии Atom-M 5 механика генерации миниатюр была другая, генерировались они скриптом img.php, на который происходит автоматическое перенаправление с /image/* файлом .htaccess.
Вывод прикреплённых картинок в шаблоне
Начиная с Atom-M 2.3.1 (22.08.13) в шаблонах добавлена возможность выводить прикреплённые картинки в шаблонах. В файлах шаблона list.html и material.html используйте метки
{{ entity.img.url_N }}
и
{{ entity.img.small_url_N }}
для вывода полной картинки и миниатюры соответственно, где N - номер прикрепления.
Обратите внимание, что для вашего удобства {{ entity.img.small_url_N }} выводит миниатюру, а не полное изображение, даже если создание миниатюр отключено на сайте.
А так же можно выводить сразу несколько картинок:
- {{ entity.img.attach_all }} - Массив всех прикрепленных картинок.
- {{ entity.img.attach_N1_N2 }} - Массив с N1 по N2 прикрепленных картинок.
Примеры использования
Где {{ img.full }} - url полного изображения, а {{ img.small }} - url на миниатюру этого изображения.
#!html <!--Пример вывода всех прикрепленных изображений--> {% for img in entity.img.attach_all %} <a class="gallery" href="{{ img.full }}"><img src="{{ img.small }}" alt=""/></a> {% endfor %} <!--Пример вывода с 3 го по 10 ое прикрепленное изображение--> {% for img in entity.img.attach_3_10 %} <a class="gallery" href="{{ img.full }}"><img src="{{ img.small }}" alt=""/></a> {% endfor %}
До версии Atom-M 5 названия меток были другими. Вместо ".img." было ".atom.img_". Тоесть, {{ entity.atom.img_url_N }}, {{ entity.atom.img_small_url_N }}, {{ entity.atom.img_attach_all }}, {{ entity.atom.img_attach_N1_N2 }}.
Updated