Dependent Media Live Rates for USPS
| 开发者 | hsojhsoj |
|---|---|
| 更新时间 | 2026年5月1日 03:38 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- USPS Ground Advantage
- USPS Priority Mail
- USPS Priority Mail Express
- USPS First-Class Package International
- USPS Priority Mail International
- USPS Priority Mail Express International
- Per-product weight and dimensions, with configurable defaults for products that have none set
- Separate domestic and international service toggles — enable only what you want to offer
- Automatic routing: the plugin detects destination country and hits the right USPS endpoint
- Multi-box packing by default — each cart line item is rated as its own package and costs are summed. Heavy lines are automatically split across multiple boxes to stay within USPS weight caps. A "combined" mode is also available for stores that genuinely ship everything in one box.
- Only services that price every box are offered — partial coverage would produce a misleading total
- Optional fallback flat rate if the USPS API is unreachable
- Debug logging via WooCommerce → Status → Logs
apis.usps.com. No customer name, email, or other personally identifying information is transmitted. OAuth2 access tokens are cached locally in a WordPress transient.
Source code
Development happens on GitHub: https://github.com/Dependent-Media/dm-usps-shipping. Issues and pull requests welcome.
安装:
- Upload the plugin files to
/wp-content/plugins/dependent-media-live-rates-for-usps/, or install through the WordPress plugins screen. - Activate the plugin through the Plugins screen in WordPress.
- Register a USPS Developer Portal application at https://developers.usps.com/ and copy the Consumer Key and Consumer Secret.
- Go to WooCommerce → Settings → Shipping, open the shipping zone you want to offer USPS rates in, and add USPS Live Rates (DM) as a shipping method.
- Click into the method, paste your Consumer Key and Consumer Secret, pick which services to offer, and save.
- Test with a real cart to confirm rates are returned.
常见问题:
Does this work with the old USPS Web Tools API?
No. The USPS Web Tools API was retired in early 2026. This plugin uses the current USPS REST API (apis.usps.com) exclusively.
Is there a monthly fee?
No. The plugin is free and calls the USPS API directly with your own credentials. USPS does not charge for rate lookups on their Developer Portal at the time of writing.
What happens if the USPS API is down?
If you enable the fallback rate in settings, the plugin will show that flat rate when the API is unreachable or returns an error. If the fallback is disabled, no rate will be shown and the customer will see WooCommerce's standard "no shipping options" message.
Does this support international rates?
Yes. First-Class Package International, Priority Mail International, and Priority Mail Express International are all supported. The plugin automatically routes to the correct USPS endpoint based on the destination country.
Does this support shipping labels?
No. This plugin only calculates rates at checkout. It does not generate or purchase labels. You can continue to use whatever label service you prefer (PirateShip, Stamps.com, ShipStation, USPS Click-N-Ship, etc.).
How does multi-box packing work?
By default, each cart line item is sent to USPS as its own package and the per-service costs are summed. For example, a cart with three different products gets three separate USPS rate quotes for each enabled service, then totals them. If a single line item is heavy enough that one box would exceed USPS's weight limit, the plugin splits that line into multiple boxes automatically. You can switch to a "combined" single-box mode in settings if your store genuinely ships everything in one box.
How are flat-rate-box prices handled?
They aren't shown. The plugin only considers true dimensional rates (USPS rate indicators SP, PA, DR, DN) — these reflect the actual cost of shipping a box of the cart's dimensions. Flat-rate-box, cubic, and presort rates are excluded because they require specific packaging or mailing agreements that the plugin can't guarantee the merchant will use.
更新日志:
- Renamed the plugin to "Dependent Media Live Rates for USPS" and updated the slug/text domain accordingly, in response to WordPress.org Plugin Directory naming guidance.
- Added an "External services" section to the readme, formally documenting the USPS REST API integration (data sent, when, and links to USPS Terms of Use and Privacy Policy).
- Added the plugin owner (
hsojhsoj) to the readmeContributorsfield. - No functional code changes — the WooCommerce shipping method ID, settings keys, and OAuth token transient are unchanged, so existing installations carry their configuration forward.
- Corrected the
Plugin URIheader so the source-code link in the plugin headers resolves (the original 1.0.0 build pointed at a GitHub URL with the wrong casing). No functional changes.
- First public release on WordPress.org. Functionally equivalent to the prerelease 0.3 series. Adds the
Requires Plugins: woocommerceheader and tightens internationalization on internal error messages.
- Added multi-box packing. Each cart line item is now rated as its own package by default, and the per-service costs are summed. Heavy lines are automatically split across multiple boxes to stay within USPS weight caps.
- Cart-wide service rates are filtered to only show services that priced every box (no more partial-coverage rates).
- New "Packing strategy" setting: "One box per cart line item" (default, recommended) or "Combined into a single virtual box" (legacy v0.2 behavior).
- Multi-box rates are labeled with "(N packages)" in checkout for transparency.
- Added international shipping rates (First-Class Package International, Priority Mail International, Priority Mail Express International).
- The plugin now auto-detects destination country and routes to the appropriate USPS endpoint.
- Separate settings for which domestic vs international services to offer.
- Initial release. Domestic US rates for Priority Mail, Priority Mail Express, and Ground Advantage.