Los plugins extienden EmDash a través de una superficie de extensión definida. Pueden reaccionar a eventos del ciclo de vida del contenido, almacenar sus propios datos, exponer configuraciones a los administradores, agregar páginas al panel de administración y servir rutas de API.
Qué pueden hacer los plugins
Reaccionar a eventos
Ejecutar código al guardar contenido, subir medios, moderar comentarios, tareas programadas y eventos del ciclo de vida del plugin.
Almacenar datos
Persistir registros específicos del plugin en colecciones indexadas, más un almacén clave-valor por plugin para configuraciones y estado.
Agregar páginas de administración
Contribuir páginas y widgets de dashboard al panel de administración, con formularios de configuración autogenerados.
Servir rutas de API
Exponer endpoints bajo /_emdash/api/plugins/<id>/<route> para la UI de administración o integraciones externas.
Llamar APIs externas
Realizar solicitudes HTTP con listas de hosts declaradas permitidas.
Enviar correo electrónico
Enviar correo transaccional a través del proveedor configurado.
Dos tipos de plugins
Los plugins de EmDash vienen en dos formatos:
- Plugins en sandbox se ejecutan en un entorno de ejecución aislado gestionado por un ejecutor de sandbox configurable. Pueden instalarse desde el marketplace con un clic, están sujetos a cumplimiento de capacidades y recursos, y solo alcanzan las APIs que declaran. Esta es la opción recomendada para la mayoría de los plugins.
- Plugins nativos se ejecutan en el mismo proceso que su sitio Astro. Tienen acceso completo al entorno de ejecución, pueden incluir páginas de administración React y componentes de renderizado de Portable Text, e inyectar HTML en páginas públicas. Se instalan mediante un cambio de código más un despliegue, y se ejecutan desde npm en lugar del marketplace.
Si está instalando un plugin que otra persona creó, casi siempre querrá sandbox. Si está creando uno usted mismo, consulte Elegir un formato de plugin.
Para operadores de sitios
Si desea instalar o configurar plugins en su sitio:
Instalar plugins
Instalar desde el marketplace, habilitar, configurar ajustes.
Para autores de plugins
Si desea crear un plugin: