====== Услуга смс:чат ======

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

Услуга **смс:чат** — простой в установке сервис, который легко встроить в любой дизайн. Его можно использовать не только для организации общения между пользователями, но и сбора информации от пользователей. Окно чата можно расположить в абсолютно любой части веб-страницы.

**Услуга не модерируется.**

===== Алгоритм работы =====

  - Пользователь видит окно чата, которое уже может содержать сообщения других пользователей. Эти сообщения хранятся в БД на нашем сервере.
  - Чтобы отправить сообщение, пользователь нажимает на ссылку "Написать сообщение" ("Write a message").
  - В ответ предлагается заполнить поля выбора страны/оператора для получения инструкции по отправке SMS, которая включает в себя:
    * короткий номер, на который необходимо отправить SMS;
    * текст SMS-сообщения, состоящий из:
      * префикса;
      * идентификатора **смс:чата** (ID смс:чат);
      * сообщения, которое пользователь хочет добавить в чат;
    * стоимость SMS, которая в зависимости от страны может как включать, так и не включать НДС;
    * указание о дополнительных налогах и сборах, которые могут быть установлены в выбранной стране;
    * дополнительная информация: правила составления текста SMS, условия ответственности, информация о технической поддержке и пр.
  - Отправленное пользователем SMS через оператора (и агрегатора) поступает на наш сервер.
  - Согласно тексту SMS определяется соответствующий **смс:чат** и проверяется статус оплаты принятого SMS оператором сотовой связи.
  - Если проверка прошла успешно:
    * средства зачисляются на баланс услуги;
    * информация о сообщении записывается в БД;
    * в окно чата добавляется текст пользователя;
    * пользователю отправляется ответное SMS-сообщение с текстом "Сообщение добавлено в чат" ("Your message added to chat / Soobchenie dobavleno v chat").
  - Чтобы увидеть добавленное сообщение, пользователь должен обновить страницу, содержащую окно чата.

===== Добавление услуги и настройка =====

Добавление/настройка услуги **смс:чат** производится в Панели Управления -> Услуги -> смс:чат. После добавления услуги необходимо на сетевом ресурсе разместить [[#Клиентский код скрипта услуги смс:чат|клиентский код скрипта]], взаимодействующий с нашим сервером и реализующий соответствующую логику.

Чтобы подключить к аккаунту новый **смс:чат**, необходимо нажать "Добавить" и заполнить предлагаемую форму. При настройке параметров **смс:чата** следует учитывать следующие особенности:
  * **Рассылки** - этот параметр не задействован, т.е. игнорируется.

Клиентский код скрипта доступен в Панели Управления по ссылке [[#Клиентский код скрипта услуги смс:чат|HTML Код]]
  http://smscoin.com/chats/html/<идентификатор чата>/
и размещается в любом месте веб-страницы.

===== Клиентский код скрипта услуги смс:чат =====
По умолчанию клиентский код выглядит следующим образом:
<code>
<script type="text/javascript" src="http://chat.smscoin.com/chat/?chat_id=идентификатор чата&lang=ru"></script>
</code>
Приведенная разметка должна быть расположена в подходящем месте целевой веб-страницы.
Настройка

==== Дополнительные параметры ====
Для настройки **смс:чата** используются следующие опциональные параметры:
^  Параметр  ^  Тип  ^  Описание  ^  По-умолчанию  ^
|lang  |  char(2)  |Двухбуквенный код языка чата  |  RU  |
|limit  |  int  |Количество выводимых сообщений  |  20  |
|css_path  |  string  |Путь к используемому CSS файлу  |  [[http://chat.smscoin.com/chat/style.css]]  |

Например, для того, чтобы уменьшить количество выводимых сообщений в приведенном выше примере до 10, нужно использовать
<code>
<script src="http://chat.smscoin.com/chat/?chat_id=идентификатор чата&limit=10" type="text/javascript"></script>
</code>

==== Оформление внешнего вида ====
Внешний вид окна **смс:чата** можно настроить с помощью клиентской таблицы стилей (CSS). Владелец должен разместить ее у себя на сетевом ресурсе и адаптировать под свои нужды, при этом необходимо изменить код услуги следующим образом:
<code>
<script src="http://chat.smscoin.com/chat/?chat_id=идентификатор чата&css_path=http://yoursite.com/css/style.css" type="text/javascript">
</script>
</code>
Кроме оформления внешнего вида, можно также скрывать отдельные элементы чата. Например, чтобы скрыть время отправки сообщения и ник отправившего, в CSS необходимо добавить следующую строку:
<code>
.time, .nick { display: none; }
</code>

Содержимое CSS файла, используемого по умолчанию:
<code>
/* sms:chat CSS v1.01 */
.sms_wnd * {
 font: 12px 'Arial', sans-serif;
 text-align: justify;
}
/* headstrip */
.sms_head {
 border-bottom: 1px black dotted;
}
.sms_head a {
 color: #800000;
 background: inherit;
 text-decoration: none;
}
.sms_msg {
 color: #0033cc;
 background: inherit;
}
.sms_num {
 font-weight: bold;
}
/* chat window */
.time {
 color: #0033cc;
 background: inherit;
}
.nick {
 font-weight: bold;
 color: #800000;
 background: inherit;
}
.message {
 font-style: italic;
}
/* instructions */
.sms_iframe {
	border: none;
	height: 400px;
	width: 90%;
}
</code>
Оригинал файла находится [[http://chat.smscoin.com/chat/style.css|здесь]].

===== Управление сообщениями и именами =====
Перейдя по ссылке
  http://smscoin.com/chats/messages/<идентификатор чата>/
владелец ресурса может посмотреть список всех сообщений, когда-либо добавленных в **смс:чат**. При этом, он может включить/отключить показ сообщения в чате, нажав ссылку в столбце "Опции".

А по ссылке
  http://smscoin.com/chats/names/<идентификатор чата>/
можно посмотреть список всех имен и связанных с ними номера телефонов, когда-либо использованных в **смс:чате**.