Merge remote-tracking branch 'origin/main'

Author: ZhenyaGR

llms-full.txt

@@ -9,10 +9,10 @@ description: Ограничивает доступ к маршруту по ID 
 
 ## Параметры
 
-| # |  Название   |        Тип         | Описание                                                 |
-|:-:|:-----------:|:------------------:|:---------------------------------------------------------|
-| 1 |   **ids**   |   `int`|`array`   | ID-пользователей, которые смогут использовать обработчик |
-| 2 | **handler** | `callable`|`null` | Анонимная функция-обработчик                             |
+| # |  Название   |           Тип            | Описание                                                 |
+|:-:|:-----------:|:------------------------:|:---------------------------------------------------------|
+| 1 |   **ids**   | `int`|`string`|`array` | ID-пользователей, которые смогут использовать обработчик |
+| 2 | **handler** |    `callable`|`null`    | Анонимная функция-обработчик                             |
 
 ## Возвращает
 
@@ -398,13 +398,6 @@ $bot->onBotCommand('/audioPath')->func(function(ZG $tg) {
         ->send();
 });
 
-$bot->onBotCommand('/audioPath')->func(function(ZG $tg) {
-    $audio_path = "media/audio.mp3";
-    $tg->msg("Отправка сообщения с аудио по локальному пути") 
-        ->audio($audio_path)
-        ->send();
-});
-
 $bot->onBotCommand('/audioArray')->func(function(ZG $tg) {
     $audio_url1 = $audio_url2 = "https://example.com/audio.mp3";
     $tg->msg('Отправка сообщения с массивом аудио-файлов')
@@ -449,7 +442,6 @@ description: Конструктор для создания логики бот
 ```php
 <?php
 require_once __DIR__ . '/vendor/autoload.php';
-
 use ZenithGram\ZenithGram\ZG;
 use ZenithGram\ZenithGram\Bot;
 
@@ -467,16 +459,16 @@ $bot->run();
 ```php
 <?php
 require_once __DIR__ . '/vendor/autoload.php';
-
 use ZenithGram\ZenithGram\LongPoll;
 use ZenithGram\ZenithGram\ZG;
 use ZenithGram\ZenithGram\Bot;
 
 $lp = LongPoll::create(BOT_TOKEN);
 $bot = new Bot(); // Сразу не передаем ZG
+
 // ... здесь вся логика вашего бота ...
 
-$lp->listen(function(ZG $tg) {
+$lp->listen(function(ZG $tg) use ($bot) {
     $bot->zg($tg)->run();
 });
 ```
@@ -492,7 +484,6 @@ $lp->listen(function(ZG $tg) {
 ```php
 <?php
 require_once __DIR__ . '/vendor/autoload.php';
-
 use ZenithGram\ZenithGram\ZG;
 use ZenithGram\ZenithGram\Bot;
 
@@ -836,10 +827,6 @@ description: Копирует сообщение из одного чата в 
 | 3 | **from\_chat\_id** | `int\|string\|null` | **Откуда** копировать. По умолчанию - текущий чат.                                             |
 | 4 |    **params**    |       `array`       | Дополнительные параметры (`caption`, `parse_mode`, `reply_markup`, `message_thread_id` и др.). |
 
-::: tip Примечание
-Параметр `caption` (подпись) работает только при копировании **одного** сообщения. При копировании массива сообщений Telegram API не поддерживает добавление новой подписи.
-:::
-
 ## Возвращает
 
 `array` - массив с ответом от Telegram (результат метода `copyMessage` или `copyMessages`).
@@ -1903,9 +1890,9 @@ $tg->enableDebug()
 
 ### Параметры метода
 
-| # | Название   | Тип      | Описание                                  |
-|:-:|:-----------|:---------|-------------------------------------------|
-| 1 | **pathes** | `string` | Один путь для фильтрации.                 |
+| # | Название | Тип      | Описание                                  |
+|:-:|:---------|:---------|-------------------------------------------|
+| 1 | **path** | `string` | Один путь для фильтрации.                 |
 
 ### Возвращает
 
@@ -2988,6 +2975,12 @@ description: >-
 
 Метод принимает переменные по ссылке и записывает в них определенные значения из пришедшего от Telegram события, если они доступны. Если данные не пришли, то в переменные будет передан `null`
 
+:::warning Устаревший метод
+Вместо это метода предпочтительно использовать get-методы.
+
+Синтаксис через ссылку устарел.
+:::
+
 ### Параметры метода
 
 | # |       Название |       Тип       |                Будет передан                |
@@ -4079,10 +4072,10 @@ description: Запрещает доступ к маршруту по ID пол
 
 ## Параметры
 
-| # |  Название   |        Тип         |                          Описание                           |
-|:-:|:-----------:|:------------------:|:-----------------------------------------------------------:|
-| 1 |   **ids**   |   `int`|`array`   | ID-пользователей, которые не смогут использовать обработчик |
-| 2 | **handler** | `callable`|`null` |                Анонимная функция-обработчик                 |
+| # |  Название   |           Тип            |                          Описание                           |
+|:-:|:-----------:|:------------------------:|:-----------------------------------------------------------:|
+| 1 |   **ids**   | `int`|`string`|`array` | ID-пользователей, которые не смогут использовать обработчик |
+| 2 | **handler** |    `callable`|`null`    |                Анонимная функция-обработчик                 |
 
 ## Возвращает
 
@@ -4276,7 +4269,7 @@ $bot->onBotCommand('vote', '/vote')
 // Обработчик для callback_data 'vote_yes'
 $bot->onCallback('handle_vote_yes', 'vote_yes')
     ->query('Спасибо за ваш голос!') // Всплывающее уведомление
-    ->edit('Вы проголосовали "Да". Отлично!'); // Редактируем исходное сообщение
+    ->editText('Вы проголосовали "Да". Отлично!'); // Редактируем исходное сообщение
 
 // Обработчик для callback_data 'vote_no'
 $bot->onCallback('handle_vote_no', 'vote_no')
@@ -4286,6 +4279,40 @@ $bot->onCallback('handle_vote_no', 'vote_no')
 $bot->run();
 ```
 
+## Пример с плейсхолдером
+
+```php
+<?php
+require_once __DIR__ . '/vendor/autoload.php';
+use ZenithGram\ZenithGram\ZG;
+use ZenithGram\ZenithGram\Bot;
+use ZenithGram\ZenithGram\Button;
+
+$tg = ZG::create(BOT_TOKEN);
+$bot = new Bot($tg);
+
+$bot->onBotCommand('vote', '/vote')
+    ->text('Вам нравится эта библиотека?')
+    ->inlineKbd([
+        [
+            Button::cb('Да 👍', 'vote_yes'),
+            Button::cb('Нет 👎', 'vote_no'),
+        ],
+    ]);
+
+$bot->onCallback('handle_vote', 'vote_{voted}')
+    ->func(function(ZG $tg, string $voted) {
+        $tg->answerCallbackQuery(['text' => 'Спасибо за ваш голос!']);
+        if ($voted === 'yes') {
+            $tg->msg('Вы проголосовали "Да". Отлично!')->editText();
+        } else {
+            $tg->msg('Вы проголосовали "Нет". Жаль!')->editText();
+        }
+    });
+
+$bot->run();
+```
+
 ---
 
 ---
@@ -4370,10 +4397,10 @@ description: Обработчик кастомных команд с подде
 
 ## Параметры
 
-| # |   Название  |      Тип       | Описание                                                                                                  |
-|:-:|:-----------:|:--------------:|:----------------------------------------------------------------------------------------------------------|
-| 1 | **id**      | `string`       | Уникальный идентификатор для этого маршрута.                                                                |
-| 2 | **command** | `string`|`array` | Шаблон команды или массив шаблонов. Если не указан, используется `id`.                                      |
+| # |  Название   |        Тип        | Описание                                                               |
+|:-:|:-----------:|:-----------------:|:-----------------------------------------------------------------------|
+| 1 |   **id**    |     `string`      | Уникальный идентификатор для этого маршрута.                           |
+| 2 | **command** | `string`|`array` | Шаблон команды или массив шаблонов. Если не указан, используется `id`. |
 
 ## Возвращает