Description
Aurumetric automatically calculates product prices for your WooCommerce jewelry store by combining live metal market rates with your product specifications.
How It Works
The pricing engine takes four inputs and produces a final, accurate price in real time:
- Live Metal Rate — Fetched from Metals-API or GoldAPI.io on a schedule you choose (hourly, twice daily, or daily), stored per gram
- Metal Purity — Supports 24K, 21K, 18K, 14K gold and sterling silver (92.5%)
- Product Weight — Set per variation in grams
- Making Charge — A flat amount added per variation (e.g., craftsmanship cost)
Optionally, a margin percentage can be applied globally or overridden per variation.
The final price is calculated as:
Metal Cost (Rate * Purity * Weight) + Making Charge = Subtotal
Subtotal * (1 + Margin%) = Final Price
How to Use
-
Create a Variable Product — Go to Products > Add New and set the product type to “Variable product”. Create an attribute for metal type (e.g., “Metal”) and add terms like “Gold 24K”, “Gold 18K”, “Silver”, etc.
-
Configure API Settings — Navigate to Aurumetric in your admin sidebar. Select your API provider (Metals-API or GoldAPI.io), enter your API key, and click Fetch Latest Rates Now. Verify that gold and silver rates appear in the debug panel.
-
Set Variation Details — Open your product for editing and expand each variation. You will see Weight and Making Charge fields:
- Weight (g) — Enter the metal weight in grams. This is required for pricing to work.
- Making Charge — Enter a flat amount (e.g., 50 for $50 craftsmanship fee). Leave blank if not applicable.
- Margin (%) — Override the global margin for this specific variation. Leave blank to use the global margin from settings.
-
Enable Pricing Breakdown — On the Aurumetric settings page, check Show Pricing Breakdown to display a detailed cost breakdown (metal cost, making charge, margin) on the frontend product page when a customer selects a variation.
-
Set a Global Margin (Optional) — On the settings page, enable Universal Margin and enter a percentage (e.g.,
10for 10%). This margin is applied to all products unless overridden per variation. -
Verify on the Frontend — Visit your product page. You should see a “Starting from” price. Select a variation to view the live price and pricing breakdown.
Features
- Live gold and silver rates via Metals-API or GoldAPI.io
- Supports gold purities: 24K, 21K, 18K, 14K
- Supports sterling silver (92.5% purity)
- Per-variation weight and making charge settings
- Global or per-variation margin percentage
- Automatic rate updates via WP-Cron (hourly, twice daily, or daily)
- Manual rate fetching from the admin panel
- Transparent pricing breakdown on the product page
- “Starting from” price display for variable products
- Manual USD exchange rate fallback for non-USD stores
- Responsive admin variation fields
- Debug panel showing stored rates, last updated time, and API errors
- HPOS (High-Performance Order Storage) compatible
- Cart price enforcement to prevent stale pricing
- Visual metal swatches (styled metallic gradient buttons with out-of-stock detection)
- Bulk admin tools (apply weight, making charge, images, or margin to variations at once, or by attribute value)
Every feature listed above is included and unlocked in this plugin. There is no paid tier that unlocks functionality inside Aurumetric.
Supported Metal Types
Metal
Purity Factor
Description
24K Gold
1.000
Pure gold
21K Gold
0.875
Common in South Asian jewelry
18K Gold
0.750
Standard European jewelry
14K Gold
0.583
Popular in North America
Sterling Silver
0.925
92.5% pure silver
Third-Party Services
This plugin integrates with the following external services to provide live metal market rates and license management:
1. Metals-API (https://metals-api.com/)
– Used for fetching live gold (XAU) and silver (XAG) market rates.
– Data is cached locally; no personal data is sent.
– Privacy Policy: https://metals-api.com/privacy
– Terms of Service: https://metals-api.com/terms
2. GoldAPI.io (https://www.goldapi.io/)
– Used for fetching live gold (XAU) and silver (XAG) market rates.
– Data is cached locally; no personal data is sent.
– Privacy Policy: https://www.goldapi.io/privacy
– Terms of Service: https://www.goldapi.io/terms
3. Freemius (https://freemius.com/)
– Used for license activation, automatic updates, feature gating, and usage tracking.
– When you activate a license, your site URL and license key are sent to Freemius.
– Privacy Policy: https://freemius.com/privacy-policy/
– Terms of Service: https://freemius.com/terms-of-service/
Installation
- Upload the
aurumetricfolder to/wp-content/plugins/, or install the plugin ZIP via Plugins > Add New > Upload Plugin. - Activate the plugin.
- Go to Aurumetric in your admin sidebar.
- Enter your API key (from Metals-API or GoldAPI.io).
- Click Fetch Latest Rates Now to verify the connection.
- Edit your variable products and set the Weight and Making Charge for each variation under the variation settings.
FAQ
Which APIs are supported?
Metals-API and GoldAPI.io. Both provide reliable live rates for gold (XAU) and silver (XAG). Choose whichever suits your account and region.
How often are rates updated?
Rates are updated on a schedule you choose — hourly, twice daily, or daily via WP-Cron. You can also click “Fetch Latest Rates Now” on the settings page for an immediate update.
Can I set a different making charge per variation?
Yes. Each variation has its own Weight and Making Charge fields. Leave the Making Charge blank to use a flat price, or set it to override any global defaults.
What if my store uses a non-USD currency?
The plugin fetches rates in your WooCommerce store currency. If the API does not support your currency directly, set a Manual USD Exchange Rate on the settings page (e.g., 120 for BDT) and the plugin will convert automatically.
Does this work with simple products?
Yes. Simple products support dynamic pricing through the “Precious Metal” fields on the General tab of the product edit screen. Variable products additionally let each variation carry its own metal type, weight, and making charge.
What if prices show as zero or “unavailable”?
- Verify your API key is correct and rates have been fetched successfully (check the debug panel on the settings page).
- Ensure each variation has a valid Weight value (greater than 0).
- Confirm the variation attributes contain recognizable metal names (e.g., “Gold 18K”, “Silver”) so the purity factor can be detected.
Changelog
2.0.1
- Release maintenance; no functional changes.
- The WordPress.org release is now built from the same Freemius artifact as the premium one.
- Corrected the Freemius premium bundle identifier.
- Uninstall cleanup now runs through Freemius’
after_uninstallhook instead ofuninstall.php(a Freemius requirement); stored settings and product data are still removed completely.
2.0.0
- Rebuilt on the
Aurumetric\PSR-4 namespace. - Removed the legacy license module and its orphaned
aurum_license_reverifycron. - Swatch labels now use canonical karat casing (
14K Gold). - Bulk image selection handles attachments without a thumbnail size.
- Price rounding is configurable (up, down, nearest, none) with a custom step.
- The breakdown shows rounding as its own row.
- Weight can be entered in grams, troy ounces or kilograms, also via the bulk tool.
- Making charge can be flat per item or per weight unit.
- Freemius integration: license activation, automatic updates, feature gating, usage tracking.
- Renamed from GoldPilot to Aurumetric; stored settings and product data are migrated automatically on update.
- Complete and unlocked: no feature in this plugin requires a license.
1.0.0
- Initial release