Ventus – Weather Map Widget & Shortcode

Ventus allows you to easily embed the windy.com widget on your website, in the form of a native WordPress widget (accessible from Appearance > Widgets) or as a simple shortcode.

It is a lightweight plugin built using an object-oriented approach, and follows WordPress Coding Standards.

Features

• Set the overlay to either clouds, CO concentration, currents, radar/lightning, rain, sea temperature, snow cover, standard temperature, waves, wind or wind gusts.
• Use either Celsius or Fahrenheit as the temperature scale.
• Set the width, height and border-radius using responsive (%) and/or fixed (px) values.
• Manually define longitude and latitude for precise location coordinates.
• Select the altitude from surface up to 13.5km (effective only when layer is set to wind or temperature).
• Choose from 8 levels of zoom (min. 3, max. 11).
• Show or hide pressure isolines, the map marker and spot forecast.
• Choose from the following wind measurement units: beaufort (bft), kilometers per hour (km/h), knots (kt), meters per second (m/s) and miles per hour (mph).
• Choose from the following forecast models: ECMWF, ICON, ICON-EU, GFS and NEMS.
• Set the forecast time from now to 12 or 24 hours ahead.

Shortcodes

The shortcode accepts up to 16 attributes. You can simply use [ventus] and it will work (or the old shortcode [weather-map] which will continue to work), but you will most likely want to customise the remaining attributes yourself.

An example of a fully filled-out shortcode would be:

[ventus width="100%" height="350px" radius="20px" loading="lazy" lat="53.199" lon="-7.603" zoom="4" layer="wind" level="surface" scale="C" units="knots" pressure="true" marker="true" model="ecmwf" forecast="true" time="12"]

The attributes can be set as follows:

• The width attribute accepts any valid CSS property for width.
• The height attribute accepts any valid CSS property for height.
• The radius attribute accepts any valid CSS property for border-radius.
• The loading attribute accepts either lazy or eager. The default is lazy loading.
• The lat attribute must contain a string of digits to three decimal places, in the range of -90 to +90 (e.g. “53.199”).
• The lon attribute must also contain a string of digits to three decimal places, in the range of -180 to +180 (e.g. “-120.894”).
• The zoom attribute must contain a number between 3 and 11 (inclusive).
• The layer attribute accepts the following values: clouds, cosc (CO concentration), currents, gust, radar, rain, snowcover, sst (sea temperature), temp (standard temperature), waves and wind.
• The level attribute (only effective when the layer is wind or temp) accepts the following values: surface, 100m, 950h (600m), 925h (750m), 900h (900m), 850h (1500m), 800h (2000m), 700h (3000m), 600h (4200m), 500h (5500m), 400h (7000m), 300h (9000m), 250h (10000m), 200h (11700m) and 150h (13500m).
• The scale attribute accepts either “C” or “F”, defining Celsius and Fahrenheit respectively.
• The units attribute accepts the following values: bft (beaufort), km/h (kilometers per hour), kt (knots), m/s (meters per second) and mph (miles per hour).
• The pressure attribute can be set to true to display pressure isolines, otherwise the isolines will remain hidden.
• The marker attribute can also be set to true, otherwise it will remain hidden.
• The forecast attribute can be set to true to display the spot forecast, otherwise it will remain hidden.
• The time attribute accepts the following values: now (the default), 12 (12 hours from now) and 24 (24 hours from now).
• The model attribute accepts the following values: ecmwf, icon, iconEu, gfs and nems.

Note that in the case of an invalid value, a default value will be used instead.