botfire

botfire

️ شاهد النسخة الجديدة من هذه المكتبة هنا

قم ببناء روبوت بثلاثة أسطر من التعليمات البرمجية :)

bot:: setToken ( ' token-string ' );
bot:: autoInput ();

bot:: id (chat_id)-> message ( ' hello my robot ' )-> send ();

• الاستخدام الأساسي
• getMe

خطاف ويب

• setWebhook
• getWebhookInfo

طريقة الإرسال

• إرسال رسالة
• إرسال الصورة
• إرسال الصوت
• sendDocument
• sendVideo
• sendAnimation
• إرسال صوت
• sendVideoNote
• sendLocation
• sendMediaGroup

طريقة التحديث

• تحريرMessageText
• تحريرMessageCaption
• تحريرMessageReplyMarkup
• deleteMessage

طريقة أعضاء الدردشة

• com.getChat
• getChatAdministrators
• getChatMembersCount

لوحة المفاتيح

• لوحة المفاتيح المضمنة
• لوحة المفاتيح الترميزية

الاستخدام

الاستخدام في الإطار الليلي

botfire as bot;">

 use Models  botfire as bot ;

أو استخدامها في مشروع آخر (عرض العينة)

botfire.php'); use Models botfire as bot;">

 include_once ( ' botfire .php ' );
use Models  botfire as bot ;

الاستخدام الأساسي

bot:: setToken ( ' token-string ' );
bot:: autoInput ();

قم بتنزيل واستخراج botfire .php إلى دليل النماذج :|

getMe

 $ res =bot:: this ()-> getMe ()-> send ();
echo $ res ;

إرسال رسالة

استخدم هذه الطريقة لإرسال رسائل نصية. عند النجاح، يتم إرجاع الرسالة المرسلة.

botfire_keyboard) ->disable_web_page_preview(boolean) ->send();">

bot:: id (chat_id)
-> message ( ' text ' )
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> disable_web_page_preview (boolean)
-> send ();

رمز المثال

bot:: id (chat_id)-> message ( ' your message text ' )-> send ();

bot:: id (chat_id)-> message ( ' use <b> parse_mode <b> ' )-> parse_mode ( ' HTML ' )-> send ();

استخدم طرقًا أخرى

إرسال الصورة

استخدم هذه الطريقة لإرسال الصور. عند النجاح، يتم إرجاع الرسالة المرسلة.

botfire_keyboard) ->send();">

bot:: id (chat_id)
-> photo ( $ file , ' Caption ' )
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

رمز المثال

 // send from url
bot:: id (chat_id)-> photo (image_url_string)-> send ();

// send by file_id
bot:: id (chat_id)-> photo (file_id_string)-> send ();

// send file from local server
$ file =bot:: loadFile ( ' user.png ' );
bot:: id (chat_id)-> photo ( $ file )-> send ();

// send photo with caption
bot:: id (chat_id)-> photo ( $ file , ' Caption ' )-> send ();

إرسال الصوت

استخدم هذه الطريقة لإرسال الصوت الذي يجب أن يكون بتنسيق .MP3 أو .M4A.

botfire_keyboard) ->send(); ">

bot:: id (chat_id)
-> audio ( $ file , ' Caption text for audio ' )
-> duration (int_to_seconds) //Duration of the audio in seconds
-> performer (string)
-> title (string) //Track name
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

رمز المثال

bot:: id (chat_id)-> audio ( $ file , ' Caption text for audio ' )-> send ();

sendDocument

استخدم هذه الطريقة لإرسال الملفات العامة

botfire_keyboard) ->send(); // example bot::id(file_id)->document( file_id , 'Caption text for document' )->send();">

bot:: id (file_id)
-> document ( $ file , ' Caption text for document ' )
-> thumb (loadFile_or_string)
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

// example
bot:: id (file_id)-> document ( file_id , ' Caption text for document ' )-> send ();

sendVideo

استخدم هذه الطريقة لإرسال ملفات الفيديو

botfire_keyboard) ->send(); // example bot::id(file_id)->video( $file , 'Caption text for video' )->send(); ">

bot:: id (file_id)
-> video ( $ file , ' Caption text for video ' )
-> duration (int_to_seconds) //Duration of sent video in seconds
-> width (int) //Animation width
-> height (int) //Animation height
-> thumb (loadFile_or_string)
-> parse_mode (string) // HTML or Markdown
-> supports_streaming (boolean) //Pass True, if the uploaded video is suitable for streaming
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

