Plugin Documentation

Integrate and configure Preciousuite WordPress & API plugins in minutes. Real-time metal calculations, professional formatting, and fully responsive layouts.

Gold Price Based on Weight

Gold Price Based on Weight is a WooCommerce plugin that helps store owners automate product pricing based on the current price per gram of Gold, Silver, or Platinum. By setting global rates for each metal and entering the product’s weight, the final price is calculated automatically.

This plugin is ideal for online stores that sell jewelry, bullion, crafts, or other precious metal products.

Requirements
Before installing, confirm your store meets these requirements.
⚠️
WooCommerce must be active first
The plugin will not work without WooCommerce. Install and activate WooCommerce before continuing with this guide.
Requirement Notes Minimum
WordPress Self-hosted (wordpress.org) only 5.8+
WooCommerce Required Must be installed and active before this plugin 6.0+
PHP Check via Tools → Site Health in WordPress 7.4+
Key Functionalities & Features
Main capabilities of the Gold Price Based on Weight plugin.
1
Set a Global Price per Gram
Define the current price per gram for Gold, Silver, and Platinum globally via the settings page.
2
Use Product Weight to Calculate Price
Enter the weight (in grams) for each product or variation, and the plugin will calculate the price using the selected metal rate.
3
Automatic Price Calculation
The plugin multiplies the metal rate by the product weight to calculate product pricing automatically.
4
Supports Simple & Variable Products
Works with both WooCommerce simple products and variable products.
Upgrade to Premium
The Premium version extends the plugin with additional automation and advanced pricing features for precious metal stores. For Premium inquiries: kavavimal@gmail.com
Premium Feature Description
Live Metal Price Integration Automatically fetch Gold, Silver, and Platinum rates using supported APIs.
Custom Margin Settings Add profit margins to metal pricing calculations.
Making Charges Apply fixed or percentage-based making charges.
Custom Metal Types Add additional metals or materials.
Metal Price History Tracking View and analyze historical price trends.
Priority Support Get faster support assistance for premium users.
Customization
Need additional features or custom pricing logic for your store? We offer plugin customization services based on your business requirements.
  • Making charges
  • Wastage charges
  • GST or tax calculations
  • Stone weight and price support
  • Custom pricing formulas
  • Extra product pricing fields
  • Frontend price breakdown display
Installation
How to install the Gold Price Based on Weight plugin.
A
Installation via WordPress Admin
  • Log into your WordPress admin area.
  • Go to Plugins → Add New.
  • Search for “Gold Price Based on Weight”.
  • Click Install Now.
  • Activate the plugin.
B
Installation via FTP
  • Download the gold-price-based-on-weight.zip file.
  • Extract the ZIP file.
  • Upload the extracted folder to /wp-content/plugins/.
  • Activate the plugin from the WordPress admin dashboard.
Support
For support, customization requests, or Premium version inquiries:

Preciousuite Gold Buyback Quote Calculator

Provide your customers with instant quotes for buying back gold scrap, coins, or old jewelry. It integrates live market feeds and allows store owners to set their margin percentages or flat discount rates.

Key Features

  • Instant PDF quote generation
  • Custom admin margins configuration
  • Customer email capture for leads
  • Automatic scrap valuation

Quick Start Integration

To display this buyback widget on your store or website, insert this code snippet:

HTML Widget Setup
<!-- Embed Gold Buyback Widget -->
                                                        <div class="preciousuite-buyback" 
                                                             data-apikey="YOUR_API_KEY" 
                                                             data-margin="-12" 
                                                             data-email-required="true">
                                                        </div>
                                                        <script src="https://cdn.preciousuite.com/js/widgets.js" async></script>

Widget Parameters

Attribute Type Default Value Description
data-apikey String Required Your Preciousuite API License Key.
data-margin Number -10 Percentage margin below spot price (e.g. -12 for buying back at 88% of spot).
data-email-required Boolean true Requires user email validation to generate and email quotes.

