Меню KDT

Виджет "Изображение"

Для того чтобы разместить виджет изображение, в файле settings.xml нужно прописать следующее:

<widget>
	<type>image</type>
	<name>logo</name>
	<label>Логотип сайта</label>
	<maxSize>102400</maxSize>
	<width>200</width>
	<height>200</height>
	<extensions>png</extensions>
	<extensions>jpeg</extensions>
	<extensions>jpg</extensions>
	<extensions>gif</extensions>
	<extensions>svg</extensions>
	<stretch>1</stretch>
	<uq>1</uq>
</widget>
Параметр Описание Обязательно
name Название виджета.
Название (name) у виджета должно быть уникальным
Да
label Название виджета на странице редактора Да
maxSize Максимальный размер загружаемого изображения (в байтах) Нет
width Ширина изображения (в пикселях).
Строго задает требование по ширине для загружаемых изображений
Нет
height Высота изображения (в пикселях).
Строго задает требование по высоте для загружаемых изображений
Нет
extensions Разрешенные расширения изображения.
Строго задает требование по расширению для загружаемых изображений
Нет
uq Задает уникальность изображения для страниц.
uq = 1 означает, что виджет одинаковый для всех страниц, а uq = 0 означает, что виджет разный для всех страниц
Да
stretch Задает пропорциональность изображения.
stretch = 1 означает, что можно изменять размер изображения пропорционально, а stretch = 0 означает, что изменять размер изображения пропорционально нельзя
Да

Затем в файле шаблона, в который необходимо прописать следующее:

<div class="logo">
	{{widgetRender('logo', {
		image: template.path~'/images/logo.jpg',
		url: link('/link', false),
		isBlank: false,
	}, {
		aclass: '',
		astyle: '',
		imgclass: '',
		imgstyle: '',
		container: 'span',
		class: '',
	})}}
</div>

Функция принимает 3 аргумента:

  • 'logo' - название виджета.
  • Массив настроек и значений по умолчанию (не обязательный параметр):
    • image - путь к изображению, которое будет отображаться по умолчанию. Не обязательный параметр. По умолчанию отобразится надпись "загрузите изображение".
    • url - ссылка, которая будет действовать по умолчанию. Не обязательный параметр. По умолчанию: '/'.
    • isBlank - параметр, определяющий открывать ссылку в новой вкладке или нет. Не обязательный параметр. По умолчанию: false.
  • Массив дополнительных настроек (не обязательный параметр):
    • aclass - имя класса для ссылки. Не обязательный параметр. По умолчанию "".
    • astyle - css стили для ссылки. Не обязательный параметр. По умолчанию "".
    • imgclass - имя класса для изображения. Не обязательный параметр. По умолчанию "".
    • imgstyle - css стили для изображения. Не обязательный параметр. По умолчанию "".
    • container - название тега-контейнера. Не обязательный параметр. По умолчанию "span".
    • class - имя класса для тега-контейнера. Не обязательный параметр. По умолчанию "".

Код обязательно должен обладать отступом (tabs).