// example
bot:: id (file_id)-> video ( $ file , ' Caption text for video ' )-> send ();

sendAnimation

استخدم هذه الطريقة لإرسال ملفات الرسوم المتحركة (فيديو GIF أو H.264/MPEG-4 AVC بدون صوت).

botfire_keyboard) ->send();">

bot:: this ()-> animation ( $ file , ' Caption text for animation ' )-> send ();

// use other methods
bot:: this ()
-> animation ( $ file , ' Caption text for animation ' )
-> duration (int_to_seconds) //Duration of sent animation in seconds
-> width (int) //Animation width
-> height (int) //Animation height
-> thumb (loadFile_or_string)
-> parse_mode (string) // HTML or Markdown
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

إرسال صوت

استخدم هذه الطريقة لإرسال الصوت

botfire_keyboard) ->send();">

bot:: this ()-> voice ( $ file , ' Caption text for voice ' )-> send ();

// use other methods
bot:: this ()
-> voice ( $ file , ' caption ' )
-> parse_mode (string) // HTML or Markdown
-> duration (int_to_seconds) //Duration of sent voice in seconds
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

sendVideoNote

اعتبارًا من الإصدار 4.0، يدعم عملاء Telegram مقاطع فيديو mp4 مربعة الشكل مدتها تصل إلى دقيقة واحدة.

botfire_keyboard) ->send();">

bot:: this ()-> voice ( video_file )-> send ();

// use other methods
bot:: this ()
-> voice ( video_file )
-> duration (int_to_seconds) //Duration of sent video in seconds
-> length (int) //Video width and height
-> thumb (loadFile_or_string)
-> disable_notification (boolean)
-> reply_to (message_id)
-> keyboard ( botfire _keyboard)
-> send ();

بوت::loadFile

يتم استخدام وظيفة LoadFile لإرسال ملفات الخادم

bot:: this ()-> document (  bot:: loadFile (file_path_string) )-> send ();

sendLocation

استخدم هذه الطريقة لإرسال نقطة على الخريطة. عند النجاح، يتم إرجاع الرسالة المرسلة.

bot:: this ()-> location ( $ latitude , $ longitude )-> send ();

// support live_period
bot:: this ()-> location ( $ latitude , $ longitude )-> live_period ( $ number )-> send ();

إرسال إجراء الدردشة

استخدم هذه الطريقة عندما تحتاج إلى إخبار المستخدم بحدوث شيء ما من جانب الروبوت

قائمة الإجراءات :

'كتابة'،'upload_photo'،'record_video'،'upload_video'،'record_audio'،'upload_audio'،'upload_document'،'find_location'،'record_video_note'،'upload_video_note'

bot:: this ()-> chatAction ( ' typing ' )-> send ();

sendMediaGroup

استخدم هذه الطريقة لإرسال مجموعة من الصور أو مقاطع الفيديو كألبوم. عند النجاح، يتم إرجاع مجموعة من الرسائل المرسلة.

InputMediaPhoto

bot:: id (chat_id)
  -> mediaGroup ()
    -> photo (file_id)-> caption ( ' caption ... ' )
    -> photo (other_file_id)
  -> send ();


  // support this methods
  // ..->photo(file_id)
  // ->caption($caption)
  // ->parse_mode('HTML')

InputMediaVideo

bot:: id (chat_id)
  -> mediaGroup ()
    -> video (file_id)-> caption ( ' caption ... ' )
    -> video (other_file_id)
  -> send ();

  // support this methods
  // ..->video(file_id)
  // ->thumb($thumb)
  // ->caption($caption)
  // ->parse_mode('HTML')
  // ->width($width)
  // ->height($height)
  // ->duration($duration)
  // ->supports_streaming($supports_streaming)

InputMediaAnimation

bot:: id (chat_id)
  -> mediaGroup ()
    -> animation (file_id)-> caption ( ' caption ... ' )
    -> animation (other_file_id)
  -> send ();

  // support this methods
  // ..->animation(file_id)
  // ->thumb($thumb)
  // ->caption($caption)
  // ->parse_mode('HTML')
  // ->width($width)
  // ->height($height)
  // ->duration($duration)

InputMediaAudio

bot:: id (chat_id)
  -> mediaGroup ()
    -> audio (file_id)-> caption ( ' caption ... ' )
    -> audio (other_file_id)
  -> send ();

  // support this methods
  // ..->audio(file_id)
  // ->thumb($thumb)
  // ->caption($caption)
  // ->parse_mode('HTML')
  // ->duration($duration)
  // ->performer($performer)
  // ->title($title)

