💡آموزش استفاده از وب سرویس های کتابخانه

-در این آموزش ما میخواییم از وب سرویس جوک استفاده کنیم.

مرحله 1 : اول از همه باید یه متغییر ایجاد کنید.
$joke
-ما متغییر $joke رو ایجاد کردیم

2- حالا باید کد استفاده از وب سرویس جک رو جلوی متغییر قرار بدید.
$this->api(['type'=>'joke']);
-خب کد نهایی ما به شکل زیر میشه
$joke = $this->api(['type'=>'joke']);

3-حالا کافیه تو سند مسیج $joke رو قرار بدید تا یک جوک برای کاربر ارسال بشه.

🔖 لیست پلاگین های کتابخانه:
alaki (الکی مثلا)
arz (قیمت ارز)
tala (قیمت طلا)
arzdigital (ارز ديجيتال)
ayam (ایام)
danestani (دانستنی)
dastan (داستان)
chistan (چیستان)
dialog (دیالوگ ماندگار)
hadis (حدیث)
joke (جوک)
fall (فال)
khatere (خاطره)
pnp (پ ن پ)
noroz (نوروز)
capcha (کپچا)
time (ساعت)
pdf (سایت به پی دی اف) [نمونه]

نسخه 1.05 کتابخانه منتشر شد !!

- قابلیت پردازش چندگانه یا همان Multi process

با استفاده از این قابلیت ، در صورتی که رباتتان به پردازشی مشغول باشد(یا از تابع sleep استفاده شود) همچنان پاسخ گوی درخواست ها خواهد بود
جهت استفاده از این قابلیت پارامتر multi را در تابع start ست کنید و به آن مقدار صحیح(true) دهید
$BPT->start(['multi'=>true]);

- افزایش تابع ها
تعدادی تابع اضافه به کتابخانه اضافه شدند ، تابع ها :
size (دریافت حجم فایل)
jChecker (جویین چکر کانال گروه)

- مستندات فارسی
مستندات فارسی شده به سایت اضافه شده و به راحتی میتوانید استفاده کنید.

📄 مستندات و توضیحات
https://bpt-proto.site

🔗 نظرات، پیشنهادات و ایده های خود را جهت پیشرفت و بهبود کتابخانه کامنت کنید
@BPT_CH

از ورژن 1.04 به بعد ، متد های کتابخانه دچار تغییر شدن و به همین علت سورس های قبلی داخل کانال دیگه کار نمیکنن

جهت نوشتن میتوانید از سایت زیر
https://BPT-Proto.site/BPT/base.php
قالب خام و بروز کتابخانه رو دریافت کنید و با استفاده از مستندات که در سایت اصلی ما قرار گرفته آن را توسعه دهید
https://BPT-Proto.site

- به زودی نسخه های جدید سورس های قبلی داخل کانال قرار می‌گیرند.

نسخه 1.06 کتابخانه منتشر شد !!

- متد های جدید تلگرام اضافه شد.
- هفت متد جدید اضافه شد.

لیست متود های جدید :
logOut
close
copyMessage

dataSave
dataGet
dataDel
del
forward
eKey
checkPhone

- قابلیت دسترسی به آپدیت دریافتی با استفاده از عبارت زیر
$this->update;

📄 مستندات و توضیحات
https://bpt-proto.site

نسخه 1.07 کتابخانه منتشر شد !!

- متد های تلگرام ادیت شد.

اکثر متد ها در صورت ست نشدن پارامتر هایی(مانند chat_id) به صورت خودکار آن را از آپدیت دریافتی ست میکنند به همین علت برخی متد ها میتوانند بدون هیچ گونه ورودی فراخوانده شوند مانند sendDice

