added examples & do cleaner

Author: ArashAbedii

.gitignore

@@ -1,2 +1,2 @@
-config/env.php
+/config
 /vendor

app/Controllers/CallbackQueryHandler.php

@@ -5,7 +5,18 @@
 class CallbackQueryHandler {
 
     public function run(){
+
         //code
+        
+        if(callback_query()->getData()=='sayHello'){
+
+            bot()->answerCallbackQuery(
+                [
+                    'callback_query_id'=>callback_query()->getCallbackQueryId(),
+                    'text'=>'Hello ☺️'
+                ]
+            );
+        }
     }
 
 }

app/Controllers/MessageHandler.php

@@ -2,15 +2,54 @@
 
 namespace App\Controllers;
 
-use App\Helpers\ThirdPartyClass;
-use App\Modules\ExampleModule;
+use Src\InlineKeyboardMarkup;
+use Src\ReplyKeyboardMarkup;
 
 class MessageHandler{
+
+   //main method
    public function run(){
+
       //do somethings
-      ExampleModule::run()->example();
+      if(message()->getText()=='/start'){
+
+         //send simple message by options
+         bot()->sendMessage(
+            [
+                  'text'=>"welcome to TeleBot Hello World example 😎\nTeleBot is an open source framework for creating any telegram bots\n<a href='https://github.com/arashabedii/telebot'>see more</a>",
+                  'reply_to_message_id'=>message()->getMessageId(),
+                  'parse_mode'=>'html',
+                  'disable_web_page_preview'=>true,
+                  //KEYBOARDS  PATERN LIKE: "$btn1--$btn2--$btn3//$btn4--$btn6//$btn7--$btn8::request_location"
+                  'reply_markup'=>ReplyKeyboardMarkup::createEasyier("Inline--Shere Contact::request_contact//share location::request_location"),
+                  
+            ]
+         );
+      }elseif(message()->getText()=='Inline'){
+         
+            //create inline keyboard rows structure
+            $rows=[
+
+               //row 1
+               [
+                  ['text'=>'google','url'=>'https://google.com'],
+                  ['text'=>'Say Hello','callback_data'=>'sayHello'],
+               ],
+
+               //row2
+               [
+                  ['text'=>'test inine query(need to turn on inline mode)','switch_inline_query'=>'telebot_tester'],
+               ],
+
+            ];
 
-      //use Thired party class
-      ThirdPartyClass::run()->sayHello();
+            //send request to telegram
+            bot()->sendMessage(
+               [
+                  'text'=>'This is inline keyboard test',
+                  'reply_markup'=>InlineKeyboardMarkup::create($rows),
+               ]
+            );
+      }
    }
 }

bootstrap/bot.php

@@ -1,53 +1,73 @@
 <?php
+
 //BOOTSTRAP
 require_once "../vendor/autoload.php";
 
 use Src\Bot;
 
+//bot starter
 $bot=new Bot();
- //bot()->sendMessage(['text'=>json_encode(update()->getUpdate())]);
- //file_put_contents('debug.txt',json_encode(update()->getUpdate()));
- //die();
 
 
+//-------------------------------------------------------------------UPDATE HANDLERS----------------------------------------------------------------
+
+//handling message update
 if(update()->getType()=='message'){
 
     messageHandler()->run();
 
-}elseif(update()->getType()=='callback_query'){
+}
+//handling callback_query update
+elseif(update()->getType()=='callback_query'){
 
     callbackQueryHandler()->run();
 
-}elseif(update()->getType()=='channel_post'){
+}
+//handling channel_post update
+elseif(update()->getType()=='channel_post'){
 
     channelPostHandler()->run();
 
-}elseif(update()->getType()=='edited_message'){
+}
+//edited_message update
+elseif(update()->getType()=='edited_message'){
 
     editedMessageHandler()->run();
 
-}elseif(update()->getType()=='edited_channel_post'){
+}
+//handling edited_channel_post update
+elseif(update()->getType()=='edited_channel_post'){
 
     editedChannelPostHandler()->run();
 
-}elseif(update()->getType()=='inline_query'){
+}
+//handling inline_query update
+elseif(update()->getType()=='inline_query'){
 
     inlineQueryHandler()->run();
 
-}elseif(update()->getType()=='poll'){
+}
+//handling poll update
+elseif(update()->getType()=='poll'){
 
     pollHandler()->run();
 
-}elseif(update()->getType()=='poll_answer'){
+}
+//handling poll_answer update
+elseif(update()->getType()=='poll_answer'){
 
     pollAnswerHandler()->run();
 
-}elseif(update()->getType()=='my_chat_member'){
+}
+//handling my_chat_member update
+elseif(update()->getType()=='my_chat_member'){
 
     myChatMemberHandler()->run();
 
-}elseif(update()->getType()=='chat_member'){
+}
+//handling chat_member update
+elseif(update()->getType()=='chat_member'){
 
     chatMemberHandler()->run();
-    
+
 }