Jewelry Invoice & Certificate Generator

Automate the generation of GST/VAT tax invoices and jewelry certificates of authenticity. The plugin automatically fetches live gold, silver, and platinum rates, itemizes stones, making charges, and tax compliance details.

Your Setup Progress
1
Check Req.
2
Install Plugin
3
Settings
4
Add Fields
5
Orders
6
Download
Requirements
Before installing, confirm your store meets these requirements.
⚠️
WooCommerce must be active first
The plugin will not activate without WooCommerce. Install and activate WooCommerce before continuing with this guide.
Requirement Notes Minimum
WordPress Self-hosted (wordpress.org) only 5.8+
WooCommerce Required Must be installed and active before this plugin 6.0+
PHP Check via Tools → Site Health in WordPress 7.4+
PDF library Built into the plugin — no separate installation needed Included
1
Install the Plugin
Install directly from WordPress — no file download needed.
1
Go to Plugins → Add New Plugin
Log in to your WordPress admin and click Plugins in the left sidebar, then Add New Plugin.
2
Search and Install
In the search box type Jewelry Invoice Certificate Generator — find the plugin by Preciousuite and click Install Now.
3
Click Activate Plugin
Activate the plugin to enable settings screens.
After activation a new Jewelry Invoice sub-menu appears under WooCommerce in your sidebar. This is where all plugin settings live.
2
Configure the Plugin
Set your store details, tax type, and certificate settings. This is a one-time setup — documents will use these details on every order from now on.
1
Open Jewelry Invoice settings
Access settings via the WooCommerce navigation path.
WordPress Admin WooCommerce Jewelry Invoice
2
Fill in Store & Certificate Settings
This is exactly what the settings page looks like — fill in all fields for your store.
🔔 0 Howdy, admin
Jewelry Invoice & Certificate Settings
Store Details
Store / Jeweler Name*Appears on invoice header and certificate
This name will appear on all generated documents
Store AddressPrinted on invoice footer
Store LogoDisplayed top-left on all documents
🏅
PNG or JPG, max 2MB
Tax & Compliance Settings
Tax Type*Select your country's tax system
GSTIN*Your GST Identification Number
Printed on every invoice. Required for GST-compliant documents.
HSN CodeHarmonised System of Nomenclature code for jewelry
Standard HSN for articles of jewelry: 7113. For gold coins: 7118.
Certificate Settings
Certificate TitleHeading on purchase certificate
Certificate SubtitleSub-heading below title
Auto-generate on orderWhen to create documents
WooCommerce → Jewelry Invoice settings page — fill in your store details, tax type, and certificate heading
Field Description Example
Store / Jeweler Name* Printed on invoice header and certificate top Raj Jewellers
Store Address Appears on invoice footer 123 Gold Market, Surat, Gujarat
Store Logo Upload PNG or JPG — appears top-left on all documents Your logo file
Tax Type* GST (India) / VAT (EU/UK) / UAE VAT / No Tax GST (India)
GSTIN* Your GST registration number — required for India 24AABCR1234A1Z5
HSN Code Product classification code for jewelry 7113 (jewelry) / 7118 (coins)
Certificate Title Heading shown on the purchase certificate document Jewelry Purchase Certificate
Auto-generate on order When "Completed" — documents generate the moment you mark an order complete When order = Completed
3
Click Save Settings
Your store details are now saved. Every document generated from this point will use these settings.
3
Add Jewelry Fields to Your Products
Each product needs jewelry-specific data so the certificate includes the correct hallmark, purity, weight, and stone details. Add these on each WooCommerce product page.
1
Open a product in WooCommerce
Find the product you want to edit.
WordPress Admin Products All Products Edit [product name]
2
Find the Jewelry Certificate Details panel
Scroll down on the product edit page — below the standard WooCommerce product data tabs you will find a new panel added by the plugin.
+ New Howdy, admin
Edit Product — 22K Gold Bridal Necklace
↑ Standard WooCommerce product fields (price, stock, images) above this...
📄 Jewelry Certificate Details These fields appear on the purchase certificate and invoice
Metal Details
Gemstone Details (optional)
Products → Edit Product — the Jewelry Certificate Details panel appears below standard product fields
Field Description Example
Metal Details
Metal Type Gold / Silver / Platinum Gold
Purity / Karat Karat of the metal 22K
Gross Weight (grams) Total weight including stones and setting 19.80
Net Metal Weight (grams) Weight of metal only after subtracting stones 18.50
Hallmark / BIS HUID BIS hallmark number (India) or assay mark (UK/EU) BIS2024KL7829
Making Charges Labour/making charge percentage or fixed amount 12%
Gemstone Details (optional — only fill if the item has stones)
Stone Type Diamond, Ruby, Emerald, Sapphire, etc. Diamond
Stone Weight (carats) Total carat weight of all stones in the piece 0.42
Colour Diamond colour grade (for diamonds) F
Clarity Diamond clarity grade VS1
Certificate No. GIA, IGI, AGS, or HRD certificate number GIA 2195447895
Cut Diamond cut grade Excellent
💡 Gemstone fields are completely optional. If your product has no stones, leave those fields blank — they simply won't appear on the certificate.
3
Click Update Product
Save the product. These jewelry details will now appear on every invoice and certificate generated for orders containing this product.
ℹ️
Do this for every jewelry product
Repeat Step 3 for each product in your store. Products without jewelry fields will still get a standard invoice — they just won't have the jewelry certificate panel with hallmark, purity and stone details.
4
How It Works When a Customer Orders
Once the plugin is configured and your products have jewelry fields, the entire process is fully automatic. Here is exactly what happens from order to document.
1
Customer places an order on your store
Customer browses, adds jewelry to cart, and checks out via WooCommerce as normal. No change to the shopping experience.
2
You mark the order as Completed
When you process and ship the order, change the order status to Completed in WooCommerce. This automatically triggers the PDF engine.
Orders
Orders
Order Date Status Total Actions
#WC-4821 13 June 2026 Completed ₹1,72,750
#WC-4820 12 June 2026 Completed ₹73,200
WooCommerce → Orders — Download Invoice and Download Certificate buttons appear on every Completed order
5
Download Documents
Documents are available in two places — your admin panel and your customer's My Account page.
A
Admin — from the Orders list or individual order
  • Go to WooCommerce → Orders
  • Find the completed order
  • Click Download Invoice to get the GST/VAT invoice PDF
  • Click Download Certificate to get the jewelry purchase certificate PDF