- کلی متد ساده تلگرام اضافه شد.
اسامی متد ها :
send as sendMessage
forward as forwardMessage
copy as copyMessage
photo as sendPhoto
audio as sendAudio
document as sendDocument
video as sendVideo
animation as sendAnimation
voice as sendVoice
videoNote as sendVideoNote
mediaGroup as sendMediaGrou
location as sendLocation
venue as sendVenue
contact as sendContact
poll as sendPoll
dice as sendDice
action as sendChatAction
file as getFile
ban as kickChatMember
unban as unbanChatMember
restrict as restrictChatMember
promote as promoteChatMember
customTitle as setChatAdministratorCustomTitle
permissions as setChatPermissions
link as exportChatInviteLink
title as setChatTitle
description as setChatDescription
pin as pinChatMessage
unpin as unpinChatMessage
unpinAll as unpinAllChatMessage
leave as leaveChat
chat as getChat
admins as getChatAdministrators
membersCount as getChatMemberCount
member as getChatMember
answer as answerCallbackQuery
editText as editMessageText
editCaption as editMessageCaption
editMedia as editMessageMedia
editKeyboard as editMessageReplyMarkup
del as deleteMessage
sticker as sendSticker
answerInline as answerInlineQuery
invoice as sendInvoice
game as sendGame

این متد ها همان متد های اصلی تلگرام هستند اما برای راحتی ، اسم های آن ها کوتاه شده است.
لازم به ذکر است که تمام متد های قبلی همچنان وجود دارند و در صورت لزوم میتوانید از آنها استفاده کنید.

همچنین متد kick نیز اضافه شده که کاربر اضافه شده را اخراج می‌کند.

- تنظیمات جدیدی به متد استارت اضافه شد.

تنظیم split_update که به صورت پیشفرض مقدار true را دارد ، در صورت true بودن آپدیت ها به صورت تقسیم شده ارسال می‌شوند(مانند قبل) و در صورت false بودن همه ی آپدیت ها به متد all که درون کلاس bpt_handler ست شده است ارسال می‌شوند.

📄 مستندات و توضیحات
https://bpt-proto.site

همانطور ک مطلع بودید ، ما مشغول تهیه سری آموزش برای کتابخانه بودیم ، در حال حاضر تا قسمت پنجم تهیه شده و تا دقایقی دیگر در کانال قرار می‌گیرد.
ورژن استفاده شده کتابخانه : 1.07

قسمت های بعدی نیز در دست تهیه هستند که با ورژن های بعدی کتابخانه ساخته می‌شوند.

تمام قسمت ها را می‌توانید از طریق ترین بیت با حجم نیم بها دانلود کنید
ix8.ir/fl

#amozesh
#part_1 #part1 #p1

قسمت اول از سری آموزش های کتابخانه

مطالب مربوط به این قسمت :

آموزش دریافت فایل خام و تشریح اجزای اون
لینک دریافت فایل خام :
https://bpt-proto.site/BPT/base.php
لینک دانلود کتابخانه :
https://bpt-proto.site/BPT/BPT.php

لینک ترین بیت(نیم بها) :
ix8.ir/p1
لینک مستقیم(تمام بها) :
dl.bpt-proto.site/amozesh/p1.mp4

#amozesh
#part_2 #part2 #p2

قسمت دوم از سری آموزش های کتابخانه

مطالب مربوط به این قسمت :

تشریح بخش های کتابخانه

لینک ترین بیت(نیم بها) :
ix8.ir/p2
لینک مستقیم(تمام بها) :
dl.bpt-proto.site/amozesh/p2.mp4

#amozesh
#part_3 #part3 #p3

قسمت سوم از سری آموزش های کتابخانه

مطالب مربوط به این قسمت :

تشریح کلاس BPT در کتابخانه
تشریح متد های تلگرام و متد های ساده شده تلگرام
لینک متد های تلگرام :
https://code.telegram.org/bots/api

لینک ترین بیت(نیم بها) :
ix8.ir/p3
لینک مستقیم(تمام بها) :
dl.bpt-proto.site/amozesh/p3.mp4

