From 12ab3e017d28e4854d9e8144fdf9f9498c21d0aa Mon Sep 17 00:00:00 2001 From: Sipke Schoorstra Date: Thu, 8 Oct 2026 20:49:06 +0200 Subject: [PATCH] docs: route new Extensions contributions to Core --- CONTRIBUTING.md | 6 ++-- README.md | 84 +++++++++++++++++++++++++------------------------ 2 files changed, 47 insertions(+), 43 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 77c8a2ff..f0887962 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,6 +2,8 @@ Thank you for your interest in contributing to Elsa. +For new Extensions development, contribute in [Elsa Core's `extensions/` directory](https://github.com/elsa-workflows/elsa-core/tree/main/extensions) using the [Core contribution guide](https://github.com/elsa-workflows/elsa-core/blob/main/CONTRIBUTING.md). Keep original issue/PR links and contributor attribution when continuing work there; the [handoff register](https://github.com/elsa-workflows/elsa-core/blob/main/docs/integration-program/source-handoff-register.json) preserves source references. Existing 3.8/3.9 maintenance procedures and release branches are unchanged by this notice. + We value clarity, discipline, and maintainability in our codebase. Well-scoped pull requests and high-quality bug reports help us maintain velocity without sacrificing quality. Whether you're: @@ -19,7 +21,7 @@ Whether you're: Elsa follows **Trunk Based Development**. -All changes happen through Pull Requests targeting the `main` branch. +For work targeting this repository's `main` branch, follow these steps: 1. Fork the repository and create your branch from `main`. 2. If you've added code that should be tested, add tests. @@ -81,7 +83,7 @@ If a change is large, consider splitting it into incremental PRs. ## Reporting Bugs -We use GitHub Issues to track bugs and feature requests. +Use [Core issues](https://github.com/elsa-workflows/elsa-core/issues/new/choose) for new Extensions development. Existing 3.8/3.9 maintenance reporting procedures are unchanged by this notice. When reporting a bug, please include: diff --git a/README.md b/README.md index c04cac7c..94bb35a0 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # Elsa Extensions +> New Extensions development now lives in [Elsa Core's `extensions/` directory](https://github.com/elsa-workflows/elsa-core/tree/main/extensions). Open new-development [issues](https://github.com/elsa-workflows/elsa-core/issues/new/choose) and [pull requests](https://github.com/elsa-workflows/elsa-core/pulls) in Core and follow its [contribution guide](https://github.com/elsa-workflows/elsa-core/blob/main/CONTRIBUTING.md). Existing 3.8/3.9 maintenance procedures and release branches are unchanged by this notice. Original issues, PRs and contributor history remain here; see the [source handoff register](https://github.com/elsa-workflows/elsa-core/blob/main/docs/integration-program/source-handoff-register.json). + Welcome to the **Elsa Extensions** repository! This project provides a collection of extension modules for [Elsa Workflows](https://github.com/elsa-workflows/elsa-core), enabling seamless workflow automation across various third-party services. --- @@ -16,90 +18,90 @@ Below is the current status of each extension. Icons indicate implementation pro ### 📨 Messaging & Communication | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **Telegram** | Send & receive messages, file downloads | `Elsa.Telegram` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Telegram** | Send & receive messages, file downloads | `Elsa.Telegram` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | | [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/slack/Elsa.Slack) | **Slack** | Channel messages, user notifications | `Elsa.Slack` | [View Issue](https://github.com/elsa-workflows/elsa-extensions/issues/26) | -| 🔲 | **Discord** | Bot commands, message triggers | `Elsa.Discord` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Microsoft Teams** | Chat automation, meeting reminders | `Elsa.Teams` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| [✅](https://github.com/elsa-workflows/elsa-extensions/tree/main/src/telnyx/Elsa.Telnyx) | **Telnyx** | Telephony automation | `Elsa.Telnyx` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Discord** | Bot commands, message triggers | `Elsa.Discord` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Microsoft Teams** | Chat automation, meeting reminders | `Elsa.Teams` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| [✅](https://github.com/elsa-workflows/elsa-extensions/tree/main/src/telnyx/Elsa.Telnyx) | **Telnyx** | Telephony automation | `Elsa.Telnyx` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 📧 Email & Productivity | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **Gmail** | Send, receive, label, draft emails | `Elsa.Gmail` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Outlook (Office 365)** | Email management via Microsoft Graph API | `Elsa.Outlook` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Google Calendar** | Event scheduling and updates | `Elsa.GoogleCalendar` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Microsoft Calendar** | Office 365 calendar extension | `Elsa.Office365Calendar` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Gmail** | Send, receive, label, draft emails | `Elsa.Gmail` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Outlook (Office 365)** | Email management via Microsoft Graph API | `Elsa.Outlook` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Google Calendar** | Event scheduling and updates | `Elsa.GoogleCalendar` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Microsoft Calendar** | Office 365 calendar extension | `Elsa.Office365Calendar` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 🗄️ Storage Services | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **Google Drive** | Upload, download, manage files | `Elsa.GoogleDrive` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **OneDrive** | File storage and access for Office 365 | `Elsa.OneDrive` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Google Drive** | Upload, download, manage files | `Elsa.GoogleDrive` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **OneDrive** | File storage and access for Office 365 | `Elsa.OneDrive` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | | 🚧 | **Azure Storage** | Blob storage management | `Elsa.AzureStorage` | [View Issue](https://github.com/elsa-workflows/elsa-extensions/issues/1) | -| 🔲 | **Dropbox** | Cloud storage and file sync | `Elsa.Dropbox` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Dropbox** | Cloud storage and file sync | `Elsa.Dropbox` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 🗃️ Databases (SQL) | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/sql/README.md) | **MySql** | Connect and query MySQL databases | `Elsa.Sql.MySql` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/sql/README.md) | **PostgreSql** | Connect and query PostgreSql databases | `Elsa.Sql.PostgreSql` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/sql/README.md) | **Sqlite** | Connect and query Sqlite databases | `Elsa.Sql.Sqlite` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/sql/README.md) | **Sql Server** | Connect and query Microsoft SQL Server databases | `Elsa.Sql.SqlServer` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/sql/README.md) | **MySql** | Connect and query MySQL databases | `Elsa.Sql.MySql` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/sql/README.md) | **PostgreSql** | Connect and query PostgreSql databases | `Elsa.Sql.PostgreSql` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/sql/README.md) | **Sqlite** | Connect and query Sqlite databases | `Elsa.Sql.Sqlite` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| [✅]( https://github.com/elsa-workflows/elsa-extensions/tree/main/src/sql/README.md) | **Sql Server** | Connect and query Microsoft SQL Server databases | `Elsa.Sql.SqlServer` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 🛠 DevOps & Monitoring | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **Azure DevOps** | Pipelines, repositories, work items | `Elsa.AzureDevOps` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Azure DevOps** | Pipelines, repositories, work items | `Elsa.AzureDevOps` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | | [✅](https://github.com/elsa-workflows/elsa-extensions/tree/main/src/devops/Elsa.DevOps.GitHub/README.md) | **GitHub** | PR automation, repo events | `Elsa.DevOps.GitHub` | [Fixed Issue](https://github.com/elsa-workflows/elsa-extensions/issues/6) | -| 🔲 | **GitLab** | CI/CD triggers and repo management | `Elsa.GitLab` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Jenkins** | Pipeline automation and job execution | `Elsa.Jenkins` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Datadog** | Monitoring, logging, and alerts | `Elsa.Datadog` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **GitLab** | CI/CD triggers and repo management | `Elsa.GitLab` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Jenkins** | Pipeline automation and job execution | `Elsa.Jenkins` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Datadog** | Monitoring, logging, and alerts | `Elsa.Datadog` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### ☁️ Cloud Compute & Serverless | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **Azure Functions** | Serverless function triggers | `Elsa.AzureFunctions` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **AWS Lambda** | Invoke and trigger Lambda functions | `Elsa.AWSLambda` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Google Cloud Functions** | Event-driven function automation | `Elsa.GoogleCloudFunctions` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Azure Functions** | Serverless function triggers | `Elsa.AzureFunctions` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **AWS Lambda** | Invoke and trigger Lambda functions | `Elsa.AWSLambda` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Google Cloud Functions** | Event-driven function automation | `Elsa.GoogleCloudFunctions` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 📊 CRM & Sales Automation | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **Salesforce** | Lead management, opportunity tracking | `Elsa.Salesforce` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **HubSpot** | Contacts, deals, email automation | `Elsa.HubSpot` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Zoho CRM** | Lead scoring, campaign tracking | `Elsa.ZohoCRM` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Pipedrive** | Sales pipeline automation | `Elsa.Pipedrive` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Salesforce** | Lead management, opportunity tracking | `Elsa.Salesforce` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **HubSpot** | Contacts, deals, email automation | `Elsa.HubSpot` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Zoho CRM** | Lead scoring, campaign tracking | `Elsa.ZohoCRM` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Pipedrive** | Sales pipeline automation | `Elsa.Pipedrive` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 💰 Payments & Finance | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **Stripe** | Payment processing, subscriptions | `Elsa.Stripe` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **PayPal** | Transactions, refunds, invoicing | `Elsa.PayPal` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Square** | POS and e-commerce transactions | `Elsa.Square` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **QuickBooks** | Invoice and expense automation | `Elsa.QuickBooks` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **Stripe** | Payment processing, subscriptions | `Elsa.Stripe` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **PayPal** | Transactions, refunds, invoicing | `Elsa.PayPal` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Square** | POS and e-commerce transactions | `Elsa.Square` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **QuickBooks** | Invoice and expense automation | `Elsa.QuickBooks` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 🤖 AI & Automation | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **OpenAI** | GPT-based text generation, chatbots | `Elsa.OpenAI` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Google AI** | AI-enhanced search, translation | `Elsa.GoogleAI` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **AWS Comprehend** | NLP services for text analysis | `Elsa.AWSComprehend` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Azure AI** | Vision, speech, language processing | `Elsa.AzureAI` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **OpenAI** | GPT-based text generation, chatbots | `Elsa.OpenAI` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Google AI** | AI-enhanced search, translation | `Elsa.GoogleAI` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **AWS Comprehend** | NLP services for text analysis | `Elsa.AWSComprehend` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Azure AI** | Vision, speech, language processing | `Elsa.AzureAI` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 🎥 Video & Streaming Platforms | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **YouTube** | Upload videos, retrieve video details, manage playlists | `Elsa.YouTube` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new)| -| 🔲 | **Rumble** | Upload videos, fetch channel videos, manage content | `Elsa.Rumble` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Twitch** | Live stream events, chat automation, clip management | `Elsa.Twitch` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Vimeo** | Upload videos, manage privacy settings, get video analytics | `Elsa.Vimeo` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **YouTube** | Upload videos, retrieve video details, manage playlists | `Elsa.YouTube` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose)| +| 🔲 | **Rumble** | Upload videos, fetch channel videos, manage content | `Elsa.Rumble` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Twitch** | Live stream events, chat automation, clip management | `Elsa.Twitch` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Vimeo** | Upload videos, manage privacy settings, get video analytics | `Elsa.Vimeo` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ### 🏭 Industrial Communication Protocols | Status | Extension | Description | Module Name | Issue | |--------|------------|-------------|-------------|-------| -| 🔲 | **OPC UA** | Browse nodes, Read/Write values, Subscribe/Unsubscribe nodes | `Elsa.OPC.UA` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **Modbus** | Read/Write coils, Read discrete Inputs, Read/Write registers | `Elsa.Modbus` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | -| 🔲 | **MQTT Sparkplug** | Discover and Subscribe to topics, Publish messages | `Elsa.MQTT.Sparkplug` | [Open Issue](https://github.com/elsa-workflows/elsa-extensions/issues/new) | +| 🔲 | **OPC UA** | Browse nodes, Read/Write values, Subscribe/Unsubscribe nodes | `Elsa.OPC.UA` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **Modbus** | Read/Write coils, Read discrete Inputs, Read/Write registers | `Elsa.Modbus` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | +| 🔲 | **MQTT Sparkplug** | Discover and Subscribe to topics, Publish messages | `Elsa.MQTT.Sparkplug` | [Open Issue](https://github.com/elsa-workflows/elsa-core/issues/new/choose) | ---