Difference between revisions of "Jabber Roster Utility"

From JaWiki (Jabber/XMPP wiki)
Jump to: navigation, search
(дополнения)
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Jabber Roster Utility in PHP==
+
{{Interwiki
Скрипт для модификации всего [[roster|ростера]] целиком. Удобен при осуществлении [[migration|миграций]]. Также может быть полезен, если вы внесли в ростер изменения (например, добавили какой-то сервис), которые не позволяют вашему клиенту подключится.  
+
| ruwiki =  
 +
| enwiki =
 +
| jworld = Утилита для ростера
 +
}}
 +
'''Jabber Roster Utility in PHP''' - скрипт для модификации всего [[roster|ростера]] целиком. Удобен при осуществлении [[migration|миграций]] между серверами, либо просто хотите сделать резервную копию своего ростера, чтобы обезопасить себя от его потери в результате сбоя на сервере.
 +
Также может быть полезен, если вы внесли в ростер изменения (например, добавили какой-то сервис), которые не позволяют вашему клиенту подключится.  
  
==Как использовать==
+
== Как использовать ==
Скрипт во время работы с ним отображает подсказки на русском, поэтому дополнительное описание не требуется. Установленный скрипт можно найти на [http://www.jabber.ru/jabaddons/jru/jru.php jabber.ru] (на момент написания [[HTTPS]] не используется). Либо воспользоваться скриптом прямо на сайте разработчика (см. ссылку ниже).
+
Скрипт во время работы с ним отображает подсказки на русском (если правильно сработало автоматическое определение языка). Установленный скрипт можно найти на jabber.ru (на момент написания {{w|HTTPS}} не используется). Либо воспользоваться скриптом прямо на сайте разработчика. Прямые ссылки смотрите ниже.
  
 
Учитывайте одно - при каждом обновлении весь [[roster|ростер]] заменяется тем, что было в поле ввода.
 
Учитывайте одно - при каждом обновлении весь [[roster|ростер]] заменяется тем, что было в поле ввода.
 +
 +
В общих чертах работа со скриптом очень проста:
 +
#Указать свой JID и пароль
 +
#Скопировать то текстовое представление ростера, что будет выведено на экран в результате запроса.
 +
#Поместить этот текст в текстовый файл на вашем компьютере. Таким образом мы сохраните свои контакты.
 +
#Если вы планируете использовать другой сервер, то откройте повторно скрипт, указав JID и пароль от новой учетной записи. Если вы еще её не пользовались, то после запроса не будет показано никаких контактов. Вставьте в пустое текстовое поле те данные что вы сохраняли ранее и щелкните по соответствующей кнопке, чтобы отправить их на сервер. Если у вас уже были контакты в этой учетной записи, то добавьте текст просто в их конец, начав с новой строки. Снова
  
 
Ростер представлен в следующем формате:  
 
Ростер представлен в следующем формате:  
 
''действие, [[JID]], [[nick|Псевдоним]], [[Subscription|подписка]], группа''
 
''действие, [[JID]], [[nick|Псевдоним]], [[Subscription|подписка]], группа''
  
Пример содержимого:
+
Пример содержимого (вначале два JID, а потом ICQ-контакт, добавленный через транспорт icq.jabber.tushino.com):
 
  +,fbot@jabber.ru,fbot,to,"bots,scripts"
 
  +,fbot@jabber.ru,fbot,to,"bots,scripts"
 
  +,vasya@jabber.ru,Vasek,both,friends
 
  +,vasya@jabber.ru,Vasek,both,friends
 +
+,132608944@icq.jabber.tushino.com,,to,
  
 
* Разделителем значений является запятая.
 
* Разделителем значений является запятая.
Line 18: Line 30:
 
* Если в имени группы есть запятая, то название нужно взять в двойные кавычки (смотри пример выше).
 
* Если в имени группы есть запятая, то название нужно взять в двойные кавычки (смотри пример выше).
 
* Поле подписка может принимать следующие значения: none, to, from, both.
 
* Поле подписка может принимать следующие значения: none, to, from, both.
 +
 +
== Перенос контактов между транспортами ==
 +
С появлением версии 0.7 добавилась функция переноса контакта с одного транспорта на другой. Учтите, что тут происходит взаимодействие с чужими сетями, поэтому результат может отличаться от ожидаемого.
 +
 +
Порядок действий тут следующий:
 +
#Отключиться от старого транспорта (контакты при этом не удалятся). Отключаться стоит из-за того, чтобы действия нового транспорта по добавлению контактов не повлияли на работу старого.
 +
#В скрипте заполните поля старого транспорта, например icq.jabber.tushino.com и поля нового icq.superserver.ru
 +
#Взведите первый флажок ''Copy contacts from old transport to new one''
  
 
==Ограничения==
 
==Ограничения==
 
По заявлению автора скрипт может не работать с некоторыми серверами. В частности в текущей версии он не поддерживает работу с серверами [[Gtalk]].
 
По заявлению автора скрипт может не работать с некоторыми серверами. В частности в текущей версии он не поддерживает работу с серверами [[Gtalk]].
  
Есть проблемы с группами. При проверке скрипта на jabber.ru группы посредством него созданы быть не могут. И контакты просто оказываются в корне ростера.
+
Есть проблемы с группами. При проверке скрипта на jabber.ru группы посредством него созданы быть не могут. И контакты просто оказываются в корне ростера. {{todo|Попробовать понять в чем причина}}
{{todo|Попробовать понять в чем причина}}
+
  
 
==Для администраторов==
 
==Для администраторов==
 
Скрипт может быть получен с официального сайта. Для работы требуется [[PHP]] 5.x. Само соединение крайне желательно осуществлять посредством [[SSL]].
 
Скрипт может быть получен с официального сайта. Для работы требуется [[PHP]] 5.x. Само соединение крайне желательно осуществлять посредством [[SSL]].
  
* [http://beta.unclassified.de/projekte/jru-php/ Официальный сайт]
+
==Снимки экрана ==
 +
<gallery>
 +
File:Jabber roster utility-01firststep.png|Заполнение полей
 +
File:Jabber roster utility-02content.png|Результат получения ростера
 +
</gallery>
 +
 
 +
 
 +
== Ссылки ==
 +
* [http://beta.unclassified.de/projekte/jru-php/ Официальный сайт] (там же имеется [https://dotforward.de/sslkunde/beta.unclassified.de/projekte/jru-php/jru.php копия свежей версии], работающая через HTTPS)
 +
* [http://www.jabber.ru/jabaddons/jru/jru.php Копия скрипта на jabber.ru] (старая, но работающая версия)
 +
 
 +
[[Category:Сервисы]]

Latest revision as of 13:26, 1 December 2010

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]