#amozesh
#part_4 #part4 #p4

قسمت چهارم از سری آموزش های کتابخانه

مطالب مربوط به این قسمت :

تشریح کلاس BPT در کتابخانه
تشریح متد های اضافه یا ویژه کتابخانه

لینک ترین بیت(نیم بها) :
ix8.ir/p4
لینک مستقیم(تمام بها) :
dl.bpt-proto.site/amozesh/p4.mp4

#amozesh
#part_5 #part5 #p5

قسمت پنجم از سری آموزش های کتابخانه

مطالب مربوط به این قسمت :

ساخت یک ربات ساده با کتابخانه
لینک دانلود مستقیم سورس ربات :
ix8.ir/b5
ربات مربوطه :
@BPT_p5_bot

لینک ترین بیت(نیم بها) :
ix8.ir/p5
لینک مستقیم(تمام بها) :
dl.bpt-proto.site/amozesh/p5.mp4

نسخه 1.08 کتابخانه منتشر شد !!

- پنج وب سرویس جدید اضافه شد.

لیست وب سرویس های جدید :
corona
uupload (یو آپلود - آپلود فایل دریافت لینک مستقیم)
screenshot (گرفتن عکس از سایت)
short (کوتاه کننده لینک)
alexa (رتبه الکسا)

- تغییر در خروجی متد statshere
- تغییر در دیتابیس کتابخانه
- اضافه شدن یک تنظیم جدید به متد start

array_update
در صورت true بودن آپدیت به صورت آرایه و در صورت false بودن آپدیت به صورت آبجکت ارسال میشه.
مقدار پیشفرض true

نکته : این تنظیم روی پراپرتی update تاثیری ندارد و نوع آن همچنان آبجکت است

📄 مستندات و توضیحات
https://bpt-proto.site

نسخه 1.09 کتابخانه منتشر شد !!

- یک وب سرویس جدید اضافه ‌شد.

وب سرویس جدید :
proxy (دریافت پروکسی به صورت رندوم)

- دو متد جدید اضافه شد

لیست متد های جدید :
imges
توصیحات imges : جهت تغییر رنگ تصاویر با فرمت jpg و جهت ساخت کپچا کاربرد دارد. مثال :
imges(['type'=>'CAPTCHA']);
در مثال بالا ربات یک عکس کپچا ارسال می‌کند.
imges(['type'=>'Changer','link'=>"imgeLink",'color'=>'red']);
در مثال بالا ربات عکس مد نظر را می‌گیرد و سپس رنگ تصویر را به قرمز تغییر می‌دهد.

buildBot
توصیحات buildBot :با استفاده از این متد می‌توانید توسط ربات خود یک ربات بسازید. کاربرد اصلی این متد برای طراحی رباتساز با کتابخانه می باشد.

-برای متد های بالا به زودی نمونه سورس جهت یادگیری قرار داده خواهد شد.


-متد start حذف شد.
تکمیلی مورد بالا : از این پس اطلاعات را جهت استارت کتابخانه داخل BPT_handler قرار می‌گیرد.

-دریافت نسخه بیس جدید :
https://bpt-proto.site/BPT/base.php

📄 مستندات و توضیحات
https://bpt-proto.site

👈 سورس ربات مطابق با آخرین ورژن 1.09

- نحوه استفاده از متد های :
dataSave
dataGet
buildBot
imges
eKey
🔺توضیحات هر متد کامنت شده است 🔺

🆑 @BPT_CH

👋 سلام و درود خدمت اعضای گرامی.

- لازم به ذکر است که تمامی دوستانی که از کتابخانه BPT استفاده می‌کنند لطفا فایل BPT.php که در کنار سورس ربات قرار دارد را حذف نمایند و سپس مجددا یکبار دیگر ربات خود را استارت کنند تا آخرین نسخه ی BPT نصب گردد.

در صورتی که از کتابخانه BPT استفاده نکرده اید نیاز به این کار نیست و به صورت خودکار ورژن جدید نصب خواهد شد.

