Поле Список пользователей ^{Документация}

Документация: Поле «Список пользователей» (Userslist)

Поле «Список пользователей» (Userslist) — это мощное дополнение для InstantCMS, которое позволяет привязывать пользователей к любым записям контента и гибко настраивать их вывод как в списках, так и внутри самих записей. Это идеальный инструмент для создания списков участников, авторов проекта, команд или любых других связей между контентом и пользователями.

 
🚀 Основные возможности

1. Гибкая архитектура настроек
Отображение в списке: настраивается вывод пользователей (какие профильные поля выводить, размер аватара, шаблон) когда запись выводится в категории, ленте или других списках.
Отображение в записи: независимые настройки для вывода пользователей на странице самой записи. Вы можете выводить в списке просто аватарки, а внутри записи — полноценные карточки с биографией участников.
Поиск и доступ: детальная настройка прав доступа, приватности (кому показывать email, дополнительные поля) и параметров поиска пользователей при привязке.

2. Встроенный Конструктор Шаблонов
Главная фишка поля — возможность создавать собственные шаблоны вывода прямо в админке без доступа к файловой системе сайта.

• Управление шаблонами: Создавайте новые, клонируйте текущие, переименовывайте и удаляйте шаблоны в один клик.
• Удобный редактор: Встроенный редактор кода с подсветкой синтаксиса для HTML и CSS.
  Мгновенное применение: Созданный шаблон сразу же появляется в выпадающих списках настроек отображения без перезагрузки страницы.
• Импорт / Экспорт: Обменивайтесь своими уникальными дизайнами с другими пользователями.

🎨 Создание собственных шаблонов

Конструктор использует простой, но мощный синтаксис. Вы можете выводить любые данные пользователя.

Доступные теги:
{each}… {/each} — цикл по всем привязанным пользователям.
{user.nickname} — имя пользователя.
{user.profile_url} — ссылка на профиль.
{user.avatar_html} — готовый HTML-код аватара.
{user.avatar_url} — прямая ссылка на изображение аватара.
Цикл дополнительных полей профиля

Вы можете вывести дополнительные поля пользователя, которые были выбраны в настройках:

{if user.fields}
    <div class="fields">
        {fields}
        <div class="field">
            <strong>{field.title}:</strong> {field.html}
        </div>
        {/fields}
    </div>
{/if}

 
🤖 Быстрая верстка через Нейросети (ChatGPT / Claude / Gemini)

Создание потрясающих макетов вывода участников стало невероятно простым, и вам даже не обязательно уметь верстать! Большинство пользователей могут просто показать нейросети картинку желаемого дизайна и попросить перевести верстку под наш шаблонизатор.

Как это работает:
Шаг 1. Найдите дизайн или сделайте скриншот
Найдите в интернете любой красивый блок с карточками пользователей или командой и сделайте скриншот.

Шаг 2. Запрос к нейросети (Промпт)
Загрузите картинку в ChatGPT (или другую нейросеть) и напишите следующий промпт, прикрепив пример нашего синтаксиса:

«Сверстай такой блок на HTML и CSS, а затем переведи верстку на наш шаблонизатор.
Вот пример синтаксиса шаблонизатора:

<div class="row row-cols-1 row-cols-md-3 userslist--cards">
{each}
  <div class="col mb-4">
    <div class="card h-100">
 
      {if user.avatar_url}
        <a href="{user.profile_url}"><img src="{user.avatar_url}" class="card-img-top" alt="{user.nickname}"></a>
      {else}
        <a href="{user.profile_url}" class="card-img-top card-img-empty">{user.avatar_html}</a>
      {/if}
 
      <div class="card-body">
        <h5 class="card-title"><a href="{user.profile_url}">{user.nickname}</a></h5>
        <div class="card-text">
        {if user.fields}
            <div class="fields mt-2 text-left small">
                {fields}
                    <div class="field mb-1"><strong>{field.title}:</strong> {field.html}</div>
                {/fields}
            </div>
        {/if}
        </div>
      </div>
    </div>
  </div>
{/each}
</div>

Шаг 3. Вставка в Конструктор
Нейросеть сама напишет HTML и CSS, и автоматически расставит нужные теги. Вам останется только скопировать полученный код и вставить его в „Конструктор шаблонов“ в админке.

Всё! Буквально за пару минут вы получили профессиональную плитку карточек пользователей с вашим уникальным дизайном, идеально интегрированную в ваш сайт!