Apa Itu Plugin?
Kami ingin grammY menjadi ringkas dan minimal, tetapi bisa diperluas. Kenapa? Karena tidak semua orang akan menggunakan semua fiturnya! Plugin didesain sebagai fitur atau fungsionalitas ekstra yang ditambahkan ke dalam sebuah software.
Plugin di grammY
Beberapa plugin sudah disediakan secara bawaan di dalam library inti grammY, karena kami merasa banyak bot yang akan membutuhkan fitur-fitur tersebut. Dengan begitu, user baru akan lebih mudah menggunakannya karena tidak perlu menginstal package tambahan terlebih dahulu.
Sebagian besar plugin dipublikasikan bersama dengan package inti grammY, yang kami sebut sebagai plugin resmi. Plugin-plugin ini bisa diinstal dari @grammyjs melalui npm, dan mereka semua dipublikasikan oleh organisasi @grammyjs di GitHub. Selain itu, kami juga selalu memastikan semua plugin berjalan dengan baik di setiap rilisan grammY. Khusus untuk plugin resmi, nama package-nya selalu disertakan di judul dokumentasi masing-masing plugin. Contohnya, plugin grammy runner (runner) bisa diinstal melalui npm install @grammyjs (Kalau kamu menggunakan Deno, kamu bisa meng-import plugin dari https://mod di module grammy).
Kami juga menyediakan beberapa plugin pihak ketiga. Siapapun bisa mempublikasikan plugin jenis ini. Tetapi, kami tidak bisa menjamin plugin tersebut akan selalu diperbarui, terdokumentasi secara lengkap, ataupun kompatibel dengan plugin-plugin lain. Kamu juga bisa membuat plugin pihak ketigamu terdaftar di website ini agar orang-orang bisa menemukannya dengan mudah.
Gambaran Umum
Kami menyediakan daftar setiap plugin yang tersedia beserta deskripsi singkat di dalamnya. Memasang plugin-plugin ini cukup mudah dan menyenangkan, dan kami ingin kalian semua tahu plugin apa saja yang telah tersedia.
Klik nama package berikut untuk mempelajari lebih lanjut mengenai plugin tersebut.
| Plugin | Package | Deskripsi |
|---|---|---|
| Session | bawaan | Menyimpan data user di database kamu |
| Keyboard Custom dan Inline | bawaan | Membuat keyboard custom dan inline dengan mudah |
| Pengulang Request API | auto | Menangani rate limit secara otomatis |
| Percakapan | conversations | Membuat antarmuka percakapan dan dialog |
| Emoji | emoji | Menggunakan emoji di kode dengan mudah |
| File | files | Menangani file dengan mudah |
| Hidrasi | hydrate | Memanggil method untuk object yang dikembalikan dari pemanggilan API |
| Internationalization | i18n atau fluent | Membuat bot kamu bisa berbicara dengan berbagai bahasa |
| Menu Interaktif | menu | Mendesain tombol menu secara dinamis dengan navigasi yang fleksibel |
| Parse Mode | parse | Memformat pesan dengan mudah |
| Rate Limit User | ratelimiter | Otomatis membatasi user yang melakukan spam ke bot kamu |
| Router | router | Mengarahkan pesan ke beberapa bagian di kode kamu |
| Runner | runner | Menggunakan long polling secara bersamaan dalam skala besar |
| Stateless Question | stateless | Membuat dialog tanpa menggunakan penyimpanan data |
| Kontrol Flood | transformer | Membuat antrian pemanggilan API secara otomatis untuk mencegah terjadinya flood wait |
Kami juga punya plugin pihak ketiga! Kamu bisa menemukannya di menu navigasi Plugin > Pihak Ketiga. Jangan lupa untuk mengeceknya juga!
Jenis-Jenis Plugin di grammY
Semua yang berkilau adalah emas, benar? Emas yang berbeda tentunya! grammY memiliki dua jenis plugin: plugin middleware dan plugin transformer. Singkatnya, plugin di grammY mengembalikan sebuah function entah berupa middleware ataupun transformer. Mari kita bahas perbedaanya.
Jenis I: Plugin Middleware
Middleware adalah sebuah function yang menangani data yang masuk apapun bentuknya. Sehingga, plugin middleware adalah plugin yang diberikan ke bot dalam bentuk—yup, tebakanmu benar—middleware. Artinya, kamu bisa menggunakannya melalui bot.
Jenis II: Plugin Transformer
Function transformer adalah kebalikan dari middleware! Ia adalah sebuah function yang menangani data yang keluar. Dengan begitu, plugin transformer adalah plugin yang diberikan ke bot dalam bentuk—wow! tebakanmu benar lagi!—function transformer. Artinya, kamu bisa menggunakannya melalui bot.
Buat Plugin-mu Sendiri
Kalau kamu berniat membuat sebuah plugin dan ingin membagikannya ke pengguna lain (atau bahkan mempublikasikannya di website resmi grammY), berikut panduan yang bisa kamu ikuti.
Ide untuk Plugin-Plugin Berikutnya
Kami mengumpulkan berbagai ide dan saran untuk plugin-plugin baru di Git