=== Economicium Widget ===
Contributors: economicium
Tags: widget, finance, news, market, embed
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed Economicium's free economic-news and live market-mood widgets with a simple shortcode.

== Description ==

Add a free, self-updating Economicium widget to any post, page or widget area. Two widget types:

* **Latest stories** - a compact, auto-updating list of the newest economic-news summaries.
* **Market mood** - the bullish / neutral / bearish split of recent news.

No account, no API key. Filter to a single category (crypto, energy, markets and more), switch between a light and dark card, and choose how many stories to show.

**Shortcode**

`[economicium]`

Attributes:

* `type` - `latest` (default) or `mood`
* `category` - a category slug such as `crypto`, `energy`, `markets` (default: all)
* `theme` - `light` (default) or `dark`
* `limit` - 1 to 8 stories (default 5); latest only
* `title` - a custom heading
* `mode` - `script` (default, includes a link back to Economicium) or `iframe` (most portable)

Examples:

`[economicium type="mood" category="crypto" theme="dark"]`
`[economicium type="latest" limit="6"]`

== External services ==

This plugin renders the widget by loading a small script (`embed.js`) or an `<iframe>` from Economicium (https://economicium.com). When a visitor views a page containing the widget, their browser requests the widget markup and the latest headlines / market-mood data from economicium.com. No personal data is sent by the plugin; standard web-server request metadata (such as IP address, handled by economicium.com) applies as with any embedded content.

* Service: Economicium - https://economicium.com
* Terms: https://economicium.com/disclaimer
* Privacy: https://economicium.com/privacy

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install it from the WordPress plugin directory.
2. Activate it through the "Plugins" screen.
3. Add `[economicium]` to any post, page, or a Shortcode block. Adjust the attributes as needed.

== Frequently Asked Questions ==

= Does it cost anything? =

No. The widget is free to use. A small "Powered by Economicium" credit stays visible.

= Will it slow down my site? =

The script loads asynchronously and the data is cached, so it does not block your page from rendering.

= Can I show only one category? =

Yes. Use the `category` attribute, for example `[economicium category="energy"]`.

== Screenshots ==

1. Latest stories: a compact, auto-updating list of the newest economic-news summaries, each tagged by category.
2. Market mood: the bullish / neutral / bearish split of recent news at a glance.
3. Dark theme: switch either widget to a dark card to match your site.

== Changelog ==

= 1.0.1 =
* Load the widget script via wp_enqueue_script() (async, in the footer) instead of a hardcoded script tag, per the WordPress.org plugin guidelines. Per-widget options now sit on the mount div, so one enqueued script can power multiple widgets on a page.

= 1.0.0 =
* Initial release: `[economicium]` shortcode with latest / market-mood widgets, category, theme, limit and iframe options.