با تشکر از همراهی شما عزیزان.

نسخه 1.10 کتابخانه منتشر شد !!

- دامنه کتابخانه از bpt-proto.site به bpt-proto.ir تغییر کرد

- دامنه وب سرویس ها از poty.fun به poty.ir تغییر کرد

- از حالا شما میتوانید با تنظیم ثابت AUTO_UPDATE آپدیت خودکار کتابخونه رو تنظیم کنید

- دیتابیس sql اضافه شد به ربات ، شما میتوانید نوع دیتابیس و اطلاعات مربوطه رو داخل تنظیمات اعمال کنید

توجه : امکان انتقال اطلاعات از یک نوع دیتابیس به نوع دیگر وجود ندارد و در صورت لزوم باید به صورت دستی صورت گیرد

- پراپرتی db از نوع public اضافه شد ، در صورتی که نوع دیتابیس sql تنظیم شده باشد آبجکت مربوط به کاکنشن دیتابیس را دارد و در صورتی که نوع دیتابیس json تنظیم شده باشد اطلاعات مربوط به نام فایل جیسون را داراست

- مقادیر جدیدی به بخش تنظیمات اضافه شده است :
مقدار db که یک آرایه میگیرد(اختیاری ، نوع پیش فرض : json)
در این آرایه باید مقدار type تنظیم شود که دو حالت میتواند داشته باشد json و sql

در صورتی که json بود نیاز به یک مقدار دیگر به نام file_name دارد(اختیاری ، مقدار پیش فرض : BPT-DB.json)

در صورتی که SQL بود نیاز به پنج مقدار دیگر دارد :
host
آدرس اتصال به دیتابیس(اختیاری ، پیش فرض : localhost)
port
پورت اتصال به دیتابیس(اختیاری ، پیش فرض : 3306)
user
نام کاربر جهت اتصال به دیتابیس(اجباری)
pass
پسورد مربوط به کاربر جهت اتصال به دیتابیس(اجباری)
name
نام دیتابیس جهت اتصال(اجباری)

- در صورتی که تنظیم split_update فعال باشد ، یک نوع آپدیت جدید اضافه شده به اسم somethingelse که به متدی با همین نام توی کلاس هندلر درخواست میده
این نوع تمام آپدیت ها رو شامل میشه به جز
message , edited_message , callback_query , inline_query
همچنین موقع ارسال کل آپدیت رو ارسال میکند!

- متد جدید تلگرام اضافه شد
deleteMyCommands

📄 مستندات و توضیحات
https://bpt-proto.ir

نسخه 1.11 کتابخانه منتشر شد !!

- رفع باگ های گزارش شده

- از این پس میتوانید با ارسال پارامتر token در ورودی متد های تلگرام ، متد ها رو روی ربات دیگری اجرا کنید

نمونه :
$this->getMe(['token'=>$token]);
$this->getWebHookInfo(['token'=>$token]);

📄 مستندات و توضیحات
https://bpt-proto.ir

نسخه 1.12 کتابخانه منتشر شد !!

- رفع باگ های گزارش شده

- اضافه شدن رنگ های زیر به متد imegs برای تغییر رنگ عکس (Changer)
lime (آهکی)
silver (نقره ای)
green (سبز)
crimson (زرشکی)
brown (قهوه ای)

-اضافه شدن پارامتر اختیاری done_text به متد imegs جهت تنظیم کپشن عکس های ارسالی.

-اضافه شدن پارامتر اختیاری model به متد imegs جهت ساخت کپچا
این پارامتر عدد 1 تا 5 را در ورودی دریافت میکند. مثال :
imges(['type'=>'CAPTCHA','model'=>3]);

📄 مستندات و توضیحات
https://bpt-proto.ir

نسخه 2.00 کتابخانه منتشر شد !!

- تغییر استایل جامع کتابخونه

