Информационный портал о WebMoney
|
||
|
|
Информационный портал о WebMoney
|
|
|
||||||
|
||||||||
WMK-протокол: проще простого© Никита Сенченко Публикуя огромные статьи об автоматизации бизнеса и программировании, мы совершенно забыли о тех веб-мастерах, которым нужны инструменты попроще. Такие инструменты в WebMoney тоже есть, и сегодня мы об одном из них расскажем. Всё, что вам понадобится знать, это как составить html-тег <A>. Он формирует гиперссылку. Например, вот такой html-код В гиперссылки могут встраиваться команды, запускающие на вашем компьютере определенные программы с определенными параметрами. Самый классический пример - ссылка вида Если на компьютере установлен Skype, то клик по следующей ссылке приведет к звонку пользователю Boss: Аналогично и с Keeper Classic. Разработчики WebMoney снабдили его несколькими командами, которые можно "вживлять" в html-ссылки. При нажатии на такие ссылки Keeper производит какие-либо действия: открывается, закрывается, обновляет соединение, инициирует WM-перевод и т.д. Всё это названо WMK-протоколом (точное название - WebMoney Keeper pluggable protocol). Его полное описание можно найти здесь. По сути, WMK-протокол - это набор команд для html-ссылок. Все эти команды имеют одинаковый формат:
Всё начинается с сигнальной фразы wmk:, которая обозначает протокол. Далее следует команда. Она определяет действие (поведение) Кипера. Параметры команды определяют, как именно это действие будет выполнено. При этом некоторые команды должны обязательно применяться вместе с параметрами, а некоторые - параметров не имеют вовсе. В теории это выглядит сложным, но на практике всё очень просто. Разберём ниже несколько команд WMK-протокола с примерами. Команда refresh Предположим, ваш сайт в автоматическом режиме перечислил WM вашему клиенту, либо выставил ему счет. Вероятнее всего, он увидит перевод\счет в своём Keeper Classic не сразу, а только спустя несколько минут, когда Кипер получит информацию с сервера WebMoney. Чтобы это ускорить, пользователь может нажать в Кипере Меню - Обновить данные (или кнопку F5), заставляя тем самым Кипер обновить данные принудительно. Но не все знают о такой возможности. Вы можете предложить клиенту кликнуть по такой ссылке: С подобной ситуацией, когда клиент не видит в своём Кипере перевод или выставленный счёт, начинает из-за этого нервничать и даже писать письма в поддержку, - часто сталкиваются автоматические обменные пункты. Решение же очень простое: всего-то требуется приказать Киперу "подтянуть" новую информацию с сервера. Команда refresh как раз для этого случая. Команда payto Если даже вы не автоматизировали прием платежей на своем сайте, то можете хотя бы облегчить для покупателей процесс совершения переводов с помощью команды payto. Многие продавцы публикуют на сайте номер кошелька и инструкцию, с каким Примечанием делать перевод. Мне часто приходилось видеть приблизительно такие надписи: "для оплаты переведите сумму заказа на кошелек WebMoney Z123456789012, в примечании укажите ваш номер заказа". Это неудобно для плательщика: ему нужно вручную копировать в Кипер все параметры перевода, и он может ошибиться. Куда удобнее кликнуть по такой ссылке: Оплатить! Эта ссылка открывает окно Keeper Classic с уже заполненными параметрами перевода - кошельком, суммой, примечанием. В частности, в данном примере мы предлагаем заплатить 1 WMZ на кошелек Z339275499747 с примечанием "Оплата заказа номер 2329". Html-код этой ссылки следующий:
Обратите внимание на параметр BringToFront. Если его значение равно "Y", то окно с переводом отобразится поверх всех остальных окон. Команда msgto Данная команда открывает окно WM-чата. Это очень удобно, когда вы хотите предложить клиенту отправить вам сообщение по Киперу. Таким образом, msgto чем-то напоминает стандартную команду mailto, о которой мы говорили в начале статьи. Формат команды следующий: В параметре to должен передаваться WMID получателя (то есть ваш). В параметре msg - текст сообщения. BringToFront=Y здесь также может использоваться. Несколько слов нужно сказать о тексте, который передаётся в параметре msg. Он должен быть в кодировке Win1251. Другие кодировки и URL-кодирование не поддерживаются. Пробелы между словами обрабатываются корректно. Различные спецсимволы также передаются в окно чата корректно, за исключением %, <, >, &. Символ "#" в IE и Firefox работает как перенос строки, хотя Opera на нем спотыкается. Общая длина текста ограничена приблизительно 460 символами, но при наличии русских букв - значительно меньше. Протокол поддерживает еще несколько команд, но они не так интересны. Предлагаю познакомиться с ними самостоятельно. Но, в любом случае, нужно понимать, что WMK-команды не автоматизируют бизнес-процессы на вашем сайте, а лишь позволяют упростить для клиента выполнение некоторых действий. И не забывайте, что это касается только пользователей Keeper Classic. Light и Mini WMK-протокол не поддерживают. Все WMK-команды требуют, чтобы Keeper Classic был запущен. В противном случае, они сначала вызывают окно запуска Кипера, а уже после того, как программа подключится к серверу, отрабатывается сама вызванная команда. В заключение скажем, что директивы WMK-протокола корректно выполняются во всех опробованных нами браузерах. Это означает, что html-ссылка с командой вида wmk: будет правильно работать и в IE, и в Firefox, и в Opera.  Обсудить этот материал25.07.2009 Внимание! Все права на данный материал принадлежат сайту owebmoney.ru. Копирование материала разрешено с обязательным указанием гиперссылки на http://owebmoney.ru. |
|
||||||||||||||||||||||||||||||||||||||||||||
