=== MeltOffer Metal Value Widgets ===
Tags: gold price, silver price, melt value, calculator, coin values
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed free live metal prices, melt calculators, and US coin melt-value tables with one shortcode.

== Description ==

MeltOffer Metal Value Widgets adds the `[meltoffer_widget]` shortcode. It has no settings screen, account, API key, MeltOffer analytics, or stored calculator data.

Examples:

* `[meltoffer_widget]` shows gold and silver prices.
* `[meltoffer_widget type="prices" metal="silver" theme="dark" size="compact"]`
* `[meltoffer_widget type="calculator" metal="gold"]`
* `[meltoffer_widget type="coins" metal="silver"]`

Supported values:

* `type`: `prices`, `calculator`, or `coins`
* `metal`: `gold` or `silver`; omit it to show both in the price widget
* `theme`: `light` or `dark`
* `size`: `standard` or `compact` for the price widget

The widgets are informational tools, not appraisals or offers to buy metal.

== Installation ==

1. Upload the plugin ZIP through Plugins > Add New > Upload Plugin.
2. Activate MeltOffer Metal Value Widgets.
3. Add a Shortcode block to a post, page, or template.
4. Enter `[meltoffer_widget]` or one of the examples above.

== External services ==

The plugin renders an iframe from `https://meltoffer.com` only where a site editor adds the shortcode. MeltOffer supplies the widget interface and fallback prices. The embedded page then requests current precious-metal prices from `https://api.gold-api.com`; that request discloses the visitor's IP address and standard browser request data to Gold API. If the request fails, the widget keeps its visible fallback price.

MeltOffer does not set widget cookies or run analytics. Read the [MeltOffer privacy policy](https://meltoffer.com/privacy), [MeltOffer terms](https://meltoffer.com/terms), [Gold API privacy policy](https://gold-api.com/privacy), and [Gold API terms](https://gold-api.com/terms).

== Frequently Asked Questions ==

= Does the plugin store calculator inputs? =

No. Inputs and calculations remain inside the embedded page in the visitor's browser.

= Does it add a credit link? =

The plugin does not add a separate link. MeltOffer, the external widget service, displays its own small service attribution inside the iframe.

= Does it work on WordPress.com? =

Plugin installation depends on the WordPress.com plan. Sites that cannot install plugins can use MeltOffer's Custom HTML embed instructions instead.

== Changelog ==

= 1.0.0 =

* Initial release with price, calculator, and US coin widgets.
