@marekd Great, thanks.

Awesome, I'm looking forward to it!

Would it be possible to add a link to the app to open plugins? The app already supports plugins but opening them is very cumbersome. I was able to load a plugin in the app using these steps:

1. Open some app which supports links but doesn't display them directly (e.g. WhatsApp works, Chrome or Facebook doesn't).
2. Open https://www.windy.com/plugins in it.
3. The OS (at least iOS) knows that there's an app which could open this link and opens the app instead.
4. Now I can load a plugin in the app.

I have many users interested in using my plugin in the Windy app.

The forecast from pluginDataLoader has these fields:

cbase: 4552
convPrecip: 0.1
day: "2019-11-05"
dewPoint: 278.5
gust: 8.0132
hour: 12
icon: 20
icon2: 20
isDay: 1
mm: 0.2
moonPhase: 7
origDate: "2019-11-05T13:00:00+01:00"
origTs: 1572955200000
pressure: 99904.47
rain: 1
rh: 76
snow: 0
snowPrecip: 0
temp: 282.5
ts: 1572951600000
weathercode: "OVC,CU,CS,,-,RA,,"
wind: 3.7
windDir: 234

Most of them are pretty self explanatory but can you please explain the meaning of icon, icon2, moonPhase and weathercode? Ideally at https://github.com/windycom/windy-plugins/blob/master/docs/WINDY_API.md#module-plugindataloader.

I'm interested mainly in displaying a simple weather icon - sunny, cloudy, rainy.

I make this request to https://api4.windy.com/api4/data/forecast:

{
  "model": "gfs",
  "lat": 49.9609,
  "lon": 14.6958, 
  "key": "---key---",
  "plugin": "windy-plugin-pg-mapa"
}

I receive this response:

{"header": {
  "model": "NOAA-GFS",
  "origLat": 50.53654293419482,
  "origLon": 14.889134366246362,
  "note": "Requested ECMWF data are FAKE and just for dev purposes."
}}

Note that I made a request for GFS but I got a ECMWF fake response. Also origLat and origLon doesn't match lat and lon which is probably related.

I would like to become a core Windy contributor and have my plugin windy-plugin-pg-mapa to be made an official Windy plugin.

@ivo said in How to document a plugin?:

Basicly the plugins are a slight security threat running JS in the same context. We plan to make nice plugin Gallery and loading/opening plugins much more easy, yet we do not believe that opening URL is good idea.

This way an attacker can submit an attacker can submit a link with malware JS plugin in path. We routinely check source code of published plugins to make sure this will not happen.

A simple solution which is not a security risk is to open a pre-filled form which the user has to confirm. E.g. https://www.windy.com/?plugin=windy-plugin-pg-mapa would open this:

The user then needs to click Load & activate.

The plugins are actually available on mobile, there's just no menu item for them. If you open https://www.windy.com/plugins on mobile then you can use them. If you open this link from other app (not a browser) then you can use them even in the Windy app (which hijacks the opened URL and opens itself, at least on iOS).

@marekd The plugins aren't available on mobile which is a deal breaker for me. But I'll probably create both the plugin and the app using API.

The plugins are actually available on mobile, there's just no menu item for them. If you open https://www.windy.com/plugins then you can use them. If you open this link from other app (not a browser) then you can use them even in the Windy app (which hijacks the opened URL and opens itself, at least on iOS).

Let us know if we should add your plugin to the list

I've created windy-plugin-pg-mapa. I would like it to be published. Please let me know if you need me to do something else.

There's also a Windy API version at https://pg.vrana.cz/mapa/ which works only with GFS but it's available on mobiles too.