💡 You can also open an individual order and find the download buttons inside the order detail page — useful when you need to re-send documents to a customer.
B
Customer — from My Account → Orders
  • Customer logs in to their WooCommerce account on your store
  • Goes to My Account → Orders
  • Clicks View on the relevant order
  • Sees download buttons for Invoice and Certificate at the bottom of the order detail
Customers can download their own documents at any time — no need to email them manually. This reduces your support workload significantly.
Document Samples
These are examples of the two documents the plugin generates for every completed order.
Document 1 GST Invoice (PDF)
Raj Jewellers
123 Gold Market, Surat, Gujarat · GSTIN: 24AABCR1234A1Z5
Phone: +91 98765 43210 · raj@jewellers.com
TAX INVOICE
Invoice No: INV-2026-00847
Date: 13 June 2026
Bill To
Priya Sharma
priya.sharma@gmail.com
+91 99887 76655
Order
#WC-4821
Payment: Razorpay
✓ Paid
Item Purity Weight Making HUID Amount
22K Gold Bridal Necklace
HSN: 7113
22K 18.5g 12% BIS2024KL7829 ₹1,02,340
18K Diamond Stud Earrings
HSN: 7113 · GIA: 2195447895
18K 4.2g 15% ₹48,600
Subtotal₹1,50,940
CGST @ 1.5%₹2,264
SGST @ 1.5%₹2,264
Making Charges₹17,282
Total Amount₹1,72,750
Sample GST Invoice — auto-generated with your store details, customer details, product jewelry fields, and full tax breakdown
Document 2 Jewelry Purchase Certificate (PDF)
Raj Jewellers
Jewelry Purchase Certificate
Authenticity & Quality Assurance Document
Certificate No.
CERT-2026-00847
Date of Purchase
13 June 2026
Customer Name
Priya Sharma
Item Description
22K Gold Bridal Necklace
Metal Type & Purity
Gold · 22 Karat (91.67%)
BIS Hallmark (HUID)
BIS2024KL7829
Gross Weight
19.8 grams
Net Metal Weight
18.5 grams
💎 Gemstone Details
Stone Type
Diamond
Total Carat
0.42 ct
Certificate
GIA 2195447895
Colour
F
Clarity
VS1
Cut
Excellent
Sample Purchase Certificate — auto-generated with hallmark, metal purity, stone details, and certificate number
Quick Reference — Navigation Paths
Task Admin Dashboard Navigation Path
Plugin settings WooCommerce → Jewelry Invoice
Add jewelry fields Products → Edit Product → Jewelry Certificate Details
Download invoice (admin) WooCommerce → Orders → Download Invoice
Download certificate (admin) WooCommerce → Orders → Download Certificate
Customer downloads My Account → Orders → View Order
Change tax type WooCommerce → Jewelry Invoice → Tax Type

