Feature/smartinterface

README.md

@@ -348,7 +348,7 @@ You can also store inline query and chosen inline query in the database.
 ### Channels Support
 
 All methods implemented can be used to manage channels.
-With [admin commands](#admin-commands) you can manage your channel directly with your bot private chat.
+With [admin commands](#admin-commands) you can manage your channels directly with your bot private chat.
 
 ### Commands
 
@@ -397,7 +397,7 @@ $telegram->setCommandConfig('date', ['google_api_key' => 'your_google_api_key_he
 Enabling this feature, the admin bot can perform some super user commands like:
 - Send message to all chats */sendtoall*
 - List all the chats started with the bot */chats*
-- Send a message to a channel */sendtochannel* (NEW! see below how to configure it)
+- Send a message to your channels */sendtochannel* (NEW! see below how to configure it)
 You can specify one or more admins with this option:
 
 ```php
@@ -414,7 +414,11 @@ To enable this feature follow these steps:
 - Enable admin interface for your user as explained in the admin section above.
 - Enter your channel name as a parameter for the */sendtochannel* command:
 ```php
-$telegram->setCommandConfig('sendtochannel', ['your_channel' => '@type_here_your_channel']);
+$telegram->setCommandConfig('sendtochannel', ['your_channel' => ['@type_here_your_channel']]);
+```
+- If you want to manage more channels:  
+```php
+$telegram->setCommandConfig('sendtochannel', ['your_channel'=>['@type_here_your_channel', '@type_here_another_channel', '@and_so_on']]);
 ```
 - Enjoy!
 

src/Commands/AdminCommands/SendtochannelCommand.php

@@ -10,12 +10,14 @@
 
 namespace Longman\TelegramBot\Commands\AdminCommands;
 
-use Longman\TelegramBot\Commands\AdminCommand;
 use Longman\TelegramBot\Request;
+use Longman\TelegramBot\Conversation;
+use Longman\TelegramBot\Commands\AdminCommand;
+use Longman\TelegramBot\Entities\Message;
+use Longman\TelegramBot\Entities\ReplyKeyboardHide;
+use Longman\TelegramBot\Entities\ReplyKeyboardMarkup;
+use Longman\TelegramBot\Exception\TelegramException;
 
-/**
- * Admin "/sendtochannel" command
- */
 class SendtochannelCommand extends AdminCommand
 {
     /**#@+
@@ -24,46 +26,309 @@ class SendtochannelCommand extends AdminCommand
     protected $name = 'sendtochannel';
     protected $description = 'Send message to a channel';
     protected $usage = '/sendtochannel <message to send>';
-    protected $version = '0.1.1';
-    protected $need_mysql = false;
+    protected $version = '0.1.4';
+    protected $need_mysql = true;
     /**#@-*/
 
     /**
-     * Execute command
+     * Conversation Object
      *
-     * @todo Don't use empty, as a string of '0' is regarded to be empty
-     *
-     * @return boolean
+     * @var Longman\TelegramBot\Conversation
+     */
+    protected $conversation;
+
+    /**
+     * {@inheritdoc}
      */
     public function execute()
     {
         $message = $this->getMessage();
+        $chat_id = $message->getChat()->getId();
+        $user_id = $message->getFrom()->getId();
+        $type = $message->getType();
+        // 'Cast' the command type into message this protect the machine state
+        // if the commmad is recolled when the conversation is already started
+        $type = ($type == 'command') ? 'Message' : $type;
+        $text = trim($message->getText(true));
+
+        $data = [];
+        $data['chat_id'] = $chat_id;
+
+        // Conversation
+        $this->conversation = new Conversation($user_id, $chat_id, $this->getName());
+
+        $channels = (array) $this->getConfig('your_channel');
+        if (!isset($this->conversation->notes['state'])) {
+            $state = (count($channels) == 0) ? -1 : 0;
+            $this->conversation->notes['last_message_id'] = $message->getMessageId();
+        } else {
+            $state = $this->conversation->notes['state'];
+        }
+        switch ($state) {
+            case -1:
+                // getConfig has not been configured asking for channel to administer
+                if ($type != 'Message' || empty($text)) {
+                    $this->conversation->notes['state'] = -1;
+                    $this->conversation->update();
+
+                    $data['text'] = 'Insert the channel name: (@yourchannel)';
+                    $data['reply_markup'] = new ReplyKeyBoardHide(['selective' => true]);
+                    $result = Request::sendMessage($data);
 
+                    break;
+                }
+                $this->conversation->notes['channel'] = $text;
+                $this->conversation->notes['last_message_id'] = $message->getMessageId();
+                // Jump to state 1
+                goto insert;
+
+                // no break
+            default:
+            case 0:
+                // getConfig has been configured choose channel
+                if ($type != 'Message' || !in_array($text, $channels)) {
+                    $this->conversation->notes['state'] = 0;
+                    $this->conversation->update();
+
+                    $keyboard = [];
+                    foreach ($channels as $channel) {
+                        $keyboard[] = [$channel];
+                    }
+                    $reply_keyboard_markup = new ReplyKeyboardMarkup(
+                        [
+                            'keyboard' => $keyboard ,
+                            'resize_keyboard' => true,
+                            'one_time_keyboard' => true,
+                            'selective' => true
+                        ]
+                    );
+                    $data['reply_markup'] = $reply_keyboard_markup;
+                    $data['text'] = 'Select a channel';
+                    if ($type != 'Message' || !in_array($text, $channels)) {
+                        $data['text'] = 'Select a channel from the keyboard:';
+                    }
+                    $result = Request::sendMessage($data);
+                    break;
+                }
+                $this->conversation->notes['channel'] = $text;
+                $this->conversation->notes['last_message_id'] = $message->getMessageId();
+
+                // no break
+            case 1:
+                insert:
+                if ($this->conversation->notes['last_message_id'] == $message->getMessageId() || ($type == 'Message' && empty($text))) {
+                    $this->conversation->notes['state'] = 1;
+                    $this->conversation->update();
+
+                    $data['reply_markup'] = new ReplyKeyBoardHide(['selective' => true]);
+                    $data['text'] = 'Insert the content you want to share: text, photo, audio...';
+                    $result = Request::sendMessage($data);
+                    break;
+                }
+                $this->conversation->notes['last_message_id'] = $message->getMessageId();
+                $this->conversation->notes['message'] = $message->reflect();
+                $this->conversation->notes['message_type'] = $type;
+
+                // no break
+            case 2:
+                if ($this->conversation->notes['last_message_id'] == $message->getMessageId() || !($text == 'Yes' || $text == 'No')) {
+                    $this->conversation->notes['state'] = 2;
+                    $this->conversation->update();
+
+                    // Execute this just with object that allow caption
+                    if ($this->conversation->notes['message_type'] == 'Video' || $this->conversation->notes['message_type'] == 'Photo') {
+                        $keyboard = [['Yes', 'No']];
+                        $reply_keyboard_markup = new ReplyKeyboardMarkup(
+                            [
+                                'keyboard' => $keyboard ,
+                                'resize_keyboard' => true,
+                                'one_time_keyboard' => true,
+                                'selective' => true
+                            ]
+                        );
+                        $data['reply_markup'] = $reply_keyboard_markup;
+
+                        $data['text'] = 'Would you insert caption?';
+                        if ($this->conversation->notes['last_message_id'] != $message->getMessageId() && !($text == 'Yes' || $text == 'No')) {
+                            $data['text'] = 'Would you insert a caption?' . "\n" . 'Type Yes or No';
+                        }
+                        $result = Request::sendMessage($data);
+                        break;
+                    }
+                }
+                $this->conversation->notes['set_caption'] = false;
+                if ($text == 'Yes') {
+                    $this->conversation->notes['set_caption'] = true;
+                }
+                $this->conversation->notes['last_message_id'] = $message->getMessageId();
+                // no break
+            case 3:
+                if (($this->conversation->notes['last_message_id'] == $message->getMessageId() || $type != 'Message' ) && $this->conversation->notes['set_caption']) {
+                    $this->conversation->notes['state'] = 3;
+                    $this->conversation->update();
+
+                    $data['text'] = 'Insert caption:';
+                    $data['reply_markup'] = new ReplyKeyBoardHide(['selective' => true]);
+                    $result = Request::sendMessage($data);
+                    break;
+                }
+                $this->conversation->notes['last_message_id'] = $message->getMessageId();
+                $this->conversation->notes['caption'] = $text;
+                // no break
+            case 4:
+                if ($this->conversation->notes['last_message_id'] == $message->getMessageId() || !($text == 'Yes' || $text == 'No')) {
+                    $this->conversation->notes['state'] = 4;
+                    $this->conversation->update();
+
+                    $data['text'] = 'Message will look like this:';
+                    $result = Request::sendMessage($data);
+
+                    if ($this->conversation->notes['message_type'] != 'command') {
+                        if ($this->conversation->notes['set_caption']) {
+                            $data['caption'] = $this->conversation->notes['caption'];
+                        }
+                        $result = $this->sendBack(new Message($this->conversation->notes['message'], 'thisbot'), $data);
+
+                        $data['text'] = 'Would you post it?';
+                        if ($this->conversation->notes['last_message_id'] != $message->getMessageId() && !($text == 'Yes' || $text == 'No')) {
+                            $data['text'] = 'Would you post it?' . "\n" . 'Press Yes or No';
+                        }
+                        $keyboard = [['Yes', 'No']];
+                        $reply_keyboard_markup = new ReplyKeyboardMarkup(
+                            [
+                                'keyboard' => $keyboard ,
+                                'resize_keyboard' => true,
+                                'one_time_keyboard' => true,
+                                'selective' => true
+                            ]
+                        );
+                        $data['reply_markup'] = $reply_keyboard_markup;
+                        $result = Request::sendMessage($data);
+                    }
+                    break;
+                }
+
+                $this->conversation->notes['post_message'] = false;
+                if ($text == 'Yes') {
+                    $this->conversation->notes['post_message'] = true;
+                }
+                $this->conversation->notes['last_message_id'] = $message->getMessageId();
+                // no break
+            case 5:
+                $data['reply_markup'] = new ReplyKeyBoardHide(['selective' => true]);
+
+                if ($this->conversation->notes['post_message']) {
+                    $data['text'] = $this->publish(
+                        new Message($this->conversation->notes['message'], 'anystring'),
+                        $this->conversation->notes['channel'],
+                        $this->conversation->notes['caption']
+                    );
+                } else {
+                    $data['text'] = 'Abort by user, message not sent..';
+                }
+
+                $this->conversation->stop();
+                $result = Request::sendMessage($data);
+        }
+        return $result;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function executeNoDB()
+    {
+        $message = $this->getMessage();
+        $text = trim($message->getText(true));
         $chat_id = $message->getChat()->getId();
-        $text = $message->getText(true);
+
+        $data = [];
+        $data['chat_id'] = $chat_id;
 
         if (empty($text)) {
-            $text_back = 'Write the message to send: /sendtochannel <message>';
+            $data['text'] = 'Usage: /sendtochannel <text>';
         } else {
-            $your_channel = $this->getConfig('your_channel');
-            //Send message to channel
-            $data = [
-                'chat_id' => $your_channel,
-                'text'    => $text,
-            ];
-
-            if (Request::sendMessage($data)->isOk()) {
-                $text_back = 'Message sent succesfully to: ' . $your_channel;
-            } else {
-                $text_back = 'Sorry message not sent to: ' . $your_channel;
-            }
+            $channels = (array) $this->getConfig('your_channel');
+            $first_channel = $channels[0];
+            $data['text'] = $this->publish(new Message($message->reflect(), 'anystring'), $first_channel);
         }
+        return Request::sendMessage($data);
+    }
 
+    /**
+     * Publish a message to a channel and return success or failure message
+     *
+     * @param Entities\Message $message
+     * @param int              $channel
+     * @param string|null      $caption
+     *
+     * @return string
+     */
+    protected function publish(Message $message, $channel, $caption = null)
+    {
         $data = [
-            'chat_id' => $chat_id,
-            'text'    => $text_back,
+            'chat_id' => $channel,
+            'caption' => $caption,
         ];
 
-        return Request::sendMessage($data);
+        if ($this->sendBack($message, $data)->isOk()) {
+            $response = 'Message sent successfully to: ' . $channel;
+        } else {
+            $response =
+                    'Message not sent to: ' .  $channel . "\n" .
+                    '- Does the channel exist?' . "\n" .
+                    '- Is the bot an admin of the channel?';
+        }
+        return $response;
+    }
+
+    /**
+     * SendBack
+     *
+     * Received a message, the bot can send a copy of it to another chat/channel.
+     * You don't have to care about the type of the message, the function detect it and use the proper
+     * REQUEST:: function to send it.
+     * $data include all the var that you need to send the message to the proper chat
+     *
+     * @todo This method will be moved at an higher level maybe in AdminCommand or Command
+     * @todo Looking for a more significative name
+     *
+     * @param Entities\Message $message
+     * @param array            $data
+     *
+     * @return Entities\ServerResponse
+     */
+    protected function sendBack(Message $message, array $data)
+    {
+        $type = $message->getType();
+        $type = ($type == 'command') ? 'Message' : $type;
+        if ($type == 'Message') {
+            $data['text'] = $message->getText(true);
+        } elseif ($type == 'Audio') {
+            $data['audio'] = $message->getAudio()->getFileId();
+            $data['duration'] = $message->getAudio()->getDuration();
+            $data['performer'] = $message->getAudio()->getPerformer();
+            $data['title'] = $message->getAudio()->getTitle();
+        } elseif ($type == 'Document') {
+            $data['document'] = $message->getDocument()->getFileId();
+        } elseif ($type == 'Photo') {
+            $data['photo'] = $message->getPhoto()[0]->getFileId();
+        } elseif ($type == 'Sticker') {
+            $data['sticker'] = $message->getSticker()->getFileId();
+        } elseif ($type == 'Video') {
+            $data['video'] = $message->getVideo()->getFileId();
+        } elseif ($type == 'Voice') {
+            $data['voice'] = $message->getVoice()->getFileId();
+        } elseif ($type == 'Location') {
+            $data['latitude'] = $message->getLocation()->getLatitude();
+            $data['longitude'] = $message->getLocation()->getLongitude();
+        }
+        $callback_path = 'Longman\TelegramBot\Request';
+        $callback_function = 'send' . $type;
+        if (! method_exists($callback_path, $callback_function)) {
+            throw new TelegramException('Methods: ' . $callback_function . ' not found in class Request.');
+        }
+
+        return call_user_func_array($callback_path . '::' . $callback_function, [$data]);
     }
 }

src/Commands/Command.php

@@ -159,7 +159,6 @@ public function executeNoDB()
         return Request::sendMessage($data);
     }
 
-
     /**
      * Get update object
      *