В керуванні контактами існує дві частини, це список та підписка присутності.
Список це список всіх ваших контактів.
Щоб отримувати оновлення про присутність контактів, тобто, щоб бачити коли вони онлайн та їх поточний статус, ви мусите бути підписаними на той контакт.
Для контакта, щоб отримувати оновлення про вашу присутність, ви мусите мати схваленим запит на підписку від того контакта.
Деякі сервери могли вже налаштувати ваш список та підписки для вас, наприклад, багато компаній інтегрується з LDAP, та автоматично підписують всіх користувачів до всіх інших користувачів.
Наступні секції описують список та керування підписками в більших подробицях.
Щоб подивитись всі контакти з вашого списка, використайте команду /roster. Вивід дає вам наступну інформацію:
JID та нікнейм Jabber ID контакта, та нікнейм, якщо ви надали один. Підписка Поточний статус підписки, і чи ви отримали або відправили запит, який ще не було схвалено або відхилено. Групи Список груп, до яких контакт належить, дивіться групи знизу.
Статус підписки може бути один з: none Ви не підписані на контакт, і контакт не є підписаним на вас. to Ви підписані на контакт, але вони не підписані на вас. from Ви не підписані на контакт, але вони підписані на вас. both Ви підписані на контакт, і вони підписані на вас.
Щоб додати контакт до списку, використайте команду /roster, постачаючи Jabber ID та опціональний нікнейм:
/roster add me@shapovalov.website
З опціональним нікнеймом:
/roster add me@shapovalov.website Vladyslav
Ви можете додати контакт до списку та надіслати запит на підписку в один і той же час, використовуючи команду /sub:
/sub request me@shapovalov.website
Щоб видалити контакт зі списку:
/roster remove me@shapovalov.website
Видалення контакта з вашого списка також видаляє вашу підписку на їх присутність, та їх підписку на вашу.
Деякі сервери автоматично дають вашим контактам нікнейми (під час інтеграції з LDAP, наприклад), який є більш зручним для читання людиною, ніж Jabber ID.
Profanity використовує нікнейми за замовчуванням в своєму інтерфейсі користувача, та для більшості команд, які стосуються контактів.
Якщо сервер дозволяє це, ви можете змінити, додати або видалити нікнейм для даного контакта, використовуючи команду /roster:
/roster nick me@shapovalov.website Vladyslav
Щоб видалити нікнейм користувача:
/roster clearnick me@shapovalov.website
Список дозволяє контактам бути доданими до названих груп. Profanity використовує групи, використовуючи команду /who для фільтрації показаних контактів.
Групи списка керуються командою /group.
Щоб показати контакти в конкретній групі:
/group show friends
Щоб додати контакт до групи:
/group add friends Vladyslav
Зверніть увагу на те, що не існує команди, яка додасть групу, додавання контакта до групи, яка ще не існує, створить групу.
Щоб видалити контакт з групи:
/group remove friends Vladyslav
Щоб затребувати інформацію про присутність для контакта, використовуйте команду /sub:
/sub request me@shapovalov.website
Користувач отримає сповіщення про те, що ви виявили бажання знати про його присутність, та буде мусити підтвердити запит.
Параметр контакта є опціональним, якщо ви вже у вікні чата з користувачем, запит буде надіслано цьому користувачу:
/sub request
Ви можете підтвердити запити підписки від контактів з використанням команди /sub:
/sub allow me@shapovalov.website
Параметр контакта є опціональним, якщо ви вже у вікні чата з користувачем, підтвердження буде надіслано цьому користувачу:
/sub allow
Ви можете відхилити запити підписки від контактів, використовуючи команду /sub:
/sub deny me@shapovalov.website
Параметр контакта є опціональним, якщо ви вже у вікні чата з користувачем, відхилення буде надіслано цьому користувачу:
/sub deny
Команда /sub deny може також бути використаною для видалення підписки на присутність контактами, якщо ви раніше схвалили її.
Щоб вивести список запитів, які ви відправили, які очікують підтвердження від контакта, використайте наступну команду:
/sub sent
Щоб вивести список запитів, які ви отримали, але ще не підтвердили або відхилили, використайте наступну команду:
/sub received