Preciousuite Gold Savings Scheme

Complete guide to configure, enroll, and manage customer installments and redemption for the Preciousuite Gold Savings Scheme WooCommerce plugin.

Your Setup Progress
1
Install Plugin
2
Configure Settings
3
Create Scheme
4
Enroll Customers
5
Track Payments
6
Redeem
Requirements
Before installing, make sure your server meets these requirements.
⚠️
WooCommerce is required
This plugin only works with WooCommerce installed and activated. Install WooCommerce first if you have not already.
Requirement Minimum Recommended
WordPress 5.8 6.5 or higher
WooCommerce 6.0 8.0 or higher
PHP 7.4 8.1 or higher
MySQL 5.6 8.0 or higher
HTTPS Required Required (for payments)
Razorpay account Optional (Free) Required for online payments (Pro)
1
Install the Plugin
There are two ways to install. Method A is the easiest for most users.
A
Install from WordPress Dashboard (Recommended)
Search and install directly from your WordPress admin — no file download needed.
  • Log in to your WordPress admin at yoursite.com/wp-admin
  • In the left sidebar go to Plugins → Add New Plugin
  • In the search box type Preciousuite Gold Saving Scheme
  • Find the plugin by Preciousuite and click Install Now
  • After installation click Activate Plugin
After activation you will see Gold Scheme appear in your WordPress sidebar menu.
B
Install via ZIP Upload (Manual)
Use this method if you downloaded the plugin ZIP file from WordPress.org or received a Pro ZIP from Preciousuite.
  • Go to Plugins → Add New Plugin
  • Click Upload Plugin at the top of the page
  • Click Choose File and select your preciousuite-gold-savings-scheme.zip file
  • Click Install Now
  • Click Activate Plugin
