=== Gold Price Live – Gold & Silver Prices, Charts, Widgets, Melt Value Calculator ===
Contributors: goldfeed
Tags: gold price, silver price, precious metals, spot price, gold
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 26
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Live gold, silver, platinum & palladium prices on your site: tickers, charts, spot tables, a melt value calculator, and shortcodes for everything.

== Description ==

**Gold Price Live puts precious metals prices anywhere on your WordPress site** — as simple shortcodes, polished widgets, or Gutenberg blocks. Built for bullion dealers, coin shops, jewellers, gold buyers, pawn brokers and anyone whose visitors care what gold is worth right now.

Prices work the moment you activate the plugin — no account, no API key, no configuration. Free prices update at the daily close; connect a free [Gold Feed](https://gold-feed.com) account and upgrade any time for **real-time prices that update every 20 seconds** across your whole site, automatically.

= Nine widgets, ready to drop in =

Every widget is a Gutenberg block, a shortcode, and a saved preset — pick whichever fits your workflow:

* **Price Ticker** — a scrolling strip of live spot prices
* **Spot Price Table** — bid, ask and daily change for each metal
* **Price Chart** — interactive history with 1D to 10Y ranges and 17+ currencies
* **Price Cards** — clean per-metal tiles
* **Melt Value Calculator** — visitors price their own gold by weight and purity; the strongest engagement tool a gold buyer's site can have
* **Metal Spotlight** — one metal, hero-sized
* **Performance** — change over multiple periods
* **Gold/Silver Ratio** — the classic, live
* **Multi-Unit Prices** — troy ounce, gram, kilo and pennyweight side by side

Style them in the built-in **widget studio**: light and dark themes or full custom colours, your fonts, text scale, corner radius — with a live preview that is the real widget, exactly as visitors will see it. Save any design as a preset and reuse it everywhere with one shortcode.

= Shortcodes for every value =

Show the gold price in a sentence, a table, a sidebar — anywhere shortcodes work:

`[gold_bid]` `[gold_ask]` `[gold_high]` `[gold_low]` `[gold_dollar_change]` `[gold_percent_change]` — and the same six for silver, platinum and palladium.

Real dealer math, built in:

`[gold_bid currency="cad" unit="g" weight="10" purity="0.750" payout="0.85"]`

That is the CAD gold price per gram × 10 grams × 18k fineness × an 85% payout — the exact number you would quote across the counter, updating with the market. Parameters: `currency`, `unit` (toz/pw/g), `weight`, `purity`, `payout`, `multiplyby`, `fixedamount`, `decimals`, `exchange`, and `animation` for live colour-flash updates in the visitor's browser.

= Fast and reliable by design =

* One cached price request feeds every shortcode on the page — not a request per shortcode
* Widgets load lazily in iframes and never block your page
* If the feed is briefly unreachable, the last good prices keep rendering — never blanks, never zeros
* Per-metal decimals and round-to-nearest so displayed prices land on the steps you actually quote

= Free vs real-time =

* **Free:** every widget and every shortcode, prices at the daily close, Gold Feed attribution on widgets
* **Gold Feed plan:** prices update **every 20 seconds** on everything, attribution optional, full REST API access at gold-feed.com — and upgrading requires **zero changes to your pages**: subscribe from inside wp-admin and the whole site switches to live automatically

= Where the data comes from =

Prices are served by the [Gold Feed API](https://gold-feed.com), which has supplied precious metals data to dealers since 2010. Your server fetches once per cache window; widgets load from Gold Feed directly. See the Gold Feed [terms](https://gold-feed.com/terms) and [privacy policy](https://gold-feed.com/privacy).

== Frequently Asked Questions ==

= How do I show the live gold price on my WordPress site? =

Install the plugin and put `[gold_bid]` in any page, post or widget area. That's it — the current gold price renders immediately, free.

= Do I need an account or API key? =

No. Prices display without any signup, updating once daily. A free Gold Feed account (one click from the plugin's Settings tab) gives your site its own API key; the paid plan makes every price real-time.

= How do I add a gold price chart or calculator? =

Add the "Gold Feed Widget" block in the editor and pick Chart or Melt Value Calculator — or use `[gold_chart]` / `[gpl_calculator]` anywhere shortcodes work.

= Can visitors calculate the value of their own gold? =

Yes — the Melt Value Calculator widget lets visitors enter weight and purity and see the value instantly. You can preset your payout so it shows what you actually pay.

= Which metals and currencies are supported? =

Gold, silver, platinum and palladium, in USD, EUR, GBP, CAD, AUD, CHF, CNY, JPY and a dozen more — per troy ounce, gram or pennyweight.

= Does it slow my site down? =

No. One cached request per interval feeds every shortcode on the page, and widgets load lazily in their own frames.

= My prices stopped working on an old version of this plugin =

The old free feed host was retired. Update to version 26 — the same shortcodes work again immediately, no changes to your pages.

= How do real-time prices work? =

Subscribe from the plugin's Upgrade tab (checkout happens on the secure gateway and returns you straight to wp-admin). The moment payment completes, every shortcode and widget on your site updates every 20 seconds — nothing on your pages changes.

= What happened to [gold_chart] and [woocommerceproduct]? =

Both still work. `[gold_chart]` renders the new interactive chart. `[woocommerceproduct]` renders the product's store data when WooCommerce is active; spot-linked product repricing is part of the separate WooCommerce edition.

== Screenshots ==

1. The Welcome tab — prices working out of the box, every shortcode documented
2. The widget studio — nine widgets, custom colours, fonts and sizing with a live preview
3. Spot Price Table widget — bid, ask and daily change for each metal
4. Melt Value Calculator — visitors price their own metal by weight and purity
5. Interactive price chart with ranges and currencies
6. Price ticker and shortcodes rendering on a page
7. Settings — connect, plan status, display preferences
8. Full in-plugin documentation for every shortcode and parameter

== Changelog ==

= 26 =
* Complete rebuild on the Gold Feed platform
* Nine widgets as Gutenberg blocks and shortcodes: ticker, spot table, chart, price cards, melt-value calculator, spotlight, performance, ratio, multi-unit
* Widget studio with custom colours, fonts, sizing, live preview and reusable presets
* All legacy shortcodes restored, now with currency, unit, weight, purity, payout and more
* [gold_chart] and [silver_chart] render the new interactive chart
* One cached price fetch per page instead of a call per shortcode
* Subscribe to real-time prices from inside wp-admin
* Welcome tab, full documentation tab, feedback form, diagnostics, dashboard price glance
* Last-known prices keep rendering if the feed is briefly unreachable

== Upgrade Notice ==

= 26 =
Complete rebuild: your shortcodes work again, nine new widgets, a widget studio, and optional real-time prices. Update now.