config/env.php

@@ -1,5 +1,5 @@
 <?php
-$domain='https://191e-51-161-66-74.ngrok.io';
+$domain='https://806b-5-39-2-198.ngrok.io';
 
 
 

config/env_example.php

@@ -4,4 +4,5 @@
 
 use Src\Bot;
 
+//handle requests
 Bot::redirectRequests();

requestsHandler.php

@@ -2,11 +2,13 @@
 
 namespace Src;
 
-class Bot {
+//CORE BOT CLASS
 
-    //HELPERS
+class Bot {
 
+    //chat_id generator
     public function paramsGenerator($params){
+
         if(empty($params['chat_id'])){
             $params['chat_id']=chat()->getChatId();
         }
@@ -77,7 +79,6 @@ public function pinChatMessage(array $params){
 
 
     public function unpinChatMessage(array $params){
-
         return $this->sendRequest('unpinChatMessage',$this->paramsGenerator($params));
     }
 
@@ -255,40 +256,44 @@ public function answerInlineQuery($inlineQueryId,array $results,array $options=[
 
 
 
+    //--------------------------------------------REQUESTERS-------------------------------------------------------
+
+    //redirect all input requests from telegram servers
     static function redirectRequests($url=""){
-        $params=file_get_contents("php://input");
 
+        $params=file_get_contents("php://input");
         if(empty($url)){
             $url=config()['bot_main_path'];
         }
-
         return Server::sendRequestWithoutResponse($url,$params);
-
     }
 
+    //get telegram update types
     public function getUpdateType(){
         return update()->getType();
     }
 
+    //set webhook helper
     public static function setWebhook(){
         $token=config()['token'];
         $url=config()['request_handler_path'];
         $reqUrl="https://api.telegram.org/bot$token/setWebhook?url=$url";
-        var_dump(Server::sendRequest($reqUrl));
+        return Server::sendRequest($reqUrl);
     }
 
+    //delete webhook helper
     public static function deleteWebhook(){
         $token=config()['token'];
         $url=config()['request_handler_path'];
         $reqUrl="https://api.telegram.org/bot$token/deleteWebhook?url=$url";
-        var_dump(Server::sendRequest($reqUrl));
+       return Server::sendRequest($reqUrl);
     }
 
+    //create telegram request
     public static function sendRequest($method,array $params){
         $token=config()['token'];
         $reqUrl="https://api.telegram.org/bot$token/$method";
         return Server::sendRequest($reqUrl,$params,'post');
     }
 
-
 }

src/Bot.php

@@ -20,30 +20,39 @@
 use Src\UpdateTypes\InlineQuery;
 use Src\UpdateTypes\Poll;
 
+//return configure files
 function config($fileName="env"){
-    $conf=include($_SERVER['DOCUMENT_ROOT']."/config/$fileName.php");
+    if(!empty($_SERVER['DOCUMENT_ROOT'])){
+        $conf=include($_SERVER['DOCUMENT_ROOT']."/config/$fileName.php");
+    }else{
+        $conf=include($_SERVER['PWD']."/config/$fileName.php");
+    }
+    
     return $conf;
 }
 
-
-
+//bot object
 function bot(){
     global $bot;
     return $bot;
 }
 
+//messageHandler object
 function messageHandler(){
     return new MessageHandler();
 }
 
+//channelPostHandler object
 function channelPostHandler(){
     return new ChannelPostHandler();
 }
 
+//callbackQueryHandler object
 function callbackQueryHandler(){
     return new CallbackQueryHandler();
 }
 
+//callbackQueryHandler object
 function inlineQueryHandler(){
     return new InlineQueryHandler();
 }

src/Helpers/functions.php

@@ -2,10 +2,13 @@
 namespace Src\UpdateTypes;
 
 class Chat extends Update {
+
     protected $chat_id;
 
     public function __construct()
     {
+        parent::__construct();
+        
         $this->setChatId();
     }
 

src/UpdateTypes/Chat.php

@@ -3,6 +3,7 @@
 namespace Src\UpdateTypes;
 
 class InlineQuery extends Update {
+    
     public function getId(){
         return $this->inline_query->id;
     }

src/UpdateTypes/InlineQuery.php

@@ -116,7 +116,6 @@ public function getType(){
     }
 
     //GET UPDATE
-
     public function getUpdate(){
         return $this->update;
     }

src/UpdateTypes/Update.php

@@ -1,9 +1,12 @@
 <?php
+
 require_once './vendor/autoload.php';
 use Src\Bot;
 
+//webhook manul setting
+
 if(!empty($_GET['set'])){
-    Bot::setWebhook();
+    echo Bot::setWebhook();
 }elseif(!empty($_GET['delete'])){
-    Bot::deleteWebhook();
+    echo Bot::deleteWebhook();
 }