💡 If you are upgrading from Free to Pro, upload the Pro ZIP through the same Upload Plugin screen. It will replace the free version automatically without losing any data.
2
Configure Settings
Set up your store's gold price and payment settings before creating any schemes.
1
Open the Settings Page
Navigate to the plugin settings from your WordPress admin sidebar.
WordPress Admin Gold Scheme Settings
2
Set the Manual Gold Price
This is the fallback gold price used for weight calculations when the live API is not connected.
Field Description Example
Manual Gold Price (₹ per gram)* Current 24K gold rate per gram in your currency ₹7,200
Currency Your store currency — must match WooCommerce currency INR (₹)
⚠️ Update the manual gold price regularly if you are not using the live API. An outdated rate will cause incorrect gold weight calculations for customers.
3
Enter Razorpay API Keys PRO
Required only if you want customers to pay installments online via Razorpay. Skip this step for cash-only stores.
  • Log in to your Razorpay Dashboard at dashboard.razorpay.com
  • Go to Settings → API Keys
  • Click Generate Key to create a new key pair
  • Copy the Key ID and Key Secret
  • Paste both into the Razorpay fields in Plugin Settings
Field Where to Find It
Razorpay Key ID Razorpay Dashboard → Settings → API Keys → Key ID
Razorpay Secret Key Razorpay Dashboard → Settings → API Keys → Key Secret
💡 Use Test Mode keys first (rzp_test_...) while setting up. Switch to Live keys (rzp_live_...) only when ready for real transactions.
4
Click Save Changes
Click the Save Changes button at the bottom of the settings page to apply your configuration.
3
Create Your First Scheme
A scheme defines the rules for a gold saving plan. You can create multiple schemes — for example a Bridal Set scheme and a Daily Wear scheme with different installment amounts.
1
Open Scheme Creation
Gold Scheme Schemes Add New Scheme

Or click the Create New Scheme button on the Dashboard page.

2
Fill in Scheme Basic Information
These fields define the core rules of the scheme.
Field Description Example
Scheme Title* A name your customers will see when enrolling Bridal Jewellery Set Plan
Description Short description shown to customers on the enrollment page Save ₹5,000/month for 11 months and receive a free bonus month. Redeem for any bridal jewellery of your choice.
Scheme Type* Fixed Monthly Amount — customer pays same amount every month.
Fixed Gold Weight — customer receives same grams every month, amount varies with gold price.
Fixed Monthly Amount
Duration (Months)* How many months the scheme runs before maturity 11
Gold Purity* The karat of gold used to calculate weight from installment amount 22K
Min Installment (₹)* Minimum monthly payment amount. Customers can pay more if they choose. ₹5,000
3
Configure Rules & Benefits
These settings appear on the right panel of the Create Scheme page.
Field Description Recommended
Provide 1 Month Bonus on Maturity When ticked, the system automatically adds one free bonus installment when the scheme matures. This is the standard industry practice. ✓ Enable
GST Rate (%) GST percentage applied to installment payments. In India the standard rate for jewelry is 3%. 3
KYC — Aadhaar Card Require customers to upload their Aadhaar card during enrollment ✓ Recommended for India
KYC — PAN Card Require customers to upload their PAN card. Required for purchases above ₹2 lakh. ✓ Recommended
💡 The bonus month is the biggest incentive for customers to join. Always enable it — it costs you one month's gold liability but guarantees a high-value purchase at maturity.
4
Click Save Scheme
Click Save Scheme on the right panel. The scheme is now Active and visible to customers.
Your scheme now appears in the Jewelry Saving Schemes list with Status: Active. Customers can now enroll.
4
Customer Enrollment
Customers can enroll in a scheme in two ways — online through their WooCommerce account, or manually by the store admin on their behalf.
A
Customer Self-Enrolls Online
When the customer is logged in, they visit My Account → Gold Scheme and fill in the enrollment form.
  • Customer logs in to their WooCommerce account
  • Goes to My Account → Gold Scheme
  • Clicks Enroll in a Scheme
  • Selects a scheme from the dropdown
  • Enters their installment amount (must be ≥ minimum)
  • Uploads KYC documents (Aadhaar, PAN) if required
  • Submits the enrollment form
