====== Услуга смс:чат ====== ===== Общая информация ===== Услуга **смс:чат** — простой в установке сервис, который легко встроить в любой дизайн. Его можно использовать не только для организации общения между пользователями, но и сбора информации от пользователей. Окно чата можно расположить в абсолютно любой части веб-страницы. **Услуга не модерируется.** ===== Алгоритм работы ===== - Пользователь видит окно чата, которое уже может содержать сообщения других пользователей. Эти сообщения хранятся в БД на нашем сервере. - Чтобы отправить сообщение, пользователь нажимает на ссылку "Написать сообщение" ("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/<идентификатор чата>/ можно посмотреть список всех имен и связанных с ними номера телефонов, когда-либо использованных в **смс:чате**.