Instead of deleting existing commands, add deprecation notice to preserve backwards compatibility.

Author: noplanman

CHANGELOG.md

@@ -9,6 +9,7 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 - All Message field types dynamically search for an existing Command class that can handle them.
 ### Deprecated
 - Botan.io service has been discontinued.
+- Most built-in System Commands will be handled by GenericmessageCommand by default in a future release and will require a custom implementation.
 ### Removed
 ### Fixed
 ### Security

src/Commands/SystemCommands/ChannelchatcreatedCommand.php

@@ -0,0 +1,52 @@
+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Commands\SystemCommands;
+
+use Longman\TelegramBot\Commands\SystemCommand;
+
+/**
+ * Channel chat created command
+ *
+ * @todo Remove due to deprecation!
+ */
+class ChannelchatcreatedCommand extends SystemCommand
+{
+    /**
+     * @var string
+     */
+    protected $name = 'channelchatcreated';
+
+    /**
+     * @var string
+     */
+    protected $description = 'Channel chat created';
+
+    /**
+     * @var string
+     */
+    protected $version = '1.0.0';
+
+    /**
+     * Command execute method
+     *
+     * @return mixed
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function execute()
+    {
+        //$message = $this->getMessage();
+        //$channel_chat_created = $message->getChannelChatCreated();
+
+        trigger_error(__CLASS__ . ' is deprecated and will be removed and handled by ' . GenericmessageCommand::class . ' by default in a future release.', E_USER_DEPRECATED);
+
+        return parent::execute();
+    }
+}

src/Commands/SystemCommands/ChannelpostCommand.php

@@ -0,0 +1,51 @@
+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Commands\SystemCommands;
+
+use Longman\TelegramBot\Commands\SystemCommand;
+
+/**
+ * Channel post command
+ *
+ * @todo Remove due to deprecation!
+ */
+class ChannelpostCommand extends SystemCommand
+{
+    /**
+     * @var string
+     */
+    protected $name = 'channelpost';
+
+    /**
+     * @var string
+     */
+    protected $description = 'Handle channel post';
+
+    /**
+     * @var string
+     */
+    protected $version = '1.0.0';
+
+    /**
+     * Execute command
+     *
+     * @return mixed
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function execute()
+    {
+        //$channel_post = $this->getUpdate()->getChannelPost();
+
+        trigger_error(__CLASS__ . ' is deprecated and will be removed and handled by ' . GenericmessageCommand::class . ' by default in a future release.', E_USER_DEPRECATED);
+
+        return parent::execute();
+    }
+}

src/Commands/SystemCommands/ChoseninlineresultCommand.php

@@ -0,0 +1,54 @@
+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Commands\SystemCommands;
+
+use Longman\TelegramBot\Commands\SystemCommand;
+
+/**
+ * Chosen inline result command
+ *
+ * @todo Remove due to deprecation!
+ */
+class ChoseninlineresultCommand extends SystemCommand
+{
+    /**
+     * @var string
+     */
+    protected $name = 'choseninlineresult';
+
+    /**
+     * @var string
+     */
+    protected $description = 'Chosen result query';
+
+    /**
+     * @var string
+     */
+    protected $version = '1.0.0';
+
+    /**
+     * Command execute method
+     *
+     * @return mixed
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function execute()
+    {
+        //Information about chosen result is returned
+        //$update = $this->getUpdate();
+        //$inline_query = $update->getChosenInlineResult();
+        //$query = $inline_query->getQuery();
+
+        trigger_error(__CLASS__ . ' is deprecated and will be removed and handled by ' . GenericmessageCommand::class . ' by default in a future release.', E_USER_DEPRECATED);
+
+        return parent::execute();
+    }
+}

src/Commands/SystemCommands/DeletechatphotoCommand.php

@@ -0,0 +1,52 @@
+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Commands\SystemCommands;
+
+use Longman\TelegramBot\Commands\SystemCommand;
+
+/**
+ * Delete chat photo command
+ *
+ * @todo Remove due to deprecation!
+ */
+class DeletechatphotoCommand extends SystemCommand
+{
+    /**
+     * @var string
+     */
+    protected $name = 'deletechatphoto';
+
+    /**
+     * @var string
+     */
+    protected $description = 'Delete chat photo';
+
+    /**
+     * @var string
+     */
+    protected $version = '1.0.0';
+
+    /**
+     * Command execute method
+     *
+     * @return mixed
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function execute()
+    {
+        //$message = $this->getMessage();
+        //$delete_chat_photo = $message->getDeleteChatPhoto();
+
+        trigger_error(__CLASS__ . ' is deprecated and will be removed and handled by ' . GenericmessageCommand::class . ' by default in a future release.', E_USER_DEPRECATED);
+
+        return parent::execute();
+    }
+}

src/Commands/SystemCommands/EditedchannelpostCommand.php

@@ -0,0 +1,51 @@
+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Commands\SystemCommands;
+
+use Longman\TelegramBot\Commands\SystemCommand;
+
+/**
+ * Edited channel post command
+ *
+ * @todo Remove due to deprecation!
+ */
+class EditedchannelpostCommand extends SystemCommand
+{
+    /**
+     * @var string
+     */
+    protected $name = 'editedchannelpost';
+
+    /**
+     * @var string
+     */
+    protected $description = 'Handle edited channel post';
+
+    /**
+     * @var string
+     */
+    protected $version = '1.0.0';
+
+    /**
+     * Execute command
+     *
+     * @return mixed
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function execute()
+    {
+        //$edited_channel_post = $this->getUpdate()->getEditedChannelPost();
+
+        trigger_error(__CLASS__ . ' is deprecated and will be removed and handled by ' . GenericmessageCommand::class . ' by default in a future release.', E_USER_DEPRECATED);
+
+        return parent::execute();
+    }
+}

src/Commands/SystemCommands/EditedmessageCommand.php

@@ -0,0 +1,52 @@
+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Commands\SystemCommands;
+
+use Longman\TelegramBot\Commands\SystemCommand;
+
+/**
+ * Edited message command
+ *
+ * @todo Remove due to deprecation!
+ */
+class EditedmessageCommand extends SystemCommand
+{
+    /**
+     * @var string
+     */
+    protected $name = 'editedmessage';
+
+    /**
+     * @var string
+     */
+    protected $description = 'User edited message';
+
+    /**
+     * @var string
+     */
+    protected $version = '1.0.0';
+
+    /**
+     * Command execute method
+     *
+     * @return mixed
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function execute()
+    {
+        //$update = $this->getUpdate();
+        //$edited_message = $update->getEditedMessage();
+
+        trigger_error(__CLASS__ . ' is deprecated and will be removed and handled by ' . GenericmessageCommand::class . ' by default in a future release.', E_USER_DEPRECATED);
+
+        return parent::execute();
+    }
+}

src/Commands/SystemCommands/GroupchatcreatedCommand.php

@@ -0,0 +1,52 @@
+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Commands\SystemCommands;
+
+use Longman\TelegramBot\Commands\SystemCommand;
+
+/**
+ * Group chat created command
+ *
+ * @todo Remove due to deprecation!
+ */
+class GroupchatcreatedCommand extends SystemCommand
+{
+    /**
+     * @var string
+     */
+    protected $name = 'groupchatcreated';
+
+    /**
+     * @var string
+     */
+    protected $description = 'Group chat created';
+
+    /**
+     * @var string
+     */
+    protected $version = '1.0.0';
+
+    /**
+     * Command execute method
+     *
+     * @return mixed
+     * @throws \Longman\TelegramBot\Exception\TelegramException
+     */
+    public function execute()
+    {
+        //$message = $this->getMessage();
+        //$group_chat_created = $message->getGroupChatCreated();
+
+        trigger_error(__CLASS__ . ' is deprecated and will be removed and handled by ' . GenericmessageCommand::class . ' by default in a future release.', E_USER_DEPRECATED);
+
+        return parent::execute();
+    }
+}