Errors and Solutions

This guide contains the most common issues when using the WPify Woo PPL plugin and steps to resolve them.

Parcel Shop Picker Issues

Parcel shop picker does not appear in checkout

Cause: The PPL ParcelShop shipping method is not configured in the shipping zone, or JavaScript errors prevent the widget from loading.

Solution:

1. Go to WooCommerce → Settings → Shipping and verify that PPL ParcelShop is added to the relevant shipping zone
2. Make sure the shipping zone matches the customer’s address (country, region, postal code)
3. Check for JavaScript errors in the browser console (F12 → Console) that may prevent the widget from loading
4. Clear any caching plugins or CDN cache and try again
5. Test with a default theme (e.g. Storefront) to rule out theme conflicts

Checkout validation error — pickup point not selected

Cause: The customer tried to place an order with PPL ParcelShop shipping without selecting a pickup point.

Solution: This is expected behavior — the plugin requires a pickup point to be selected. The customer needs to:

1. Click on the parcel shop picker widget
2. Select a pickup point from the map
3. Confirm the selection
4. Then place the order

If the picker is not visible, see the issue above.

Address Replacement Issues

Shipping address is not replaced with parcel shop address

Cause: The Replace shipping address option is not enabled in the plugin settings.

Solution:

1. Go to WooCommerce → Wpify Modules → PPL
2. Enable Replace shipping address
3. Save settings
4. New orders will have the shipping address replaced with the selected parcel shop address

Parcel shop details not showing in emails

Cause: When Replace shipping address is enabled, the parcel shop details are not displayed as a separate section because they are already part of the shipping address. When disabled, the details should appear automatically.

Solution:

1. If Replace shipping address is enabled — the parcel shop info is in the shipping address itself, this is the expected behavior
2. If Replace shipping address is disabled and details still don’t show — verify that the order actually used the PPL ParcelShop shipping method
3. Check that a pickup point was selected (check order meta for _ppl_data)

General Issues

PPL ParcelShop is not available as a shipping method

Cause: The plugin module is not activated or the shipping method was not added to the zone.

Solution:

1. Go to WooCommerce → Wpify Modules and verify that the PPL module is activated
2. Go to WooCommerce → Settings → Shipping and add the PPL ParcelShop method to the desired shipping zone
3. Make sure the plugin license is valid and activated

PPL logo does not appear in checkout

Cause: The Display logo setting is not enabled.

Solution:

1. Go to WooCommerce → Wpify Modules → PPL
2. Enable Display logo
3. Save settings

Frequently Asked Questions (FAQ)

Does the plugin support label printing or parcel tracking?

No, this plugin provides only the PPL ParcelShop pickup point selection in checkout. It does not include API integration for label printing, parcel tracking, or order submission to PPL. For label printing, use the PPL business portal or a dedicated shipping management solution.

Does the plugin work with block checkout?

Yes, the plugin fully supports the WooCommerce block-based checkout (Cart/Checkout blocks). The parcel shop picker widget works in both the classic and block checkout.

Can I use PPL ParcelShop alongside other shipping methods?

Yes, PPL ParcelShop is a standard WooCommerce shipping method. You can add it alongside flat rate, free shipping, or any other shipping methods in the same shipping zone. The customer selects the desired method during checkout.

What data is stored for the selected parcel shop?

The plugin stores the parcel shop ID, code, name, street, city, postal code, and country as order metadata. This information is displayed in the admin order detail and in customer emails.