Wiki

Clone wiki

CMS / Изображения_к_материалу

Начиная с версии 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 прикрепленных картинок. Примеры использования
    #!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 %}
    
    Где {{ img.full }} - url полного изображения, а {{ img.small }} - url на миниатюру этого изображения.

⚠ До версии 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