InputMediaDocument

bot:: id (chat_id)
  -> mediaGroup ()
    -> document (file_id)-> caption ( ' caption ... ' )
    -> document (other_file_id)
  -> send ();

  // support this methods
  // ..->document(file_id)
  // ->thumb($thumb)
  // ->caption($caption)
  // ->parse_mode('HTML')

### نموذج لوحة المفاتيح المضمنة للوحة المفاتيح:

 $ k =bot:: keyboard ();

$ k -> inline ()-> row ( function ( $ col ){
  // usage callback
  $ col -> btn ( ' button name ' , ' callback_text ' );

  // usage url
  $ col -> btnUrl ( ' night framework ' , ' https://nightframework.com ' );
})
-> row ( function ( $ col ){
  $ col -> btn ( ' one button ' , ' callback_text_2 ' );
});

// send message with inline button
bot:: this ()-> message ( ' message text ' )-> keyboard ( $ k )-> send ();

// send photo with inline button
bot:: this ()-> photo (file_id, ' caption ' )-> keyboard ( $ k )-> send ();

عينة 2

 $ k =bot:: keyboard ();
$ k -> btn ( ' game 1 ' , ' game_callback ' );
$ k -> btn ( ' game 2 ' , ' game_callback ' );
$ k -> row ();

bot:: this ()-> message ( ' message text ' )-> keyboard ( $ k )-> send ();

رد برقية على مستندات ترميز لوحة المفاتيح

العلامات($resize_keyboard،$one_time_keyboard،$selective)

 $ k =bot:: keyboard ();

$ k -> markup ()-> row ( function ( $ col ){
  $ col -> btn ( ' button name ' );
});

$ k -> markup ( true )-> row ( function ( $ col ){
  $ col -> btn ( ' button name ' );
});

bot:: this ()-> message ( ' text ' )-> keyboard ( $ k )-> send ();

إزالة لوحة المفاتيح الترميزية

bot:: this ()-> message ( ' text ' )-> removeKeyboard ()-> send ();

رد الاتصال الاستعلام

التحقق من رد طلب

 if (bot:: $ isCallback ){
    /// code ..
}

تلقي بيانات رد الاتصال

 $ data =bot:: get ( ' data ' );

تلقي callback_query_id

 $ query_id = bot:: get ( ' callback_id ' );

الرد على رد الاتصال($show_alert=false)

bot:: this ()-> answerCallback ()-> send ();

// send alert
bot:: this ()-> answerCallback ( true )-> text ( ' hello Telegram :) ' )-> send ();

// or open robot link
$ link = ' t.me/your_robot?start=xxxx ' ;
bot:: this ()-> answerCallback ()-> url ( $ link )-> send ();

تحرير الرسالة

تحريرMessageText

استخدم هذه الطريقة لتحرير الرسائل النصية ورسائل الألعاب. عند النجاح، إذا تم إرسال رسالة محررة بواسطة الروبوت، فسيتم إرجاع الرسالة المحررة، وإلا فسيتم إرجاع True.

bot:: this ()-> editMessage ( ' new text string ' )-> send ();

 // use other methods
bot:: this ()
-> editMessage ( ' new text string ' )

// Use custom message_id
-> message_id (id)
// Use custom inline_message_id
-> inline_message_id (id)

-> parse_mode ( ' HTML ' )
-> disable_web_page_preview (boolean)
-> keyboard ( $ k ) // A JSON-serialized object for an inline keyboard.
-> send ();

تحريرMessageCaption

استخدم هذه الطريقة لتحرير التسميات التوضيحية للرسائل. عند النجاح، إذا تم إرسال رسالة محررة بواسطة الروبوت، فسيتم إرجاع الرسالة المحررة، وإلا فسيتم إرجاع True.

bot:: this ()-> editCaption ( ' new text string ' )-> send ();

 // use other methods
bot:: this ()
-> editCaption ( ' new text string ' )

// Use custom message_id
-> message_id (id)
// Use custom inline_message_id
-> inline_message_id (id)

-> parse_mode ( ' HTML ' )
-> keyboard ( $ k ) // A JSON-serialized object for an inline keyboard.
-> send ();

تحريرMessageReplyMarkup

استخدم هذه الطريقة لتحرير علامة الرد الخاصة بالرسائل فقط. عند النجاح، إذا تم إرسال رسالة محررة بواسطة الروبوت، فسيتم إرجاع الرسالة المحررة، وإلا فسيتم إرجاع True.

