USPS Shipping Module [Support Thread]

[lat9]

After all these years (!), this thread will now consolidate the support-thread for the USPS shipping module, downloadable from the Zen Cart plugins: https://www.zen-cart.com/downloads.php?do=file&id=1292.

I've gathered a bunch of disparate threads previously posted, in an attempt to keep everything 'together':

• https://www.zen-cart.com/showthread....an-2019-update
• https://www.zen-cart.com/showthread....t-return-rates
• https://www.zen-cart.com/showthread....und-Displaying
• https://www.zen-cart.com/showthread....quote-suitable
• https://www.zen-cart.com/showthread....uct-dimensions
• https://www.zen-cart.com/showthread....gory-USPS-2017
• https://www.zen-cart.com/showthread....http-)-API-URL

[lat9]

Version 2020-09-24 K11 is now available for download: https://www.zen-cart.com/downloads.php?do=file&id=1292

Note that this version is not compatible with Zen Cart versions prior to 1.5.2 and is not supported for Zen Cart versions prior to 1.5.4.

The following changes were made:

- Restructuring to prevent PHP notices and warnings.
- Re-factored to use now-current code styling.
- Includes modifications to use stripos/strpos instead of preg_match for 'simple' string-in-string checks.
- Use foreach() instead of deprecated each()
- Use secure (https: //secure.shippingapis.com/ShippingAPI.dll) endpoint for API requests; unsecure endpoint being retired.
- Simplifies debug handling, 'Screen' and 'Email' no longer supported.
- Debug filename changed to enable sort-by-name to mimic sort-by-date on the files.
- Restores the USPS icon to this shipping-method's distribution zip-file.
- Correct missing constant warning (MODULE_SHIPPING_USPS_REGULATIONS)
- That 'soft' configuration setting is now available in the usps.php language file.
- Additional, previously undefined language constants added in support of the display.
- 'Return Receipt for Merchandise [107]' retired and USPS will return an error if requested.
- Country name changes:
- Country ('MK') changed from 'Macedonia, Republic of' to 'North Macedonia, Republic of'.
- Country ('SZ') changed from 'Swaziland' to 'Eswatini'.
- Country ('SS') added (South Sudan); note that the country is not currently registered in the countries table.
- Add 'soft' configuration settings, present in the module's language file (refer to that file for additional information):
- MODULE_SHIPPING_USPS_SHIPPING_CUTOFF ... the shipping cut-off time, used to determine the delivery date.
- MODULE_SHIPPING_USPS_GROUNDONLY ... identifies whether the database field 'products::products_groundonly' should be interrogated.
- MODULE_SHIPPING_USPS_FRAGILE ... identifies whether the database field 'products::products_fragile' should be interrogated.
- Remove fallback 'plugin_check_for_updates' function. It's now expected to be present as part of the base Zen Cart distribution (zc152+).
- Auto-disable on the storefront if no shipping services have been selected or if the store's country-of-origin isn't the US (country code 223).

[Webskipper]

Thanks lat9 for the refresh and xoxo to Ajeh for all her efforts (past, present, and future), too.

Where would the 'if clause' be inserted in this update to create a USPS Minimum Shipping Cost? Example $6 for 1st Class.
USPS_2020_09_24_K11>includes>modules>shipping>usps.php @line 779 ?

Was using this in previous versions. Thanks in advance.


$methods[] = array('id' => $type, 'title' => $this->types[$type], 'cost' => ($cost + MODULE_SHIPPING_USPS_HANDLING) * $shipping_num_boxes);

to now force the amount ...
Code:

if ($cost < 6.00) { $methods[] = array('id' => $type, 'title' => $this->types[$type], 'cost' => (6.00 + MODULE_SHIPPING_USPS_HANDLING) * $shipping_num_boxes);} else { $methods[] = array('id' => $type, 'title' => $this->types[$type], 'cost' => ($cost + MODULE_SHIPPING_USPS_HANDLING) * $shipping_num_boxes);

[lat9]

@webskipper, find the following code fragment, starting at line 724:

            // add handling for shipping method costs for extra services applied
            $cost_original = $cost;
            $cost = ($cost + $handling + $hiddenCost) * $shipping_num_boxes;
            // add handling fee per Box or per Order
            $cost += (MODULE_SHIPPING_USPS_HANDLING_METHOD == 'Box') ? $usps_handling_fee * $shipping_num_boxes : $usps_handling_fee;

and add the highlighted code fragments:

            // add handling for shipping method costs for extra services applied
            $cost_original = $cost;

//-bof-Force minimum cost of $6.00
            if ($cost < 6) {
                $cost = 6;
            }
//-eof-Force minimum cost

            $cost = ($cost + $handling + $hiddenCost) * $shipping_num_boxes;
            // add handling fee per Box or per Order
            $cost += (MODULE_SHIPPING_USPS_HANDLING_METHOD == 'Box') ? $usps_handling_fee * $shipping_num_boxes : $usps_handling_fee;

[Webskipper]

Worked like magic! Thanks.

Donated a Jackson.

[swguy]

I will periodically see

--> PHP Warning: count(): Parameter must be an array or an object that implements Countable in /SITE/includes/modules/shipping/usps.php on line 492. // line 487 in an unmodified file

where that line is

$PackageSize = count($uspsQuote['Package']['Service']);

This is the else branch of $this->is_us_shipment.

Is it possible this branch needs the same check as the other branch, where we check count($uspsQuote['Package']); (line 480).

[jodean]

The current USPS - United States Postal Service module for Zen Cart plugin worked when i was running 1.5.7 Now I am on 1.5.7b and USPS is never an shipping option during the checkout process. No errors are displayed and no error logs created. The only customization is SBA.

[teresa529]

Is the latest version of the USPS Shipping module compatible with Zencart V 1.5.5d? Our Priority Mail quit showing with the latest price increase from USPS.

[dbltoe]

Is the latest version of the USPS Shipping module compatible with Zencart V 1.5.5d? Our Priority Mail quit showing with the latest price increase from USPS.

It should work fine. If you have 2021-05-05 K11a, it's a simple matter of overwriting includes/modules/shipping/usps.php from the version 2022-07-12 K11c download.

[lat9]

Is the latest version of the USPS Shipping module compatible with Zencart V 1.5.5d? Our Priority Mail quit showing with the latest price increase from USPS.

It should work fine. If you have 2021-05-05 K11a, it's a simple matter of overwriting includes/modules/shipping/usps.php from the version 2022-07-12 K11c download.

What @dbltoe said.