====== Услуга смс:донейт ====== ===== Общая информация ===== Услуга **смс:донейт** — самая простая из наших услуг. Установить и настроить ее даже проще, чем **смс:чат**. Пользовательский интерфейс услуги сведен к минимуму и представляет собой простую кнопку, нажав на которую, пользователи получат предельно короткую инструкцию, как отблагодарить создателей любимого ресурса, отправив SMS-сообщение. **Предоставление услуг с использованием данного сервиса категорически запрещено!** **Услуга модерируется.** ===== Алгоритм работы ===== - Пользователь сайта нажимает на кнопку, связанную с услугой, которую владелец может расположить в абсолютно любой части своей веб-страницы. - В ответ предлагается заполнить поля выбора страны/оператора для получения инструкции по отправке SMS, которая включает в себя: * короткий номер, на который необходимо отправить SMS; * текст SMS-сообщения, состоящий из: * префикса; * идентификатора **смс:донейта** (ID смс:донейта); * стоимость SMS, которая в зависимости от страны может как включать, так и не включать НДС; * указание о дополнительных налогах и сборах, которые могут быть установлены в выбранной стране. - Отправленное пользователем SMS-сообщение через оператора (и агрегатора) поступает на наш сервер. - Согласно тексту SMS определяется соответствующий **смс:донейт** и проверяется статус оплаты принятого SMS-сообщения оператором сотовой связи. - Если проверка прошла успешно, средства зачисляются на баланс услуги, а пользователю отправляется ответное SMS-сообщение с текстом, указанным в настройках. __**Замечание.**__ Для каждой страны доступен полный список тарифов, действующих в ее пределах. Таким образом, пользователь может выбрать стоимость SMS-сообщения в зависимости от того, какую сумму собирается пожертвовать ресурсу. ===== Добавление услуги и настройка ===== Добавление/настройка услуги **смс:донейт** производится в Панели Управления -> Услуги -> смс:донейт. После добавления услуги необходимо на сетевом ресурсе разместить [[#Клиентский код скрипта услуги смс:донейт|клиентский код скрипта]], взаимодействующий с нашим сервером и реализующий соответствующую логику. Чтобы подключить к аккаунту новый **смс:донейт**, необходимо нажать "Добавить" и заполнить предлагаемую форму. При настройке параметров **смс:донейта** следует учитывать следующие особенности: - **Адрес сайта**\\ Обязательно необходимо указать правильный адрес сайта, на котором планируется установить услугу. Этот адрес будет проверен модератором. - **Ответ**\\ Текст ответного сообщения обязательно должен соответствовать нашим требованиям. Этот текст также проверяется модератором. - **Рассылки**\\ Этот параметр не задействован, т.е. игнорируется. ===== Клиентский код скрипта услуги смс:донейт ===== Клиентский код скрипта доступен в Панели Управления по ссылке [[#Версия скрипта по-умолчанию|HTML Код]] http://smscoin.com/donate/html/<идентификатор донейта>/ и размещается в любом месте веб-страницы. ==== Версия скрипта по умолчанию ==== <code> <script type="text/javascript"> /* <![CDATA[ */ smsDonateId = <ID услуги смс:донейт>; smsDonateButton = <идентификатор кнопки>; /* ]]> */ </script> <script type="text/javascript" src="http://donate.smscoin.com/js/smsdonate.js"></script> </code> Идентификатор кнопки задает ее внешний вид, который выбирается из списка кнопок в Панели Управления. **Установка языка интерфейса по умолчанию**\\ По умолчанию используется русский язык интерфейса. Для смены языка, например на английский, необходимо в коде скрипта добавить строку <code> smsDonateLanguage = "english"; </code> Вместо english можно указать любой поддерживаемый язык. ==== Расширенная версия скрипта ==== Недостатком [[#Версия скрипта по умолчанию|версии скрипта по умолчанию]] является ограниченный выбор внешнего вида кнопки. Эту проблему можно решить с помощью следующей модификации кода скрипта: <code> <script type="text/javascript"> /* <![CDATA[ */ smsDonateId = <ID услуги смс:донейт>; smsDonateButton = <URL путь к файлу с изображением кнопки>; smsDonateLanguage = <язык интерфейса>; /* ]]> */ function smsDonateInit() { smsDonateButton = window.smsDonateButton || 1; document.write('<img src="' + smsDonateButton + '" alt="Donate" onclick="smsDonatePopup(\'' + (window.smsDonateLanguage? window.smsDonateLanguage: '') + '\')" style="cursor: pointer" />'); } function smsDonatePopup(language) { if (!window.smsDonateId) return; var lang = (!!language)? '&language=' + language: ''; var ls = (language == "english")? '_en': ''; window.open('http://donate.smscoin.com/js/smsdonate/index' + ls + '.html?sid=' + smsDonateId + lang, 'smsdonate_popup', 'height=500,left=' + (screen.width - 700 >> 1) + ',resizable=yes,scrollbars=yes,top=' + (screen.height - 500 >> 1) + ',width=700'); } smsDonateInit(); </script> </code> Где\\ <путь к файлу с изображением кнопки> - полный URL-адрес изображения кнопки, начинающийся с <nowiki>http://</nowiki>. ===== Пример работы ===== Пример работы услуги можно посмотреть [[http://smscoin.com/info/smsdonate-tech/|здесь]]