Добавление пользователей в группы через автоматизацию пользовательских полей

[Moin]

Я заметил несколько ошибок в документации:

@Discourse

Перейдите в раздел Пользователи > Поля пользователей

На самом деле поля пользователей находятся в разделе «Сообщество» боковой панели администратора.

@Discourse

• Перейдите в административную панель вашего сайта
• Перейдите в раздел Настроить > Автоматизация

Автоматизация реализована в виде плагина, поэтому вы найдете ее в разделе «Плагины», а не в разделе «Настроить».

В целом, скриншоты и навигация кажутся немного устаревшими. Кроме того, общепринятым термином является «пользовательское поле» (custom user field), но в этом руководстве часто используется «пользовательское поле» (user custom field).

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

Мой черновик

Это руководство объясняет, как автоматически добавлять пользователей в группы на основе их выбора пользовательского поля при регистрации или обновлении профиля.

Требуемый уровень доступа пользователя: Администратор

Краткое содержание

1. Настройка пользовательского поля
2. Создание необходимых групп
3. Создание автоматизации для добавления пользователей в группы
4. Проверка настройки

Настройка пользовательского поля

Сначала создайте пользовательское поле, из которого пользователи будут выбирать:
(Также существует подробное руководство по пользовательским полям)

1. Перейдите в административную панель вашего сайта
2. Перейдите в раздел «Поля пользователей», используя ссылку в разделе «Сообщество» боковой панели администратора или посетив /admin/config/user-fields
3. Нажмите «Добавить поле пользователя»
4. Настройте поле с соответствующими параметрами

Вот пример того, как может выглядеть ваше пользовательское поле:

Автоматизация добавляет пользователей в группу, если их ввод в пользовательском поле точно совпадает с полным именем группы. Для обеспечения точности используйте выпадающий список с заранее определенными вариантами, которые точно соответствуют именам групп. Поля свободного текста могут привести к несоответствиям. Если используется поле подтверждения, группы должны быть названы ‘true’ или ‘false’.

Создание групп

Далее создайте группы, в которые пользователи должны автоматически добавляться:
(Также существует подробное руководство по созданию групп)

1. Перейдите в раздел «Группы», используя ссылку в боковой панели администратора или добавив /g или /groups к URL вашего форума.
2. Нажмите «Новая группа» для каждой группы, которую вы хотите создать
3. Убедитесь, что для каждой группы указано «Полное имя», так как скрипт автоматизации использует его

Скрипт автоматизации использует полное имя группы, поэтому убедитесь, что оно точно совпадает с вводом в пользовательском поле.

Создание автоматизации

Теперь настройте автоматизацию для добавления пользователей в группы на основе их выбора в пользовательском поле:

1. Перейдите в административную панель вашего сайта
2. Перейдите в раздел Плагины > Автоматизация
3. Нажмите «Добавить автоматизацию»
4. Выберите скрипт «Добавить пользователя в группу через пользовательское поле»
5. Укажите имя
6. Выберите триггер:
   • «Первый вход пользователя» для добавления пользователей в группы при регистрации
   • «Повторяющийся» для запуска по расписанию, что позволяет пользователям менять группы со временем
7. Выберите ваше пользовательское поле из выпадающего списка
8. Не забудьте включить автоматизацию

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

Проверка настройки

Чтобы убедиться, что все работает правильно:

1. Зарегистрируйтесь как новый пользователь или обновите профиль существующего пользователя
2. Выберите вариант из созданного вами пользовательского поля
3. Завершите процесс регистрации или обновления профиля

Вот пример того, как пользовательское поле может выглядеть при регистрации:

После запуска автоматизации вы должны увидеть, что пользователь добавлен в соответствующую группу:

Часто задаваемые вопросы

В: Может ли эта автоматизация добавлять пользователей в основные группы?
О: По умолчанию эта автоматизация добавляет пользователей во вторичные группы. Чтобы установить группу как основную, перейдите на страницу настроек «Управление > Членство» группы и выберите «Автоматически устанавливать как основную группу».

В: Как часто запускается автоматизация, если я выберу триггер «Повторяющийся»?
О: Вы можете установить частоту при создании автоматизации. Выберите расписание, которое лучше всего соответствует потребностям вашего сообщества.

В: Что произойдет, если пользователь изменит свой выбор в пользовательском поле?
О: Если вы настроили повторяющуюся автоматизацию, она обновит членство пользователя в группе на основе его нового выбора при следующем запуске.

В: Могу ли я использовать более одной автоматизации на основе полей подтверждения?
О: Да! Хотя полные имена обеих групп должны быть ‘true’ или ‘false’, вы можете создать несколько групп с разными именами для их различения. При настройке автоматизации просто выберите соответствующее пользовательское поле для каждой из них.

Дополнительные ресурсы

• Creating and configuring custom user fields
• Creating groups in Discourse
• Setting a primary group for users

Если бы я обновил документацию сейчас, я также добавил бы, что существуют проблемы при использовании пользовательского поля с множественным выбором