Розбіжності

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

--- ubillingtelegram [2022/09/24 14:39]
127.0.0.1 зовнішнє редагування
+++ ubillingtelegram [2025/01/25 13:43] (поточний)
nightfly
@@ Рядок 1: / Рядок 1: @@
 ====== API UbillingTelegram ======
-Ubilling предоставляет удобную модель абстракции, для работы с сообщениями [[https://core.telegram.org/api|бота Telegram]]. Начиная со стабильного релиза Ubilling 0.8.0 вы можете использовать базовый класс UbillingTelegram для посылки, приема и чтения сообщений принятых ботом. Для посылки сообщений требуется токен заранее [[https://tlgrm.ru/docs/bots|созданного бота]] и включенная и настроенная подсистема [[senddog|собаки-посылаки]]. Да, вы можете пригласить бота в свою закрытую групку либо куда пожелаете.
+Ubilling надає зручну модель абстракції, для роботи з повідомленнями [[https://core.telegram.org/api|бота Telegram]]. Починаючи зі стабільного релізу Ubilling 0.8.0 ви можете використовувати базовий клас UbillingTelegram для надсилання, приймання та читання повідомлень, прийнятих ботом. Для надсилання повідомлень потрібен токен заздалегідь [[https://tlgrm.ru/docs/bots|створеного бота]] і ввімкнена та налаштована підсистема [[senddog|собаки-посилаки]]. Так, ви можете запросити бота у свою закриту групку або куди забажаєте.
-API базового класса UbillingTelegram пытается повторять работу [[ubillingsms|UbillingSMS]] и быть максимально простым для понимания. Также вы можете одновременно работать с несколькими ботами, создав для каждого из них по экземпляру класса, либо на-ходу переключая их токены. Рассмотрим работу с ботом на простом примере:
+API базового класу UbillingTelegram намагається повторювати роботу [[ubillingsms|UbillingSMS]] і бути максимально простим для розуміння. Також ви можете одночасно працювати з кількома ботами, створивши для кожного з них по екземпляру класу, або на-ходу перемикаючи їхні токени. Розглянемо роботу з ботом на простому прикладі:
 <code php>
 $botToken = '123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11';
-// мы можем передавать токен нашего бота либо в конструкторе класса
+// ми можемо передавати токен нашого бота або в конструкторі класу
 $telegram = new UbillingTelegram($botToken);
-// либо принудительно выставить при помощи публичного метода setToken, например так:
+// або примусово виставити за допомогою публічного методу setToken, наприклад так:
 $telegram->setToken($botToken);
-// мы можем получить список контактов, ранее писавших боту либо в чаты в которые он приглашен
+// ми можемо отримати список контактів, які раніше писали боту або в чати, в які він запрошений
 $botContacts = $telegram->getBotContacts();
 debarr($botContacts);
-// Также мы можем поместить сообщение в очередь для дальнейшей посылки собакой-посылакой для одного из этих chatid.
+// Також ми можемо помістити повідомлення в чергу для подальшого надсилання собакою-посилакой для одного з цих chatid.
-// Рекомендуется использовать этот метод в ваших модулях.
+// Рекомендується використовувати цей метод у ваших модулях.
 $chatId = '-1001070840004';
-$telegram->sendMessage($chatId, 'это тестовое сообщение', false, 'SAMPLEMODULE');
+$telegram->sendMessage($chatId, 'це тестове повідомлення', false, 'SAMPLEMODULE');
-// Далее, если потребуется мы можем работать с очередью сообщений.
+// Далі, якщо буде потрібно, ми можемо працювати з чергою повідомлень.
-// например получить количество сообщений ожидающих отправки
+// наприклад отримати кількість повідомлень, які очікують на відправлення
 $queueCount=$telegram->getQueueCount();
 deb($queueCount);
-//или содержимое этой очереди в виде массива
+//або вміст цієї черги у вигляді масиву
 $queueData=$telegram->getQueueData();
 debarr($queueData);
-//также нам никто не запрещает почитать какие же приватные или сообщения канала получал бот:
+//Також нам ніхто не забороняє почитати, які ж приватні або повідомлення каналу отримував бот:
 $botChats=$telegram->getBotChats();
 debarr($botChats);
-// Если нам требуется отправка сообщения от имени бота отличного от настроенного в собаке-посылаке,
+// Якщо нам потрібне надсилання повідомлення від імені бота, відмінного від налаштованого в собаці-посилаці,
-// мы можем принудительно инициализировать посылку сообщения в обход очереди при помощи публичного метода "прямо щас"
+// ми можемо примусово ініціалізувати надсилання повідомлення в обхід черги за допомогою публічного методу "прямо зараз"
 $telegram->directPushMessage($chatId, 'это тоже тестовое сообщение посланное напрямую');
 </code>
-Также в Ubilling 1.0.2 появилась возможность включить режим отладки, чтобы видеть запросы и ответы на них от сервера API:
+Також є можливість увімкнути режим налагодження, щоб бачити запити і відповіді на них від сервера API:
 <code php>
 $telegram->setDebug(true);
@@ Рядок 45: / Рядок 45: @@
-А также отсылать данные о местонахождении контактам вашего бота. Пример:
+А також відсилати дані про місцезнаходження контактам вашого бота. Приклад:
 <code php>
-$testText = 'sendLocation:50.45093260638449, 30.52267174950622'; // да, формат сообщения "sendLocation:координаты"
+$testText = 'sendLocation:50.45093260638449, 30.52267174950622'; // так, формат повідомлення "sendLocation:координати"
 $telegram->sendMessage($chatid, $testText);
 </code>
-А можно не просто данные о местонахождении, а также с заголовком и адресом:
+А можна не просто дані про місцезнаходження, а також із заголовком і адресою:
 <code php>
 $message='title:{Налаштувати роутер}address:(Де бабайко каже надобраніч)sendVenue:[50.45093260638449, 30.52267174950622]';
@@ Рядок 57: / Рядок 57: @@
 </code>
-Да, все поля и формат скобочек строго обязательны.
+Так, усі поля і формат дужок суворо обов'язкові.
-А еще начиная с Ubilling 1.0.5 можно устанавливать кастомную разметку для ваших сообщений. Например использовать HTML. Например так:
+А ще можна встановлювати кастомну розмітку для ваших повідомлень. Наприклад використовувати HTML. Наприклад так:
 <code php>
- $message='Просто текст <b>жирный текст</b> <a href="http://ubilling.net.ua">Ссылка на сайт</a> parseMode:{html}';
+ $message='Просто текст <b>жирний текст</b> <a href="http://ubilling.net.ua">Посилання на сайт</a> parseMode:{html}';
  $telegram->directPushMessage($chatid, $message);
 </code>
-Начиная с Ubilling 1.0.9 также поддерживается посылка фоточек контактам бота. Формат посылки фоточек следующий:
+Формат надсилання фоточок наступний:
 <code php>
-$message = 'sendPhoto:[http://piclod.com/i/1592634849/CEYG67MWEAEsvwa.jpeg]{Это опциональный заголовок}';
+$message = 'sendPhoto:[https://piclod.com/i/1737542661/kitty.jpg]{Це опціональний заголовок}';
 $telegram->sendMessage($chatId, $message);
 </code>
-Начиная с Ubilling 1.1.4 вы можете использовать для ваших ботов кастомные клавиатуры. Для этого клавиатура собранная из массива при помощи **makeKeyboard** тупо отсылается при помощи **directPushMessage**. Как-то так:
+Також ви можете використовувати для ваших ботів кастомні клавіатури. Для цього клавіатуру, зібрану з масиву за допомогою **makeKeyboard**, тупо відсилають за допомогою **directPushMessage**. Якось так:
 <code php>
-        $buttonsArray[] = array('кнопка раз', 'кнопка рядом');
+        $buttonsArray[] = array('кнопка раз', 'кнопка поруч');
         $buttonsArray[] = array('кнопка внизу');
         $keyboard = $telegram->makeKeyboard($buttonsArray, false, true, true);
-        $telegram->directPushMessage($chatid, 'Здесь клавиатура вылезла!', $keyboard);
+        $telegram->directPushMessage($chatid, 'Тут клавіатура вилізла!', $keyboard);
 </code>
-Принудительно ее убить можно в свою очередь, используя сообщение, содержащее текст вида "removeKeyboard:тут текст сообщения"
+Примусово її вбити можна зі свого боку, використовуючи повідомлення, що містить текст вигляду "removeKeyboard:тут текст повідомлення"
 <code php>
- $telegram->directPushMessage($chatid, 'removeKeyboard:ой всё');
+ $telegram->directPushMessage($chatid, 'removeKeyboard:ой ну і добре');
 </code>
+Також можна банити та розбанювати користувачів в групових чатах:
+<code php>
+ $telegram->directPushMessage($groupId, 'banChatMember:[' . $memberId . '@' . $groupId . ']');
+</code>
+<code php>
+ $telegram->directPushMessage($groupId, 'unbanChatMember:[' . $memberId . '@' . $groupId . ']');
+</code>

Ubilling Wiki

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

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

Розбіжності

Налаштування сторінки