feat: #465 add Link Preview Customization support as defined in api 7.0

Author: bernard-ng

CHANGELOG.md

@@ -20,6 +20,10 @@ All Notable changes to `PHP Telegram Bot Api` will be documented in this file
 - Add `\TelegramBot\Api\Types\Update::$messageReactionCount` field
 - Add `\TelegramBot\Api\BotApi::setMessageReaction` api method
 
+### Deprecated
+- Deprecate `reply_to_message_id` and `allow_sending_without_reply` parameters to `\TelegramBot\Api\BotApi` methods. Use `reply_parameters` instead.
+- Deprecate `disable_web_page_preview` parameter to `\TelegramBot\Api\BotApi` methods. Use `link_preview_options` instead.
+
 ## 2.5.0 - 2023-08-09
 
 ### Added

src/BaseType.php

@@ -40,7 +40,7 @@ public static function validate($data)
         }
 
         $missingParams = implode(', ', array_diff(static::$requiredParams, array_keys($data)));
-        throw new InvalidArgumentException(sprintf("Validation failed. Missing required parameters: %s", $missingParams));
+        throw new InvalidArgumentException(sprintf('Validation failed. Missing required parameters: %s', $missingParams));
     }
 
     /**

src/BotApi.php

@@ -9,6 +9,8 @@
 namespace TelegramBot\Api\Types\Inline\InputMessageContent;
 
 use TelegramBot\Api\TypeInterface;
+use TelegramBot\Api\Types\LinkPreviewOptions;
+use TelegramBot\Api\Types\ArrayOfMessageEntity;
 use TelegramBot\Api\Types\Inline\InputMessageContent;
 
 /**
@@ -35,7 +37,9 @@ class Text extends InputMessageContent implements TypeInterface
     protected static $map = [
         'message_text' => true,
         'parse_mode' => true,
-        'disable_web_page_preview' => true,
+        'entities' => ArrayOfMessageEntity::class,
+        'disable_web_page_preview' => true, // @todo: remove as deprecated with bot api 7.0
+        'link_preview_options' => LinkPreviewOptions::class
     ];
 
     /**
@@ -54,23 +58,42 @@ class Text extends InputMessageContent implements TypeInterface
     protected $parseMode;
 
     /**
+     * @deprecated use $linkPreviewOptions instead
      * Optional. Disables link previews for links in the sent message
      *
      * @var bool|null
      */
     protected $disableWebPagePreview;
 
+    /**
+     * Link preview generation options for the message
+     *
+     * @var LinkPreviewOptions|null
+     */
+    protected $linkPreviewOptions;
+
     /**
      * Text constructor.
+     *
      * @param string $messageText
      * @param string|null $parseMode
      * @param bool $disableWebPagePreview
+     * @param LinkPreviewOptions|null $linkPreviewOptions Link preview generation options for the message.
      */
-    public function __construct($messageText, $parseMode = null, $disableWebPagePreview = false)
+    public function __construct($messageText, $parseMode = null, $disableWebPagePreview = false, $linkPreviewOptions = null)
     {
         $this->messageText = $messageText;
         $this->parseMode = $parseMode;
         $this->disableWebPagePreview = $disableWebPagePreview;
+
+        if (null === $linkPreviewOptions && false !== $disableWebPagePreview) {
+            @trigger_error('setting $disableWebPagePreview is now deprecated use $linkPreviewOptions instead', E_USER_DEPRECATED);
+
+            $this->linkPreviewOptions = new LinkPreviewOptions();
+            $this->linkPreviewOptions->map([
+                'is_disabled' => $disableWebPagePreview
+            ]);
+        }
     }
 
     /**
@@ -126,4 +149,21 @@ public function setDisableWebPagePreview($disableWebPagePreview)
     {
         $this->disableWebPagePreview = $disableWebPagePreview;
     }
+
+    /**
+     * @return LinkPreviewOptions|null
+     */
+    public function getLinkPreviewOptions()
+    {
+        return $this->linkPreviewOptions;
+    }
+
+    /**
+     * @param LinkPreviewOptions|null $linkPreviewOptions
+     * @return void
+     */
+    public function setLinkPreviewOptions($linkPreviewOptions)
+    {
+        $this->linkPreviewOptions = $linkPreviewOptions;
+    }
 }

src/Types/Inline/InputMessageContent/Text.php

@@ -23,10 +23,10 @@ public function testFromResponse()
         ]);
 
         $expected = [
-           ReactionTypeEmoji::fromResponse([
-               'emoji' => '👍',
-               'type' => 'emoji'
-           ]),
+            ReactionTypeEmoji::fromResponse([
+                'emoji' => '👍',
+                'type' => 'emoji'
+            ]),
             ReactionTypeCustomEmoji::fromResponse([
                 'custom_emoji_id' => 'custom_emoji_123',
                 'type' => 'custom_emoji'

tests/Types/ArrayOfReactionTypeTest.php

@@ -36,7 +36,6 @@ public static function getFullResponse()
         ];
     }
 
-
     protected function assertMinItem($item)
     {
         $this->assertEquals(ChatTest::createMinInstance(), $item->getChat());

tests/Types/MessageReactionCountUpdatedTest.php

@@ -39,7 +39,7 @@ public static function getFullResponse()
                 ReactionTypeEmojiTest::getMinResponse()
             ],
             'new_reaction' => [
-                 ReactionTypeCustomEmojiTest::getMinResponse()
+                ReactionTypeCustomEmojiTest::getMinResponse()
             ]
         ];
     }
@@ -50,7 +50,7 @@ protected function assertMinItem($item)
         $this->assertEquals(1, $item->getMessageId());
         $this->assertEquals(1682343644, $item->getDate());
         $this->assertEquals([ReactionTypeEmojiTest::createMinInstance()], $item->getOldReaction());
-        $this->assertEquals([ReactionTypeCustomEmojiTest::createMinInstance()],$item->getNewReaction());
+        $this->assertEquals([ReactionTypeCustomEmojiTest::createMinInstance()], $item->getNewReaction());
 
         $this->assertNull($item->getUser());
         $this->assertNull($item->getActorChat());
@@ -63,6 +63,6 @@ protected function assertFullItem($item)
         $this->assertEquals(UserTest::createMinInstance(), $item->getUser());
         $this->assertEquals(ChatTest::createMinInstance(), $item->getActorChat());
         $this->assertEquals([ReactionTypeEmojiTest::createMinInstance()], $item->getOldReaction());
-        $this->assertEquals([ReactionTypeCustomEmojiTest::createMinInstance()],$item->getNewReaction());
+        $this->assertEquals([ReactionTypeCustomEmojiTest::createMinInstance()], $item->getNewReaction());
     }
 }

tests/Types/MessageReactionUpdatedTest.php

@@ -3,8 +3,6 @@
 namespace TelegramBot\Api\Test\Types;
 
 use TelegramBot\Api\Test\AbstractTypeTest;
-use TelegramBot\Api\Types\MessageReactionUpdated;
-use TelegramBot\Api\Types\MessageReactionCountUpdated;
 use TelegramBot\Api\Test\Types\Inline\ChosenInlineResultTest;
 use TelegramBot\Api\Test\Types\Inline\InlineQueryTest;
 use TelegramBot\Api\Test\Types\Payments\Query\PreCheckoutQueryTest;