Списки

Списки

Позволяет создавать списки для хранения данных.

Отзывов пока нет

Далее просто выберите подходящий тарифный план облака Webasyst и продолжайте использовать «Списки» за +239 /месяц к стоимости тарифа.


Уже есть Webasyst?
Лицензия для установки «Списки» в свой Webasyst или на свой сервер:

Ваш отзыв
Установок
< 10
Разработчик
Поддержка

Приложение «Списки» позволяет создавать списки для хранения данных разной структуры, и использовать эти данные в шаблонах страниц сайта. С его помощью Вы получаете возможность легко и удобно управлять любыми наборами данных. Ярким примером может служить ротатор баннеров на главной странице многих сайтов. Для его реализации обычно требуется использовать не совсем удобные инструменты, сильно ограничивающие возможности разработчиков и усложняющие работу контент-менеджеров. Если речь идёт об обычных картинках, то с задачей вполне справляется приложение «Фото». Но что если потребуется сделать картинки со ссылками? А если формировать каждый баннер из нескольких картинок (для экранов разной ширины)? Или, допустим, потребуется добавить небольшой фрагмент текста с html-разметкой, как тогда быть? «Списки» легко с этим справятся! По сути каждый представляет собой группу структурированных данных. Каждый элемент этой группы может содержать множество ячеек-полей для хранения информации разных типов (текст, html-код, изображение, и т.д.). Для простоты, Вы можете думать о списках, как о таблицах, содержащих в каждой строке однотипные наборы данных. Если мы продолжим рассматривать ротатор баннеров, то список для хранения информации о баннерах, будет содержать примерно такие поля:

  • Поле для загрузки картинки шириной 1980 px
  • Поле для загрузки картинки шириной 1200 px
  • Поле для загрузки картинки шириной 992 px
  • Поле для загрузки картинки шириной 768 px
  • Поле для загрузки картинки шириной 576 px
  • Поле для выбора страницы на которую будет вести ссылка. К примеру выпадающий список, который берёт варианты значений из базы данных, и выборка ограничена таким образом, что выводится только активные категории верхнего уровня
  • Визуальный редактор для работы с текстовым блоком

Создание списков

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

Доступные виды полей:

  • Текстовое поле (одна строка);
  • Текстовая область (много строк);
  • Файл — любой тип файла;
  • Изображение — изображение в формате jpeg или png. Есть возможность кадрировать изображение в процессе его загрузки;
  • Переключатель — имеет два состояния: 1 — включен и 0 — выключен;
  • Выпадающий список с одиночным выбором;
  • Выпадающий список с множественным выбором (при использовании значений из поля такого типа, необходимо помнить что они доступны в виде массива);
  • Визуальный html редактор;

Для выпадающих списков можно настроить источник данных для получения доступных значений. Есть 3 варианта:

  • Простое перечисление — подпись==значение (каждый вариант с новой строки);
  • Массив JSON — закодированный в json массив объектов со свойствами caption и value. Например: [{"caption":"подпись1","value":"значение1"},{"caption":"подпись2","value":"значение2"}];
  • База данных — выборка из таблицы базы данных сайта. Для настройки этого источника, потребуется указать дополнительные параметры:
    • Имя таблицы – когда этот параметр будет указан, в полях «Заголовок» и «Значение» доступные варианты автоматически изменятся на имена столбцов указанной таблицы. Если этого не произошло, проверьте правильно ли указано имя таблицы. В приведённом выше примере списка для баннеров, в поле с именем таблицы было бы указано shop_category;
    • Заголовок — столбец таблицы, значения которого будут использоваться в качестве подписей для доступных вариантов. В нашем примере, в качестве этого параметра использовалось бы поле name;
    • Значение — столбец таблицы, значения которого будет использоваться в качестве значений (value) доступных вариантов. В примере с баннерами, в качестве этого параметра мы бы выбрали full_url;
    • Where — критерии выборки в формате поле=значение&поле2=значение. Если потребуется перечислить несколько значений одного поля, то нужно перечислить их через запятую. К примеру, если указать «field=1&field2=1,2,3», то будут выбраны записи у которых значение поля field равны 1, и при этом значения поля field2 равны 1, или 2, или 3. В примере с баннерами, было бы указано status=1&depth=0 (только активные категории верхнего уровня);

Изменение и удаление списков

На удаление и изменение списков, не имеющих элементов, никаких ограничений не накладывается. Но ни изменить структуру (указать заново какие поля и какие типы полей используются для каждой записи), ни удалить, список в котором уже есть элементы, невозможно.

При изменении списков, изменении элементов списков, и создании новых элементов, не забывайте нажать кнопку «Сохранить», иначе изменения не сохранятся.

Использование в шаблонах

Для получения данных из списка в шаблонах, используется метод dalists::getDataList, которому потребуется передать id списка

<div class="dalists-wrap">
  {$items = $wa->dalists->getDataList(4)}
  {foreach $items as $item}
   {foreach $item as $key => $value}
    <div>{$key}: {$value}</div>
   {/foreach}
  {/foreach}
 <hr/>
</div>

Ещё продукты разработчика

Все продукты этого разработчика