Управление WebMoney Keeper через WebMoney Keeper pluggable protocol (WMK)

В данном разделе описан интерфейс, используя который Вы можете посылать WM Keeper Classic определенные команды: обновить данные, показать окно, отправить сообщение и т.д.

Синтаксис этого протокола "внешне" напоминает синтаксис mailto:
Например, Вы можете поместить на своей странице следующую ссылку: Написать мне по WM-почте
HTML-код такой ссылки будет выглядеть следующим образом:

Команды протокола WMK имеют следующий формат:
wmk:<команда>[?][параметр_1=значение]&[параметр_2=значение]&...[параметр_N=значение]

Есть параметры, которые могут принимать все команды протокола wmk. Ниже приведен список этих параметров.

Название параметра	Принимаемые значения	Описание
WMID	WMID 12-цифр	Команда будет обработана только тем экземпляром WebMoney Keeper (если их запущено несколько), в который вошли под указанным WMID. Если этот параметр не указан - команда будет обработана всеми запущенными WebMoney Keeper.
BringToFront	Y или N	Если значение параметра установлено в Y, то после выполнения команды окно WebMoney Keeper будет отображено поверх остальных.
ExecEvenKeeperIsOffline	Y или N	По умолчанию команды протокола wmk выполняется только в режиме OnLine. Если значение параметра установлено в Y, то команда будет обработана также и в режиме Offline.

Если WebMoney Keeper не был запущен, то он будет запущен автоматически.


Refresh
PayTo
MsgTo
Display
Explore
Exit

Команда Refresh делает то же самое, что и пункт меню WebMoney Keeper - Меню|Обновить данные.

Параметры
Не принимает дополнительных параметров.

Пример
Допустим с вашего сайта был выписан счет. Чтобы покупатель быстрее получил уведомление о нем, вы можете либо сделать ссылку Проверить получение счета, либо сделать autosubmit формы.




Команда PayTo показывает диалог "Передать WM". Параметры команды позволяют установить кошелек, на который будет производиться платеж, сумму и описание платежа.

Параметры

• Purse - Номер кошелька на который будет производиться платеж;
• Amount - Сумма платежа;
• Desc - Описание платежа.

Пример
По этой ссылке можно Заплатить 100 WMZ на Ваш кошелек.




Команда MsgTo показывает диалог "Передать WM". Параметры команды позволяют установить WMID адресата, тему и текст сообщения.

Параметры

• To - WMID адресата;
• Subject - Тема сообщения;
• Msg - Текст сообщения.

Пример
Написать мне по WM-почте




Команда Display позволяет показать окно, указанное в параметре Window, и передать ему в параметре Param данные для инициализации.

Параметры

• Window - имя окна, которое будет показано.
  Параметр может принимать одно из значений, приведенных ниже:
  • Main - главное окно WebMoney Keeper Classic;
  • Options - диалог "Параметры программы";
  • Props - диалог "Информация о корреспонденте" или "О себе..." в зависимости от параметра Param;
  • About - диалог "О программе...";
  • Messages - диалог "Список всех сообщений";
  • Invoices_Out - окно "Список выписанных Вами счетов";
  • Invoices_In - окно "Список счетов, предъявленных Вам для оплаты";
  • Operations - окно "История операций".
• Page - страница диалога (1 - первая страница, 2 - вторая и так далее), которая будет активной при показе диалога. Этот параметр применим к окнам Main, Options и Props.
• Param - на данный момент этот параметр используется только окном Props. Вы можете передать в нем WMID участника системы, информация о котором будет показана в диалоге "Информация о корреспонденте". Если этот параметр отсутствует, то будет показан диалог "О себе..."

Пример
Показать WebMoney Keeper и открыть список кошельков
Кликните здесь, чтобы узнать версию WebMoney Keeper
Отредактируйте информацию о себе
Смените скин в этом диалоге!




Команда Explore показывает страницу, указанную в параметре URL в специальном окне WebMoney Keeper.

Параметры

• URL - страница, которую надо показать;
• Title - заголовок окна, в котором она будет показана.

Пример
А это пример из "боевого" сайта: Click Me :)




Команда Exit просто позволяет предложить пользователю выйти из WebMoney Keeper.

Параметры
Не принимает дополнительных параметров.

Пример
Выйти из WebMoney Keeper