¿Qué es un plugin?
Queremos que grammY sea conciso y mínimo, pero extensible. ¿Por qué? Porque no todo el mundo utiliza todo. Los plugins están diseñados como funcionalidades extra añadidas a dichas piezas de software.
Plugins en grammY
Algunos plugins están directamente integrados en la biblioteca central de grammY porque asumimos que muchos bots los necesitan. Esto hace que sea más fácil para los nuevos usuarios utilizarlos, sin tener que instalar un nuevo paquete primero.
La mayoría de los plugins se publican junto al paquete principal de grammY, los llamamos complementos oficiales. Se instalan desde @grammyjs en npm, y se publican bajo la organización @grammyjs en GitHub. Coordinamos sus lanzamientos con los lanzamientos de grammY, y nos aseguramos de que todo funcione bien en conjunto. Cada sección de la documentación de un plugin oficial tiene el nombre del paquete en su título. Como ejemplo, el plugin grammY runner (runner) necesita ser instalado vía npm install @grammyjs. (Si estás usando Deno y no Node.js, debes importar el plugin desde https://mod del módulo grammy).
También hay algunos plugins de terceros. Cualquiera puede publicarlos. No garantizamos que estén actualizados, bien documentados o que funcionen con otros plugins. Si quieres, tu propio plugin de terceros también puede aparecer en el sitio web para que más gente pueda conocerlo.
Visión general
Hemos compilado una visión general para usted con breves descripciones para cada plugin. Instalar plugins es divertido y fácil, y queremos que sepas lo que tenemos para ti.
Haga clic en el nombre de cualquier paquete para obtener más información sobre el respectivo plugin.
| Plugin | Paquete | Descripción |
|---|---|---|
| Sesiones | incluido | Almacena los datos de los usuarios en su base de datos |
| Teclados en línea y personalizados | incluido | Simplifique la creación de teclados en línea y personalizados |
| Grupos de medios | incluido | Simplificar el envío de grupos de medios y la edición de medios |
| Consultas en línea | incluido | Construya fácilmente resultados para consultas en línea |
| Auto | auto | Gestión automática de la limitación de velocidad |
| Conversaciones | conversations | Construya potentes interfaces y diálogos conversacionales |
| Miembros de chat | chat | Saber qué usuario se ha unido a qué chat |
| Emojis | emoji | Simplificar el uso de emoji en el código |
| Archivos | files | Manejar archivos fácilmente |
| Hidratar | hydrate | Llamar a métodos de objetos devueltos por llamadas a la API |
| Internacionalización | i18n o fluent | Deja que tu bot hable varios idiomas |
| Menús interactivos | menu | Diseñe menús de botones dinámicos con navegación flexible |
| Parsear | parse | Simplificar el formato de los mensajes |
| Limitador de velocidad | ratelimiter | Restringe automáticamente a los usuarios que envían spam a tu bot |
| Enrutador | router | Dirija los mensajes a diferentes partes de su código |
| Concurrencia | runner | Realizar long polling de forma simultánea y a escala |
| Preguntas sin estado | stateless | Crear diálogos sin almacenamiento de datos |
| Control de flujo | transformer | Ralentizar las llamadas a la API |
También tenemos algunos plugins de terceros. Puedes encontrarlos en el menú de navegación en Complementos > De Terceros. Asegúrese de comprobarlos también.
Tipos de Plugins en grammY
Todo lo que brilla es oro, ¿verdad? Bueno, ¡un tipo diferente de oro! grammY puede aprovechar dos tipos de plugins: plugins middleware y plugins transformadores. En términos simples, los plugins en grammY devuelven una función middleware o una función transformadora. Hablemos de las diferencias.
Tipo I: Plugins Middleware
Middleware es una función que maneja los datos entrantes en varias formas. Los plugins de middleware son plugins que se introducen en un bot como—bueno, lo has adivinado—middleware. Esto significa que se instalan a través de bot.
Tipo II: Plugins transformadores
Una función transformadora es lo contrario del middleware. Es una función que maneja los datos de salida. Los plugins transformadores son plugins que se introducen en un bot como una—¡lo has adivinado!—función transformadora. Esto significa que los instalas a través de bot.
Crear tus propios plugins
Si quieres desarrollar un plugin y compartirlo con otros usuarios (incluso publicarlo en la web oficial de grammY), hay una guía útil que puedes consultar.
Ideas para más plugins
Estamos recogiendo ideas para nuevos plugins en Git