bot:: this ()-> editReplyMarkup ()-> keyboard ( $ k )-> send ();

 // use other methods
bot:: this ()
-> editReplyMarkup ( ' new text string ' )

// Use custom message_id
-> message_id (id)
// Use custom inline_message_id
-> inline_message_id (id)

-> keyboard ( $ k ) // A JSON-serialized object for an inline keyboard.
-> send ();

deleteMessage

استخدم هذه الطريقة لحذف رسالة

bot:: this ()-> deleteMessage ()-> send ();
// or
bot:: this ()-> deleteMessage ()-> message_id ( ' custom message_id ' )-> send ();

setWebhook

bot:: this ()-> setWebhook ( $ url )-> send ();

// or

bot:: this ()-> setWebhook ( $ url )-> max_connections ( 40 )-> send ();

// or

$ cert =bot:: loadFile ( ' certificate.txt ' );

bot:: this ()
-> setWebhook ( $ url )
-> certificate ( $ cert )
-> allowed_updates ( $ array )
-> send ();

getWebhookInfo

 $ res =bot:: this ()-> getWebhookInfo ()-> send ();
echo $ res ;

---

أعضاء

com.getChat

استخدم هذه الطريقة للحصول على معلومات محدثة حول الدردشة (الاسم الحالي للمستخدم في المحادثات الفردية، واسم المستخدم الحالي للمستخدم، أو المجموعة أو القناة، وما إلى ذلك). إرجاع كائن الدردشة عند النجاح.

 $ result =bot:: this ()-> getChat ()-> send ();
// or
$ result =bot:: id (chat_id)-> getChat ()-> send ();

echo $ result ;

getChatAdministrators

استخدم هذه الطريقة للحصول على قائمة المسؤولين في الدردشة. عند النجاح، يتم إرجاع مجموعة من كائنات ChatMember التي تحتوي على معلومات حول جميع مسؤولي الدردشة باستثناء برامج الروبوت الأخرى. إذا كانت الدردشة عبارة عن مجموعة أو مجموعة فائقة ولم يتم تعيين أي مسؤولين، فسيتم إرجاع المنشئ فقط.

 $ result =bot:: this ()-> getChatAdministrators ()-> send ();
// or
$ result =bot:: id (chat_id)-> getChatAdministrators ()-> send ();

echo $ result ;

getChatMembersCount

استخدم هذه الطريقة لمعرفة عدد الأعضاء في الدردشة. إرجاع Int عند النجاح.

 $ result =bot:: this ()-> getChatMembersCount ()-> send ();
// or
$ result =bot:: id (chat_id)-> getChatMembersCount ()-> send ();

echo $ result ;

---

الوصول إلى البيانات

 // Get the current chat_id
$ chat_id =bot:: $ chat_id ;

// Get the current username
$ username =bot:: $ username ;

// Get the current first_name
$ first_name =bot:: $ first_name ;

// Get the current last_name
$ last_name =bot:: $ last_name ;

// first_name + last_name
$ full_name =bot:: $ full_name ;

//Receive text the user has sent
$ text =bot:: get ( ' text ' );

// get message_id
$ message_id =bot:: get ( ' message_id ' );

// get message caption
$ caption =bot:: get ( ' caption ' );

//Receive object of string sent by telegram
$ ob_str =bot:: $ input ;

//Receive json object sent by telegram
$ json ==bot:: $ json ;

---

التحقق من نوع العميل

 // If the request is from the supergroup return true else false
$ is_group =bot:: isGroup ();

// If the request is from the supergroup or group return true else false
$ is_group =bot:: isGroup ( false );

// If the request is from the private user
$ is_user =bot:: isUser ();

الحصول على طلب من المجموعة الفائقة

 // get group id
$ chat_id = bot:: $ chat_id ;

// Get the group title
$ title = bot:: $ title ;

// get sender user
$ user = bot:: get ( ' user ' );

$ user_chat_id = $ user -> id ;
$ is_bot = $ user -> is_bot ;

إضافي

الحصول على نوع الرسالة (جديد)

 // support messages [text,photo,video,video_note,voice,animation,document,contact,location]
$ message = bot:: getMessageType ();

عينة نص الإخراج:

botfire" }">

{
  "type" : " text " ,
  "data" : " Hello botfire "
}

عينة الصورة الإخراج:

{
  "type" : " photo " ,
  "data" : [
    {
      "file_id" : " AgA*** " ,
      "file_unique_id" : " AQA*** " ,
      "file_size" : 20303 ,
      "width" : 320 ,
      "height" : 296
    }
  ]
}