aboutsummaryrefslogtreecommitdiffstats
path: root/.github/ISSUE_TEMPLATE/recipe_request.md
blob: c32ea1a86df7961b56dcfe096e2f2543bf07b1f4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
---
name: A Recipe Request
about: Suggest a service that we should add to Ferdi
title: '<SERVICE>'
labels: 'recipe request'
assignees: ''

---
<!--
Before creating a new recipe request please check if you can add it yourself.
If you add a recipe yourself it will be added faster than having to go through other contributors to do this job for you.

As a first option to adding a service we recommend you search if someone already created such a recipe. For this, please search for your service name plus "Franz" on Github (e.g "WhatsApp Franz"), optionally you can also add "recipe" to the search query (e.g. "WhatsApp Franz recipe"). If you find a recipe (e.g. https://github.com/meetfranz/recipe-whatsapp), please check that its license allows us to add it to the repository. For this, open the "package.json" file of the project and look at the specified license. In most cases this will be '"license": "MIT"': The MIT License allows us to add the recipe! Please also check that the recipe is working (e.g. by adding it as a dev recipe to your Ferdi installation or looking if there are existing issues on the repository) and that it contains your desired features (e.g. look at the README). Another good indicator for if the recipe supports notifications is if there is code inside the "webview.js" file.
After finding a recipe you can let our fetch script add it to the repository for you. For this, please fork this repository on GitHub and follow the instructions on https://github.com/getferdi/recipes#importing-recipes-from-github. After adding the recipe, please create a PR back to this repository.

If there is no repository on GitHub you can also create one yourself - this often only takes 10-20 minutes and makes it much more likely that your service will get added! To create a recipe please look at this guide from Franz: https://github.com/meetfranz/plugins/blob/master/docs/integration.md.

IF YOU ARE NOT FAMILIAR WITH JAVASCRIPT: Please still search for a recipe using the guide above and add it to your request.
-->


<!-- Please complete the following form to create your recipe request: -->
Name of the service (e.g. WhatsApp): 
URL of the service (e.g. whatsapp.com):

GitHub URL to a recipe <!-- (optional but highly recommended. Please look at the intructions above)  -->: https://github.com/...

Features you want implemented (optional):
<!-- In this list you can write features you want this service to support, e.g. Notification support -->
-