Sonic Pixel Multi-Carrier Live Rates for WooCommerce
| 开发者 | maikunari |
|---|---|
| 更新时间 | 2026年10月12日 08:33 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Proper WooCommerce shipping method (extends WC_Shipping_Method), instance-based per shipping zone.
- Multi-carrier redundancy: one carrier erroring never suppresses the others.
- Mandatory fallback flat rate on API error, timeout, or zero usable rates — the fallback amount cannot be saved empty or negative.
- Two-tier rate caching (fresh + 24h stale) keyed by a package/destination hash, with a configurable TTL.
- Customs handling for US/international shipments (default HS code + per-product overrides).
- Per-service whitelist, percentage + flat markup, generic or carrier-named labels, delivery-day estimates.
- Structured logging via the WooCommerce logger (source: sonicpixel-mclr); the API key is never logged.
- API client isolated from WooCommerce (injectable transport) so it is unit-testable and reusable.
安装:
- Upload the
sonicpixel-multi-carrier-live-ratesfolder to /wp-content/plugins/ and activate it (WooCommerce must be active). - Go to WooCommerce > Settings > Shipping > Multi-Carrier Live Rates and enter your ShipStation API v2 key and ship-from origin. Save to load the carrier list.
- Add the "Multi-Carrier Live Rates" method to each shipping zone and configure the carrier/service whitelist, markup, fallback amount, cache TTL, and timeout per zone.
常见问题:
What happens if the ShipStation API is down?
The method serves stale cached rates if available; otherwise it emits the configured flat-rate fallback. Checkout never shows zero shipping options.
Does it handle US and international customs?
Yes. Cross-border requests automatically include a customs block (required by ShipStation, or cross-border returns zero rates). Defaults are set globally; products can override HS code, description, and country of origin.
The rates show, but the selected option looks unselected
That is theme CSS, not the plugin. Some themes style radio inputs with appearance: none
and draw their own indicator; when WooCommerce replaces the cart totals over AJAX, that
styling is not always re-applied, so the chosen option renders blank while still being
checked. Confirmed on Blocksy 2.1.
To check, run this in the browser console on the cart page — if a dot appears, it is
purely visual:
document.querySelectorAll('input.shipping_method').forEach(i => i.style.cssText='appearance:auto;opacity:1;width:16px;height:16px;position:static')
Easiest fix: enable Fix unselected-looking shipping options in WooCommerce > Settings > Shipping > Multi-Carrier Live Rates. Or do it in your theme's Additional CSS:
.woocommerce ul#shipping_method input.shipping_method, .woocommerce .woocommerce-shipping-methods input.shipping_method { appearance: auto; -webkit-appearance: radio; opacity: 1; width: 16px; height: 16px; position: static; margin-right: .5em; }
Why do international rates only appear once a street address is entered?
Carriers will not quote an international shipment without one. Until the customer enters a street address, the request has nothing to rate against and the fallback is shown. This is a carrier requirement, so set your fallback amount to something defensible — customers see it before they have typed an address.
Which carriers are supported?
Any carrier connected in your ShipStation account. Note that Canada Post exposes no international services through ShipStation — use UPS or DHL for international zones.
更新日志:
- The carriers / services list is now styled by an enqueued stylesheet on WooCommerce > Settings > Shipping, rather than an inline style element.
- The "WooCommerce is required" notice now appears on the Plugins screen only.
- The shipping debug mode warning now appears on WooCommerce > Settings > Shipping only.
- Renamed to Sonic Pixel Multi-Carrier Live Rates for WooCommerce. The plugin folder, main file and text domain are now
sonicpixel-multi-carrier-live-rates. - The WooCommerce log source is now
sonicpixel-mclr(wasshipstation-rates). Older log files keep their old name. - Uninstalling no longer removes settings while a copy under the old
multi-carrier-live-rates-for-woocommercefolder is still installed. - Moving from the old folder: deactivate the old plugin, remove its folder over FTP or a file manager (do not use Plugins > Delete, which runs the old copy's cleanup and erases the shared settings), then install and activate this one. Settings, zone methods and product customs fields carry over, since the stored keys are unchanged.
- Added an opt-in "Fix unselected-looking shipping options" setting. Some themes style radios with appearance:none and their indicator is not re-applied after WooCommerce replaces the totals over AJAX, so the chosen option looks unselected while being genuinely checked. Off by default — enabling it replaces your theme's radio styling on those fields, which would be a regression on themes that render correctly.
- Every filter that can drop a rate now reports itself. A quote that returns nothing always says which check consumed the rates, and the whitelist mismatch log lists what the carrier offered next to what is selected.
- Fixed international rates never being offered. ShipStation returns validation_status "has_warnings" routinely on cross-border shipments — incomplete customs, an unverified address, a guessed residential indicator — and every one of those rates was being discarded. The price is valid; the warning is advisory. Only "invalid" is now treated as unusable.
- Rates dropped on validation status are counted and logged, so this cannot fail invisibly again.
- Fixed the shipping zone method settings modal failing to open. WooCommerce's moveHTMLHelpTips reads label.attr('for') without a guard, so a label carrying a help tip but no for attribute threw a TypeError and the modal never rendered.
- Added a currency conversion rate, for stores whose currency differs from the currency their carriers quote in. Carriers rate in their account's currency and cannot be asked for another; leaving the field empty keeps the previous behaviour of ignoring mismatched rates.
- Carriers / services is now a grouped checkbox list rather than a multi-select, so it is clear more than one can be chosen and the whole list is visible.
- The per-zone method title now defaults to the plugin name instead of "Shipping", matching WooCommerce convention.
- Logging: currency-mismatch now reports the currency actually received and how to resolve it, empty-usable carries the skipped count, and conversions are logged for audit.
- Initial release: live multi-carrier rates, mandatory fallback, two-tier caching, customs handling, per-zone settings, redacted logging.