Delivery Options For PostNet

Description

Delivery Options For PostNet is a plugin that adds PostNet delivery options to your WooCommerce store. Offer customers the flexibility to choose from various PostNet shipping methods such as Free Shipping, PostNet to PostNet, Express, and Economy.

This plugin integrates with PostNet’s API to provide real-time shipping rates, generate waybills, and notify stores about new orders. By using this plugin, you agree that order data will be sent to PostNet for processing.

Third-Party Service Integration

This plugin relies on PostNet’s API as a third-party service for the following functionalities:
* Fetching real-time shipping rates
* Generating waybills for orders
* Notifying PostNet stores about new orders

For more information about PostNet’s services, please visit: https://www.postnet.co.za/

Privacy and Terms

By using this plugin, you agree to PostNet’s terms of service and privacy policy: PostNet Privacy Policy

Features

• Multiple Shipping Options: Provide different shipping methods to your customers.
• Easy Configuration: Simple setup and configuration in the WooCommerce settings.
• WooCommerce Compatibility: Compatible with the latest version of WooCommerce.
• Customizable: Modify the shipping methods according to your store’s needs.
• Multi Site Mode: Support for multiple collection addresses with delayed waybill creation until order completion.

Usage

Setup and usage instructions can be found at PostNet WooCommerce Plugin.

Multi Site Mode

The plugin now supports Multi Site Mode, which allows you to:

• Configure multiple collection addresses instead of using PostNet stores as the origin
• Delay waybill creation until orders are marked as “Completed”
• Select specific collection addresses for each order in the admin panel

To enable Multi Site Mode:

1. Go to WooCommerce > PostNet Delivery in your WordPress admin
2. Check the “Enable Multi Site Mode” option
3. Configure your collection addresses with the required fields:
   • Street Address
   • Additional Address Info (optional)
   • Country Code
   • Suburb/City
   • Postal Code
   • Company/Business Name
   • Contact Number
   • Contact Person
4. Save your settings

Validation Features

The plugin includes several validation mechanisms to ensure proper setup:

• Order Completion Blocking: Orders cannot be marked as “Completed” without selecting a collection address
• Visual Indicators: Clear visual feedback shows whether collection addresses are properly configured
• Real-time Validation: JavaScript validation prevents status changes without proper address selection
• Error Messages: Helpful error messages guide users through the required setup process

When Multi Site Mode is enabled:
* Waybills will not be created automatically when orders are placed
* You must select a collection address for each order in the admin panel
* Order completion is blocked until a collection address is selected
* Waybills will only be created when the order status is changed to “Completed”
* The selected collection address will be used as the originating address on the waybill

Contributing

1. Make sure you have the latest version of Docker Desktop installed and running. Docker Desktop
2. Clone the repository to your local workspace.
3. Open a terminal and navigate to the project folder.
4. Run the following docker compose command:
   docker compose -f docker/docker-compose.yml up –build
5. Navigate to http://postnet_plugin.lvh.me:8080/
6. Complete the WordPress setup.
7. Login.
8. Install and Activate WooCommerce.
9. Setup a basic store.

License

This plugin is licensed under the GPL v2 License. See the LICENSE file for more details.

Support

For any issues, please open a ticket on the GitHub issues page.

Credits

Developed by Freeman Tech Systems.