Користувальницькькі налаштування

Налаштування сайту


ubillingsms

Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

Посилання на цей список змін

Порівняння попередніх версій Попередня ревізія
Попередня ревізія
ubillingsms [2016/11/24 03:57]
ubillingsms [2023/06/16 17:56] (поточний)
skybetik
Рядок 1: Рядок 1:
 +====== API UbillingSMS ======
  
 +Ubilling надає зручну модель абстракції для роботи з чергою SMS-повідомлень. Починаючи зі стабільного релізу Ubilling 0.7.1, ви можете використовувати у своїх модулях базовий клас UbillingSMS для надсилання SMS-повідомлень, особливо не хвилюючись, що з ними відбуватиметься надалі. Починаючи з 
 +Ubilling 0.8.0 усю роботу з подальшого опрацювання будь-яких, зокрема й SMS-повідомлень, винесено в окрему підсистему - [[senddog|Собака-посилака]].\\
 +
 +Давайте розглянемо на конкретному прикладі найпростіший випадок надсилання SMS-повідомлення.
 +
 +<code php>
 +//створюємо об'єкт класу
 +$sms=new UbillingSMS();
 +//що будемо слати?
 +$message='просто тестове повідомлення';
 +
 +// Складаємо SMS у системну чергу для подальшого надсилання.
 +// 
 +// Параметри методу: 1. номер у міжнародному форматі (string)
 +// 2. текстове повідомлення для надсилання (string)
 +// 3. примусова транслітерація повідомлення (bool)
 +// 4. модуль, на замовлення якого здійснюється посилка (string)
 +                 
 +$sms->sendSMS('+380931234567', $message, false, 'SAMPLEMODULE');
 +</code>
 +
 +Ось власне і все. Повідомлення буде складено в загальну чергу SMS для подальшого відправлення через один із підтримуваних сервісів доставки SMS. З роботою з чергою все теж досить просто. Ми в будь-який момент можемо дізнатися, скільки і яких SMS очікують відправки в даний момент за допомогою методу getQueueCount (повертає int) і отримати повний вміст черги, за допомогою методу getQueueData (повертає array).\\
 +
 +Приклад роботи з чергою:
 +<code php>
 +$sms = new UbillingSMS();
 +
 +//отримуємо кількість SMS, які очікують на відправлення
 +$queueCount = $sms->getQueueCount();
 +
 +if ($queueCount > 0) {
 +//і якщо вони є, отримуємо їхній вміст
 +    $queueData = $sms->getQueueData();
 +    //показуємо вміст - всередині array
 +    debarr($queueData);
 +}
 +
 +</code>