====== Услуга смс:донейт ======

===== Общая информация =====

Услуга **смс:донейт** — самая простая из наших услуг. Установить и настроить ее даже проще, чем **смс:чат**. Пользовательский интерфейс услуги сведен к минимуму и представляет собой простую кнопку, нажав на которую, пользователи получат предельно короткую инструкцию, как отблагодарить создателей любимого ресурса, отправив 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/|здесь]]