- از این پس محدودیتی برای اجرای سورس روی لوکال هاست نیست ، لازم به ذکر است که محدودیت های تلگرام و کشور ها همچنان پابرجاست

- از این پس شما میتوانید روی http نیز کتابخانه را اجرا کنید ، البته باید در تنظیمات فایل certificate برای ssl را تنظیم کنید
این فایل را میتوانید از سرویس های ارائه دهنده ssl دریافت کنید.

- متد های مشابه بسیار زیادی اضافه شدند
به عنوان مثال :
sendDocument => sendDoc , document , doc
جهت دیدن تمامی متد های مشابه ، به صفحه مربوط به متد در مستندات مراجعه کنید

- از این پس میتوانید متد ها را تقریبا با هر شکلی که دوست دارید استفاده کنید
به عنوان مثال :
sendMessage => send_message , sendmessage , SendMessage , Send_Message , ...

- تنظیمات بسیاری به کتابخانه اضافه شد
جهت دیدن تنظیمات و توضیحات آنها به بخش مستندات -> __construct مراجعه کنید

- از این پس میتوانید نحوه دریافت آپدیت را تنظیم کنید
با استفاده از تنظیم receive در تنظیمات ، جهت دیدن اطلاعات بیشتر به مستندات مراجعه کنید

- از این پس میتوانید دیتابیس ربات را کلا آف کنید
جهت دیدن نحوه انجام و توضیحات بیشتر به مستندات مراجعه کنید

- از این پس میتوانید هندلر را خاموش و یا روشن کنید
با استفاده از تنظیم handler در تنظیمات ، جهت دیدن اطلاعات بیشتر به مستندات مراجعه کنید

- روشی جدید برای مولتی پروسس اضافه شد
این روش تنها وقتی اجرا میشود که روش قبلی قابل اجرا نباشد.

- از این پس متد های تلگرام شامل 3 پارامتر جدید نیز هستند
پارامتر های forgot,answer,return_array ، توضیحات بیشتر را در بخش مستندات یکی از متد های تلگرام مطالعه کنید

- از این پس کتابخانه به صورت خودکار تبدیل فایل را انجام میدهد
در صورت استفاده از متد هایی مانند sendPhoto ، اگر تنها آدرس فایل لوکال را در فیلد مربوطه ارسال کنید خود کتابخانه به صورت خودکار آن را قابل استفاده جهت تلگرام می کند.

- از این پس کتابخانه مقدار های پیشفرض بیشتری به صورت خودکار تنظیم میکند
این مقدار ها در صفحه مستندات مربوط به متد به صورت اختیاری ثبت شده اند

- لاگر ارتقا یافت
از این پس نوع لاگ را تعیین میکند

- 6 متد ویژه جدید اضافه شد
متد های :
catchFields
isToken
isUsername
ipInRange
isTelegram
isCloudFlare
توضیحات مربوط به متد ها را در صفحه مستندات مربوطه مطالعه کنید


- به ورژن 5.5 ای پی آی تلگرام ارتقا یافت
تمامی متد های جدید تلگرام اضافه شد.

- کامنت به متد های ویژه اضافه شد
جهت راحت تر شدن خواندن سورس کتابخانه و همچنین جهت کمک به کاربرانی که از IDE ها استفاده میکنند

- قالب سایت اصلی تغییر کرد

- مستندات کامل شد و قالب آن نیز تغییر کرد
مستندات فارسی همچنان غیرقابل دسترس است

- متد های buildBot و imges در نسخه آینده حذف خواهند شد
توصیه می شود که اقدامات مربوطه هر چه زودتر انجام شود

لازم به ذکر است که سورس های منطبق با ورژن های قبل مانند 1.12 بدون نیاز به تغییری همچنان کار خواهند کرد ولی بهتر است عملکرد سورس هایتان را بررسی کنید.

📄 مستندات و توضیحات
https://bptlib.ir