Juniustech Gold Price Calculator

Juniustech Gold Price Calculator fetches live gold prices, converts them to CHF, and displays an interactive karat price table on any page.

Features:

• Hourly automatic price updates (WordPress cron), with a one-hour cache
• 9 gold alloys (999 to 333)
• Additional kg rows for silver-plated items and tin (CHF/kg editable in settings)
• Combined TOTAL (CHF) across grams and kilograms
• Configurable surcharge per gram (default: 0.50 CHF)
• Shortcode: [gold_price_calculator]
• Shows the last known price if the API is temporarily unavailable
• Inquiry form that emails the gram/karat and kg breakdown
• Responsive table design

External services

This plugin connects to external APIs to retrieve live gold spot prices and
currency exchange rates. This is required because the calculator shows
up-to-date values instead of static prices.

Requests run on the server with wp_remote_get. No personal data, no visitor
information and no site content is transmitted by this plugin.

1. Gold API (https://api.gold-api.com/price/XAU) — gold price in USD. Used when
   no custom JSON URL is set. Terms: https://gold-api.com/ Privacy: the request
   contains only the metal symbol path (XAU).

2. Frankfurter (https://api.frankfurter.dev/) — USD to CHF conversion. Used to
   convert the gold USD price to CHF. Terms: https://www.frankfurter.dev/
   The request contains only currency codes (USD, CHF).

3. Alpha Vantage (https://www.alphavantage.co/query) — optional fallback when
   the sources above fail, or when the site owner has entered an API key.
   The request contains lookup parameters (metal/currency codes) and the site
   owner’s own API key. Terms: https://www.alphavantage.co/terms_of_service/
   Privacy: https://www.alphavantage.co/privacy/

4. Optional custom JSON URL (settings) — if the site owner enters a URL, that
   host is requested first. Only the URL they configured is contacted.

A request is sent when cached price data expires and a page containing the
calculator is loaded, when WordPress cron runs the hourly update, and when an
administrator saves settings or clicks Refresh now.