Add new InputMedia types and complete existing ones.

src/Entities/InputMedia/InputMediaAnimation.php

+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <akalongman@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Entities\InputMedia;
+
+use Longman\TelegramBot\Entities\Entity;
+
+/**
+ * Class InputMediaAnimation
+ *
+ * @link https://core.telegram.org/bots/api#inputmediaanimation
+ *
+ * <code>
+ * $data = [
+ *   'media'      => '123abc',
+ *   'thumb'      => '456def',
+ *   'caption'    => '*Animation* caption',
+ *   'parse_mode' => 'markdown',
+ *   'width'      => 200,
+ *   'height'     => 150,
+ *   'duration'   => 11,
+ * ];
+ * </code>
+ *
+ * @method string getType()      Type of the result, must be animation
+ * @method string getMedia()     File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »
+ * @method string getThumb()     Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »
+ * @method string getCaption()   Optional. Caption of the animation to be sent, 0-200 characters
+ * @method string getParseMode() Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
+ * @method int    getWidth()     Optional. Animation width
+ * @method int    getHeight()    Optional. Animation height
+ * @method int    getDuration()  Optional. Animation duration
+ *
+ * @method $this setMedia(string $media)           File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »
+ * @method $this setThumb(string $thumb) Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »
+ * @method $this setCaption(string $caption)       Optional. Caption of the animation to be sent, 0-200 characters
+ * @method $this setParseMode(string $parse_mode)  Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
+ * @method $this setWidth(int $width)              Optional. Animation width
+ * @method $this setHeight(int $height)            Optional. Animation height
+ * @method $this setDuration(int $duration)        Optional. Animation duration
+ */
+class InputMediaAnimation extends Entity implements InputMedia
+{
+    /**
+     * InputMediaAnimation constructor
+     *
+     * @param array $data
+     *
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function __construct(array $data = [])
+    {
+        $data['type'] = 'animation';
+        parent::__construct($data);
+    }
+}

src/Entities/InputMedia/InputMediaAudio.php

+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <akalongman@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Entities\InputMedia;
+
+use Longman\TelegramBot\Entities\Entity;
+
+/**
+ * Class InputMediaAudio
+ *
+ * @link https://core.telegram.org/bots/api#inputmediaaudio
+ *
+ * <code>
+ * $data = [
+ *   'media'      => '123abc',
+ *   'thumb'      => '456def',
+ *   'caption'    => '*Audio* caption',
+ *   'parse_mode' => 'markdown',
+ *   'duration'   => 42,
+ *   'performer'  => 'John Doe',
+ *   'title'      => 'The Song',
+ * ];
+ * </code>
+ *
+ * @method string getType()      Type of the result, must be audio
+ * @method string getMedia()     File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
+ * @method string getThumb()     Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »
+ * @method string getCaption()   Optional. Caption of the audio to be sent, 0-200 characters
+ * @method string getParseMode() Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
+ * @method int    getDuration()  Optional. Duration of the audio in seconds
+ * @method string getPerformer() Optional. Performer of the audio
+ * @method string getTitle()     Optional. Title of the audio
+ *
+ * @method $this setMedia(string $media)          File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
+ * @method $this setThumb(string $thumb)          Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »
+ * @method $this setCaption(string $caption)      Optional. Caption of the audio to be sent, 0-200 characters
+ * @method $this setParseMode(string $parse_mode) Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
+ * @method $this setDuration(int $duration)       Optional. Duration of the audio in seconds
+ * @method $this setPerformer(string $performer)  Optional. Performer of the audio
+ * @method $this setTitle(string $title)          Optional. Title of the audio
+ */
+class InputMediaAudio extends Entity implements InputMedia
+{
+    /**
+     * InputMediaAudio constructor
+     *
+     * @param array $data
+     *
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function __construct(array $data = [])
+    {
+        $data['type'] = 'audio';
+        parent::__construct($data);
+    }
+}

src/Entities/InputMedia/InputMediaDocument.php

+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <akalongman@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Entities\InputMedia;
+
+use Longman\TelegramBot\Entities\Entity;
+
+/**
+ * Class InputMediaDocument
+ *
+ * @link https://core.telegram.org/bots/api#inputmediadocument
+ *
+ * <code>
+ * $data = [
+ *   'media'      => '123abc',
+ *   'thumb'      => '456def',
+ *   'caption'    => '*Document* caption',
+ *   'parse_mode' => 'markdown',
+ * ];
+ * </code>
+ *
+ * @method string getType()      Type of the result, must be document
+ * @method string getMedia()     File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
+ * @method string getThumb()     Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »
+ * @method string getCaption()   Optional. Caption of the document to be sent, 0-200 characters
+ * @method string getParseMode() Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
+ *
+ * @method $this setMedia(string $media)          File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
+ * @method $this setThumb(string $thumb)          Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »
+ * @method $this setCaption(string $caption)      Optional. Caption of the document to be sent, 0-200 characters
+ * @method $this setParseMode(string $parse_mode) Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
+ */
+class InputMediaDocument extends Entity implements InputMedia
+{
+    /**
+     * InputMediaDocument constructor
+     *
+     * @param array $data
+     *
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function __construct(array $data = [])
+    {
+        $data['type'] = 'document';
+        parent::__construct($data);
+    }
+}

src/Entities/InputMedia/InputMediaPhoto.php

@@ -19,17 +19,20 @@ use Longman\TelegramBot\Entities\Entity;
  *
  * <code>
  * $data = [
- *   'media'   => '123abc',
- *   'caption' => 'Photo caption',
+ *   'media'      => '123abc',
+ *   'caption'    => '*Photo* caption',
+ *   'parse_mode' => 'markdown',
  * ];
  * </code>
  *
- * @method string getType()    Type of the result, must be photo
- * @method string getMedia()   File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
- * @method string getCaption() Optional. Caption of the photo to be sent, 0-200 characters
+ * @method string getType()      Type of the result, must be photo
+ * @method string getMedia()     File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
+ * @method string getCaption()   Optional. Caption of the photo to be sent, 0-200 characters
+ * @method string getParseMode() Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
  *
- * @method $this setMedia(string $media)     File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
- * @method $this setCaption(string $caption) Optional. Caption of the photo to be sent, 0-200 characters
+ * @method $this setMedia(string $media)          File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
+ * @method $this setCaption(string $caption)      Optional. Caption of the photo to be sent, 0-200 characters
+ * @method $this setParseMode(string $parse_mode) Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
  */
 class InputMediaPhoto extends Entity implements InputMedia
 {

src/Entities/InputMedia/InputMediaVideo.php

@@ -20,24 +20,30 @@ use Longman\TelegramBot\Entities\Entity;
  * <code>
  * $data = [
  *   'media'              => '123abc',
- *   'caption'            => 'Video caption (streamable)',
+ *   'thumb'              => '456def',
+ *   'caption'            => '*Video* caption (streamable)',
+ *   'parse_mode'         => 'markdown',
  *   'width'              => 800,
  *   'height'             => 600,
  *   'duration'           => 42,
- *   'supports_streaming' => true
+ *   'supports_streaming' => true,
  * ];
  * </code>
  *
  * @method string getType()              Type of the result, must be video
  * @method string getMedia()             File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
+ * @method string getThumb()             Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »
  * @method string getCaption()           Optional. Caption of the video to be sent, 0-200 characters
+ * @method string getParseMode()         Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
  * @method int    getWidth()             Optional. Video width
  * @method int    getHeight()            Optional. Video height
  * @method int    getDuration()          Optional. Video duration
  * @method bool   getSupportsStreaming() Optional. Pass True, if the uploaded video is suitable for streaming
  *
  * @method $this setMedia(string $media)                        File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name.
+ * @method $this setThumb(string $thumb)                        Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail‘s width and height should not exceed 90. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »
  * @method $this setCaption(string $caption)                    Optional. Caption of the video to be sent, 0-200 characters
+ * @method $this setParseMode(string $parse_mode)               Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
  * @method $this setWidth(int $width)                           Optional. Video width
  * @method $this setHeight(int $height)                         Optional. Video height
  * @method $this setDuration(int $duration)                     Optional. Video duration