=== Extraportale Widgets ===
Contributors: borelliweb
Tags: widget, weather, clock, horoscope, calculator
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free widgets for your site: clock, weather, horoscope, news, Lotto, calculators, currency converter and more. In 6 languages.

== Description ==

Add the free widgets of [Extraportale](https://www.extraportale.com/) to your WordPress site in a few clicks. They update themselves and are available in Italian, English, Spanish, French, German and Portuguese.

**Information**
* Clock and date, weather, sun and moon, daily horoscope, news

**TV and leisure**
* Tonight on TV and the latest Lotto draw (Italian)

**Calculators and tools**
* Calculator, percentages, VAT, unit converter, days between two dates, age calculator, Italian tax code

**Finance**
* Currency converter, mortgage payment, compound interest, severance pay (TFR)

**Three ways to use them**

1. **Block**: search for "Extraportale" in the block editor and choose the widget, language and alignment.
2. **Shortcode**: `[extraportale widget="meteo"]`. Optional attributes: `lang` (auto, it, en, es, fr, de, pt), `width`, `height`, `align` (left, center).
3. **Sidebar widget**: Appearance → Widgets → Extraportale.

Settings → Extraportale Widgets lists every widget with its shortcode and a live preview, and lets you choose the default language ("auto" follows the language of your site).

The widgets are shown in an iframe, so they never slow down or interfere with your theme. A link to Extraportale is displayed under each widget and must stay visible: see the terms of use at https://www.extraportale.com/webmaster.html#condizioni

== External services ==

This plugin does not store or process any data on your server. It displays widgets hosted by Extraportale inside an iframe, so it depends on the following external services.

**Extraportale widget pages (www.extraportale.com)**: every widget is a page served by https://www.extraportale.com/widget/. When a visitor opens a page of your site that contains a widget, the visitor's browser requests that page from Extraportale; this sends the visitor's IP address and the usual browser request data (such as user agent and the address of your page as referrer) to Extraportale. Terms of use: https://www.extraportale.com/webmaster.html#condizioni

**Google Analytics (googletagmanager.com)**: the widget pages use Google Analytics to measure visits to the widgets. Privacy policy: https://policies.google.com/privacy. Depending on your country, you may need to mention this in your site's privacy and cookie policy.

**Open-Meteo (api.open-meteo.com)**: the weather widget requests the forecast for the chosen city from this service. Terms: https://open-meteo.com/en/terms

**Frankfurter (api.frankfurter.dev)**: the currency converter requests exchange rates published by the European Central Bank. https://frankfurter.dev/

**Film posters**: the "Tonight on TV" widget (Italian) may show a film poster loaded from the image host indicated by the TV listings data.

== Installation ==

1. Upload the `extraportale-widgets` folder to `/wp-content/plugins/`, or install the zip from Plugins → Add New → Upload Plugin.
2. Activate the plugin.
3. Add a widget with the "Extraportale" block, with a shortcode, or from Appearance → Widgets.

== Frequently Asked Questions ==

= Is it really free? =

Yes. The only condition is to keep the link to Extraportale visible under each widget.

= Can I change the size of a widget? =

Yes: use the `width` and `height` attributes of the shortcode. The default sizes are the ones that show the whole widget.

= Which language is used? =

By default the language of your site, if it is one of the six supported languages (otherwise English). You can set a default language in Settings → Extraportale Widgets or choose one for each widget.

= Do the widgets work on any theme? =

Yes, they are shown in an iframe, independent of your theme.

== Changelog ==

= 1.0.0 =
* First release.