💡 The enrollment is set to Pending KYC until you verify the uploaded documents. The customer cannot make payments until KYC is approved.
B
Admin Enrolls a Customer Manually
For in-store enrollments — when the customer walks in and wants to join a scheme at the counter.
Gold Scheme Customers Add New Customer
  • Search for the customer by email or create a new WP user
  • Select the scheme they want to join
  • Enter installment amount and start date
  • Upload scanned KYC documents on their behalf
  • Save — KYC can be auto-approved for in-store enrollments
5
Verify Customer KYC
Before a customer can start making payments, you need to verify their identity documents. This is a legal requirement in India for jewelry transactions.
1
Go to Customer KYC Management
Gold Scheme Customers

You will see a list of all enrolled customers with their KYC Status column showing Pending, Verified, or Rejected.

2
Review the Documents
Click View Document next to the customer's name to see their uploaded Aadhaar or PAN card.
3
Approve or Reject
Click Verify to approve the KYC — the customer is now Active and can pay installments. Click Reject/Unverify if documents are invalid.
Once KYC is verified, the customer receives an email confirmation and their installment schedule becomes active.
6
Record Installment Payments
Payments can be collected online via Razorpay (Pro) or recorded manually for cash/UPI in-store payments (Free and Pro).
A
Customer Pays Online PRO
The customer logs into My Account → Gold Scheme, opens their enrollment, and clicks Pay Now for their next installment. Razorpay handles the payment and the ledger updates automatically.
💡 After a successful Razorpay payment, the plugin automatically calculates the gold weight earned (based on today's live rate) and updates the customer's gold weight ledger. No admin action is required.
B
Record Manual Payment (Cash / UPI / Cheque)
When a customer pays in-store, record the payment manually from your admin dashboard.
Gold Scheme Customers View Enrollments Record Payment
Field Description
Payment Date* Date the customer paid. Defaults to today.
Amount Paid (₹)* Actual amount received. Must be ≥ scheme minimum.
Gold Rate on Payment Date Auto-filled from live API if connected, or from manual rate. You can edit this.
Payment Method* Cash / Cheque / Bank Transfer / UPI
Reference Number UPI transaction ID, cheque number, or any reference for your records.
After saving, the gold weight is calculated automatically and added to the customer's ledger. A payment receipt email is sent to the customer.
7
Customer Portal — My Account
Pro customers get a full self-service portal in WooCommerce My Account. Here is what it shows and how it works.
ℹ️
Pro feature
The customer-facing My Account portal is available in the Pro version only. Free version customers can view their scheme status from the admin dashboard.
1
How Customers Access the Portal
  • Customer logs in to their WooCommerce account
  • Clicks Gold Scheme tab in the My Account menu
  • Sees all their active and past scheme enrollments
2
What Customers Can See and Do
Feature Description
Summary cards Total gold accumulated, total amount saved, next payment due date and amount
Scheme progress bar Visual progress showing X of 11 installments paid
Gold weight balance Current gold weight in grams and live value in ₹
Payment history Table of all payments with date, amount, gold rate on that day, gold weight credited
Download receipt PDF receipt for each installment payment
Pay Now button Opens Razorpay to pay the next installment directly
Redeem button Visible only when scheme matures — starts the redemption flow
8
Scheme Maturity & Redemption
When all installments are paid, the scheme matures. Here is exactly what happens next.
1
Automatic Maturity on Final Payment
When the last installment is recorded (payment 11 of 11), the plugin automatically triggers maturity.
  • Enrollment status changes from Active to Matured
  • Bonus month is automatically credited to the gold weight ledger
  • Maturity email sent to customer with full summary (total amount, total gold grams, current value, redemption instructions)
  • Admin notification email sent
  • Dashboard Gold Liabilities updates to reflect the matured balance
2
Customer Redeems Their Balance PRO
The customer uses their accumulated gold value to purchase jewelry from your store.
  • Customer goes to My Account → Gold Scheme and clicks Redeem Now
  • Sees a redemption summary showing total gold weight and current ₹ value
  • Clicks Start Shopping — a credit equal to their accumulated value is added to their WooCommerce account
  • Customer browses your store and adds items to cart
  • At checkout the gold scheme credit is applied automatically as a discount
  • If cart total exceeds the credit, customer pays the difference by normal payment method
After the order is complete, enrollment status changes to Redeemed and a redemption confirmation email is sent to the customer.
⚠️ The default redemption window is 30 days from maturity. If the customer does not redeem within 30 days, send them the deadline warning email manually or configure automatic deadline reminders (Pro).

Gold Premium Licenser

The Gold Premium Licenser manages live API pricing for your products, enabling automatic markup and charges.

Requirements
Before installing, confirm your store meets these requirements.
⚠️
WooCommerce must be active first
The plugin will not activate without WooCommerce. Install and activate WooCommerce before continuing with this guide.
1
Installation & Activation
How to install the Gold Premium Licenser plugin.
  • Upload the gold-premium-licenser directory to your /wp-content/plugins/ directory (or install via WP Admin -> Plugins -> Add New -> Upload).
  • Navigate to 'Plugins' and activate 'Gold Premium Licenser'.
2
License Verification
  • Go to the newly created 'Gold Premium' menu in your WordPress dashboard.
  • Enter your License Key and click 'Activate License' to unlock the plugin's premium features.
  • Note: You will receive your license key via email when you purchase the plugin at https://www.preciousuite.com/. You can also retrieve it by logging into your account and checking https://www.preciousuite.com/orders.
3
Global API Settings
  • Go to 'Gold Premium' -> 'API Settings'.
  • Configure your Metal API Key (Note: You will receive this API key via email when you purchase the plugin) and select the metals to track (Gold, Silver, Platinum, Palladium).
  • Configure Base Currency and Weight Unit.
  • Set a global 'Premium Charge' (Flat or Percentage) if you want to automatically mark up fetched prices.
  • Set the Fetch Interval (Note: It is automatically set based on the metal frequency rate plan you purchased).
  • Click 'Run Test' in the 'Test API Connection' section to debug and verify your connection payload.
4
Metal Price & Charge Configurations
  • Go to 'Gold Premium' -> 'Price Settings'.
  • Metals: Review fetched rates in the metal tabs and toggle specific purities (e.g., 24K, 22K, 999 Fineness) ON/OFF.
  • Gemstone Tab: Set up default categories (e.g., Diamond VVS) or add custom categories with base prices.
  • Other Charges Tab: Add specific charges (Making Charge, Wastage, GST, Tax) and toggle them ON/OFF.
5
WooCommerce Product Setup (Simple Products)
  • Edit any Simple Product and find the 'Metal Pricing' tab in the Product Data meta box.
  • Check 'Enable Metal Pricing'.
  • Select Base Metal, Karat/Purity, and enter the Base Weight.
  • Use the "+ Add More" button to add up to 3 "Additional Metals" to a single product if it is an alloy or mix.
  • Configure Gemstone settings (Type, Rate Type, Flat Rate).
  • Configure specific Other Charges overrides (Flat or Percentage) for this specific product.
6
WooCommerce Product Setup (Variable Products)
  • Edit a Variable Product and go to the Variations tab.
  • The Metal Pricing configuration (Enable checkbox, Base Metal, Weight, Additional Metals, Gemstones, Charges) is available independently per variation.
  • You can set different weights and purities for every variation.
7
Frontend Display & Shortcodes
  • [live_spot_prices]: Displays a scrolling ticker of live metal prices on any page, complete with percentage change indicators compared to previous prices.
  • [gplbp_price_breakup]: Displays a detailed price breakdown (metal cost, gemstone cost, charges) on the product page. For variable products, this breakup automatically updates dynamically via AJAX when a user selects a different variation!
8
Logs & Troubleshooting
  • Navigate to 'Gold Premium' -> 'Metal Log'.
  • View the history of automated background API fetches. You can click any log ID to view the raw JSON responses and easily debug connectivity errors.