Jabber Roster Utility

From JaWiki (Jabber/XMPP wiki)
(Redirected from JRU)
Jump to: navigation, search

Jabber Roster Utility in PHP - скрипт для модификации всего ростера целиком. Удобен при осуществлении миграций между серверами, либо просто хотите сделать резервную копию своего ростера, чтобы обезопасить себя от его потери в результате сбоя на сервере. Также может быть полезен, если вы внесли в ростер изменения (например, добавили какой-то сервис), которые не позволяют вашему клиенту подключится.

Как использовать[edit]

Скрипт во время работы с ним отображает подсказки на русском (если правильно сработало автоматическое определение языка). Установленный скрипт можно найти на jabber.ru (на момент написания HTTPS не используется). Либо воспользоваться скриптом прямо на сайте разработчика. Прямые ссылки смотрите ниже.

Учитывайте одно - при каждом обновлении весь ростер заменяется тем, что было в поле ввода.

В общих чертах работа со скриптом очень проста:

  1. Указать свой JID и пароль
  2. Скопировать то текстовое представление ростера, что будет выведено на экран в результате запроса.
  3. Поместить этот текст в текстовый файл на вашем компьютере. Таким образом мы сохраните свои контакты.
  4. Если вы планируете использовать другой сервер, то откройте повторно скрипт, указав JID и пароль от новой учетной записи. Если вы еще её не пользовались, то после запроса не будет показано никаких контактов. Вставьте в пустое текстовое поле те данные что вы сохраняли ранее и щелкните по соответствующей кнопке, чтобы отправить их на сервер. Если у вас уже были контакты в этой учетной записи, то добавьте текст просто в их конец, начав с новой строки. Снова

Ростер представлен в следующем формате: действие, JID, Псевдоним, подписка, группа

Пример содержимого (вначале два JID, а потом ICQ-контакт, добавленный через транспорт icq.jabber.tushino.com):

+,fbot@jabber.ru,fbot,to,"bots,scripts"
+,vasya@jabber.ru,Vasek,both,friends
+,132608944@icq.jabber.tushino.com,,to,
  • Разделителем значений является запятая.
  • Группу можно не заполнять.
  • Если в имени группы есть запятая, то название нужно взять в двойные кавычки (смотри пример выше).
  • Поле подписка может принимать следующие значения: none, to, from, both.

Перенос контактов между транспортами[edit]

С появлением версии 0.7 добавилась функция переноса контакта с одного транспорта на другой. Учтите, что тут происходит взаимодействие с чужими сетями, поэтому результат может отличаться от ожидаемого.

Порядок действий тут следующий:

  1. Отключиться от старого транспорта (контакты при этом не удалятся). Отключаться стоит из-за того, чтобы действия нового транспорта по добавлению контактов не повлияли на работу старого.
  2. В скрипте заполните поля старого транспорта, например icq.jabber.tushino.com и поля нового icq.superserver.ru
  3. Взведите первый флажок Copy contacts from old transport to new one

Ограничения[edit]

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

Есть проблемы с группами. При проверке скрипта на jabber.ru группы посредством него созданы быть не могут. И контакты просто оказываются в корне ростера.
ToDo: Попробовать понять в чем причина

Для администраторов[edit]

Скрипт может быть получен с официального сайта. Для работы требуется PHP 5.x. Само соединение крайне желательно осуществлять посредством SSL.

Снимки экрана[edit]


Ссылки[edit]