Settings live in four places, each where you would look for it:
- A product's own Shipping tab.
- Full edition: each variation, and each shipping class.
- WooCommerce → Per-Product Shipping — the shop-wide settings (capability
manage_woocommerce). - The shipping method inside each zone, under WooCommerce → Settings → Shipping.
Every amount is read the way people type it. When a comma and a dot are both present, the rightmost is the decimal point, so 1.250,00 is 1250 and 1,250.00 is 1250. A lone comma followed by exactly two digits is a decimal point (12,50 is 12.50); followed by three it is a thousands separator (1,250 is 1250). Negative amounts are stored as 0.
Empty is not nought. In every box below, an empty box means "nobody has said" and 0 means "this ships free". The difference decides whether a rate is offered at all.
On the product
Products → Edit → Product data → Shipping.
Shipping cost
- Meta key:
_gmps_cost· Default: empty - What it costs to send the first one. Empty means the product falls through to its shipping class (Full edition) and then to the shop-wide fallback.
- Emptying this box also clears Each additional.
Each additional
- Meta key:
_gmps_extra· Default: empty - What each unit after the first adds. Empty means the same as the first. Type
0if the rest go in the same box.
On a variation — Full edition
Open a variation in Product data → Variations. The two boxes appear below its dimensions, with the same meta keys stored on the variation.
- Shipping cost — only if this variation costs something different to send. Left empty, the variation uses the product's own cost.
- Each additional — what each one after the first adds.
The free edition never reads a variation's own cost. A variation always ships at its product's cost there.
On a shipping class — Full edition
Products → Shipping classes, when adding or editing a class.
- Shipping cost — term meta
_gmps_class_cost. What the first one in this class costs. A product's own cost always wins. - Each additional — term meta
_gmps_class_extra. Empty means the same as the first.
The settings screen
WooCommerce → Per-Product Shipping. All settings are stored in one option, gmps_settings, shared by both editions.
Products with no cost
A report, not a setting. With no fallback, it lists up to 20 published, non-virtual products that have no cost of their own and (in the full edition) none on their shipping class, each linked to its editor. Full edition: a variable product whose every shippable variation has a cost is not listed, since the cart only ever holds its variations. With a fallback set, it says every product can be quoted.
The shop-wide fallback
The first one costs
- Key:
fallback_first· Default: empty - Used for any product with no cost of its own (and, in the full edition, none on its shipping class). Empty means an unpriced product stops the quote.
0means everything else ships free.
Each one after that
- Key:
fallback_extra· Default: empty (same as the first)
Limits — Full edition
Applied to the whole package once the products are added up.
Never charge less than
- Key:
minimum· Default: empty (no floor)
Never charge more than
- Key:
maximum· Default: empty (no ceiling)
Free when the goods come to
- Key:
free_over· Default: empty (never free) - When the goods in the package come to at least this amount, the rate is
- Measured against what was bought, never the goods plus the postage.
The free edition keeps these three keys in the option when it saves, so nothing the full edition wrote is lost, but it does not read them.
License & updates — Full edition
Enter the GM-XXXXX-… key from your gatemi.com account and press Activate. If a check cannot reach gatemi.com, the licence state is left unchanged. Without a key the plugin makes no external requests.
For developers — Full edition
A table of the filters the plugin applies. See the developer reference.
In the shipping zone
Method id gmps_per_product, title Per-product shipping. Each zone instance has two settings:
| Label | Key | Default | What it does |
|---|---|---|---|
| Name | title |
Shipping | What the shopper sees at the checkout |
| Tax status | tax_status |
Taxable | Taxable or None |
Tax on the rate is worked out once for the whole package (per_order), because the cost already covers every item.
