Merge pull request #425 from BoShurik/input_field_placeholder

ReplyKeyboardMarkup::$inputFieldPlaceholder

Author: BoShurik

CHANGELOG.md

@@ -9,6 +9,7 @@ All Notable changes to `PHP Telegram Bot Api` will be documented in this file
 - Add `scope` and `languageCode` parameters to `\TelegramBot\Api\BotApi::setMyCommands`
 - Add WebApp support: `\TelegramBot\Api\BotApi::answerWebAppQuery` method and `\TelegramBot\Api\Types\Message::$webAppData` property
 - Add `\TelegramBot\Api\Types\ReplyKeyboardMarkup::$isPersistent` property
+- Add `\TelegramBot\Api\Types\ReplyKeyboardMarkup::$inputFieldPlaceholder` property
 
 ### Fixed
 - Fix `\TelegramBot\Api\Collection\Collection::addItem` max count constraint (#333)

src/Types/ReplyKeyboardMarkup.php

@@ -29,7 +29,8 @@ class ReplyKeyboardMarkup extends BaseType
         'one_time_keyboard' => true,
         'resize_keyboard' => true,
         'selective' => true,
-        'is_persistent' => true
+        'is_persistent' => true,
+        'input_field_placeholder' => true,
     ];
 
     /**
@@ -74,20 +75,29 @@ class ReplyKeyboardMarkup extends BaseType
      */
     protected $isPersistent;
 
+    /**
+     * Optional. The placeholder to be shown in the input field when the keyboard is active; 1-64 characters
+     *
+     * @var string|null
+     */
+    protected $inputFieldPlaceholder;
+
     /**
      * @param array $keyboard
      * @param bool|null $oneTimeKeyboard
      * @param bool|null $resizeKeyboard
      * @param bool|null $selective
      * @param bool|null $isPersistent
+     * @param string|null $inputFieldPlaceholder
      */
-    public function __construct($keyboard = [], $oneTimeKeyboard = null, $resizeKeyboard = null, $selective = null, $isPersistent = null)
+    public function __construct($keyboard = [], $oneTimeKeyboard = null, $resizeKeyboard = null, $selective = null, $isPersistent = null, $inputFieldPlaceholder = null)
     {
         $this->keyboard = $keyboard;
         $this->oneTimeKeyboard = $oneTimeKeyboard;
         $this->resizeKeyboard = $resizeKeyboard;
         $this->selective = $selective;
         $this->isPersistent = $isPersistent;
+        $this->inputFieldPlaceholder = $inputFieldPlaceholder;
     }
 
     /**
@@ -174,4 +184,21 @@ public function setIsPersistent($isPersistent)
     {
         $this->isPersistent = $isPersistent;
     }
+
+    /**
+     * @return string|null
+     */
+    public function getInputFieldPlaceholder()
+    {
+        return $this->inputFieldPlaceholder;
+    }
+
+    /**
+     * @param string|null $inputFieldPlaceholder
+     * @return void
+     */
+    public function setInputFieldPlaceholder($inputFieldPlaceholder)
+    {
+        $this->inputFieldPlaceholder = $inputFieldPlaceholder;
+    }
 }

tests/Types/ReplyKeyboardMarkupTest.php

@@ -27,6 +27,7 @@ public static function getFullResponse()
             'resize_keyboard' => true,
             'selective' => true,
             'is_persistent' => true,
+            'input_field_placeholder' => 'input_field_placeholder',
         ];
     }
 
@@ -41,6 +42,7 @@ protected function assertMinItem($item)
         $this->assertNull($item->isResizeKeyboard());
         $this->assertNull($item->isSelective());
         $this->assertNull($item->getIsPersistent());
+        $this->assertNull($item->getInputFieldPlaceholder());
     }
 
     /**
@@ -54,17 +56,19 @@ protected function assertFullItem($item)
         $this->assertEquals(true, $item->isResizeKeyboard());
         $this->assertEquals(true, $item->isSelective());
         $this->assertEquals(true, $item->getIsPersistent());
+        $this->assertEquals('input_field_placeholder', $item->getInputFieldPlaceholder());
     }
 
     public function testConstructor()
     {
         $item = new ReplyKeyboardMarkup([['one', 'two']]);
 
         $this->assertEquals([['one', 'two']], $item->getKeyboard());
-        $this->assertEquals(null, $item->isOneTimeKeyboard());
-        $this->assertEquals(null, $item->isResizeKeyboard());
-        $this->assertEquals(null, $item->isSelective());
-        $this->assertEquals(null, $item->getIsPersistent());
+        $this->assertNull($item->isOneTimeKeyboard());
+        $this->assertNull($item->isResizeKeyboard());
+        $this->assertNull($item->isSelective());
+        $this->assertNull($item->getIsPersistent());
+        $this->assertNull($item->getInputFieldPlaceholder());
     }
 
     public function testConstructor2()
@@ -73,9 +77,10 @@ public function testConstructor2()
 
         $this->assertEquals([['one', 'two']], $item->getKeyboard());
         $this->assertEquals(true, $item->isOneTimeKeyboard());
-        $this->assertEquals(null, $item->isResizeKeyboard());
-        $this->assertEquals(null, $item->isSelective());
-        $this->assertEquals(null, $item->getIsPersistent());
+        $this->assertNull($item->isResizeKeyboard());
+        $this->assertNull($item->isSelective());
+        $this->assertNull($item->getIsPersistent());
+        $this->assertNull($item->getInputFieldPlaceholder());
     }
 
     public function testConstructor3()
@@ -85,8 +90,9 @@ public function testConstructor3()
         $this->assertEquals([['one', 'two']], $item->getKeyboard());
         $this->assertEquals(true, $item->isOneTimeKeyboard());
         $this->assertEquals(true, $item->isResizeKeyboard());
-        $this->assertEquals(null, $item->isSelective());
-        $this->assertEquals(null, $item->getIsPersistent());
+        $this->assertNull($item->isSelective());
+        $this->assertNull($item->getIsPersistent());
+        $this->assertNull($item->getInputFieldPlaceholder());
     }
 
     public function testConstructor4()
@@ -97,7 +103,8 @@ public function testConstructor4()
         $this->assertEquals(true, $item->isOneTimeKeyboard());
         $this->assertEquals(true, $item->isResizeKeyboard());
         $this->assertEquals(true, $item->isSelective());
-        $this->assertEquals(null, $item->getIsPersistent());
+        $this->assertNull($item->getIsPersistent());
+        $this->assertNull($item->getInputFieldPlaceholder());
     }
 
     public function testConstructor5()
@@ -109,5 +116,18 @@ public function testConstructor5()
         $this->assertEquals(true, $item->isResizeKeyboard());
         $this->assertEquals(true, $item->isSelective());
         $this->assertEquals(true, $item->getIsPersistent());
+        $this->assertNull($item->getInputFieldPlaceholder());
+    }
+
+    public function testConstructor6()
+    {
+        $item = new ReplyKeyboardMarkup([['one', 'two']], true, true, true, true, 'input_field_placeholder');
+
+        $this->assertEquals([['one', 'two']], $item->getKeyboard());
+        $this->assertEquals(true, $item->isOneTimeKeyboard());
+        $this->assertEquals(true, $item->isResizeKeyboard());
+        $this->assertEquals(true, $item->isSelective());
+        $this->assertEquals(true, $item->getIsPersistent());
+        $this->assertEquals('input_field_placeholder', $item->getInputFieldPlaceholder());
     }
 }