| 1 |
=== Plugin Name === |
| 2 |
Tags: woocommerce, export, postnl |
| 3 |
Requires at least: 3.5.1 & WooCommerce 2.0+ |
| 4 |
Tested up to: 4.9.4 |
| 5 |
Stable tag: 2.5.1 |
| 6 |
License: GPLv3 or later |
| 7 |
License URI: http://www.opensource.org/licenses/gpl-license.php |
| 8 |
|
| 9 |
Export your WooCommerce orders to PostNL (www.postnl.nl) and print labels directly from the WooCommerce admin |
| 10 |
|
| 11 |
== Description == |
| 12 |
|
| 13 |
This WooCommerce extension allows you to export your orders to the PostNL service (www.postnl.nl). |
| 14 |
|
| 15 |
**Online Manual (in Dutch):** https://postnl.github.io/woocommerce/ |
| 16 |
|
| 17 |
= Main features = |
| 18 |
- Delivery options integrated in your checkout |
| 19 |
- Export your WooCommerce orders to PostNL with a simple click, single orders or in batch |
| 20 |
- Print shipping labels directly (PDF) |
| 21 |
- Create multiple shipments for the same order |
| 22 |
- Choose your package type (Parcel, mailbox package or unpaid letter) |
| 23 |
- Define preset PostNL shipping options (signature required, extra insurance, etc.) |
| 24 |
- Modify the PostNL shipping options per order before exporting |
| 25 |
- Extra checkout fields to separate street name, house number and house number suffix for more precise address data |
| 26 |
- View the status of the shipment in the order details page |
| 27 |
- Add track&trace link to the order confirmation email |
| 28 |
|
| 29 |
A PostNL API account is required for this plugin! Contact your PostNL account manager for the API key. |
| 30 |
|
| 31 |
== Installation == |
| 32 |
|
| 33 |
= Automatic installation = |
| 34 |
Automatic installation is the easiest option as WordPress handles the file transfers itself and you don't even need to leave your web browser. To do an automatic install of WooCommerce PostNL, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New. |
| 35 |
|
| 36 |
In the search field type "WooCommerce PostNL" and click Search Plugins. You can install it by simply clicking Install Now. After clicking that link you will be asked if you're sure you want to install the plugin. Click yes and WordPress will automatically complete the installation. |
| 37 |
|
| 38 |
= Manual installation via the WordPress interface = |
| 39 |
1. Download the plugin zip file to your computer |
| 40 |
2. Go to the WordPress admin panel menu Plugins > Add New |
| 41 |
3. Choose upload |
| 42 |
4. Upload the plugin zip file, the plugin will now be installed |
| 43 |
5. After installation has finished, click the 'activate plugin' link |
| 44 |
|
| 45 |
= Manual installation via FTP = |
| 46 |
1. Download the plugin file to your computer and unzip it. |
| 47 |
2. Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's wp-content/plugins/ directory. |
| 48 |
3. Activate the plugin from the Plugins menu within the WordPress admin. |
| 49 |
|
| 50 |
= Setting up the plugin = |
| 51 |
1. Go to the menu `WooCommerce > PostNL`. |
| 52 |
2. Fill in your API Details. |
| 53 |
3. Under 'Default export settings' you can set options that should be set by default for the export. You can change these settings per order at the time of export. |
| 54 |
4. The plugin is ready to be used! |
| 55 |
|
| 56 |
= Testing = |
| 57 |
We advise you to test the whole checkout procedure once to see if everything works as it should. Pay special attention to the following: |
| 58 |
|
| 59 |
The PostNL plugin adds extra fields to the checkout of your webshop, to make it possible for the client to add street name, number and optional additions separately. This way you can be sure that everything is entered correctly. Because not all checkouts are configured alike, it's possible that the positioning/alignment of these extra fields have to be adjusted. |
| 60 |
|
| 61 |
Moreover, after a label is created, a track&trace code is added to the order. When the order is completed from WooCommerce, this track & trace code is added to the email (when this is enabled in the settings). Check that the code is correctly displayed in your template. You can read how to change the text in the FAQ section. |
| 62 |
|
| 63 |
== Frequently Asked Questions == |
| 64 |
|
| 65 |
**Online Manual (in Dutch):** https://postnl.github.io/woocommerce/ |
| 66 |
|
| 67 |
= How do I get an API key? = |
| 68 |
For the api key, you must be contacting PostNL. |
| 69 |
|
| 70 |
= How do I change the track&trace email text? = |
| 71 |
You can change the text (which is placed above the order details table by default) by applying the following filter: |
| 72 |
` |
| 73 |
add_filter( 'wcpostnl_email_text', 'wcpostnl_new_email_text' ); |
| 74 |
function wcpostnl_new_email_text($track_trace_tekst) { |
| 75 |
// Tutoyeren ipv vousvoyeren |
| 76 |
$nieuwe_tekst = 'Je kunt je bestelling volgen met het volgende PostNL track&trace nummer:'; |
| 77 |
return $nieuwe_tekst; |
| 78 |
} |
| 79 |
` |
| 80 |
|
| 81 |
== Screenshots == |
| 82 |
|
| 83 |
1. Export or print postnl label per order |
| 84 |
2. Bulk export or print postnl labels |
| 85 |
3. Change the shipment options for an order |
| 86 |
4. postnl actions on the order overview page |
| 87 |
5. postnl information on the order details page |
| 88 |
|
| 89 |
== Changelog == |
| 90 |
|
| 91 |
= 2.5.1 (2018-03-27) = |
| 92 |
* Improvement: WooCommerce 3.3.x compatibility |
| 93 |
* Improvement: Support Cloudflare |
| 94 |
|
| 95 |
= 2.4.5 (2018-01-10) = |
| 96 |
* Fix: Export an order with an old delivery date |
| 97 |
* Refactor: Error about rest api (https://wordpress.org/support/topic/error-in-woocommerce/) |
| 98 |
```des/class-wcmp-rest-api-integration.php): failed to open stream``` |
| 99 |
|
| 100 |
= 2.4.4 (2018-01-09) = |
| 101 |
* Fix:Error about rest api (https://wordpress.org/support/topic/error-in-woocommerce/) |
| 102 |
```des/class-wcmp-rest-api-integration.php): failed to open stream``` |
| 103 |
|
| 104 |
= 2.4.3 (2018-01-05) = |
| 105 |
* Fix: Add PostNL fields to REST api to create order request |
| 106 |
* Fix: Hide days when the pickup delivery is selected |
| 107 |
|
| 108 |
= 2.4.1 (2017-10-12) = |
| 109 |
* Fix: WooCommerce 3.2 compatibility |
| 110 |
|
| 111 |
= 2.4.0 (2017-09-25) = |
| 112 |
* Feature: Export world shipments + customs declaration form |
| 113 |
* Feature: Show delivery options on thank you page |
| 114 |
* Feature: Use WC logger when possible |
| 115 |
* Fix: Return shipment error |
| 116 |
* Fix: Order details layout for pickup location |
| 117 |
* Fix: Delete cache of admin notices |
| 118 |
* Fix: Display of negative delivery options price |
| 119 |
* Fix: Improved tax handling on delivery options fees |
| 120 |
|
| 121 |
= 2.3.3 (2017-06-27) = |
| 122 |
* Fix: Pickup locations in Safari |
| 123 |
|
| 124 |
= 2.3.2 (2017-06-26) = |
| 125 |
* Fix: Delivery options header order |
| 126 |
* Feature: Support for region (=state) in international addresses |
| 127 |
* Feature: Hide Delivery options if PostNL service is unavailable |
| 128 |
|
| 129 |
= 2.3.1 (2017-06-12) = |
| 130 |
* Fix: Table Rate Shipping + WooCommerce 2.6 (error in settings) |
| 131 |
|
| 132 |
= 2.3.0 (2017-06-12) = |
| 133 |
* Feature: WooCommerce Table Rate Shipping support (woocommerce.com & Bolder Elements 4.0) |
| 134 |
* Feature: Support for monday delivery |
| 135 |
* Feature: Start print position |
| 136 |
* Feature: Individual label printing from the order details page |
| 137 |
* Fix: Delivery options checkout in Edge browser |
| 138 |
* Fix: HTTPS issue with google fonts |
| 139 |
* Fix: Multi-colli printing |
| 140 |
* Fix: Delivery options tax in WC3.0 |
| 141 |
* Fix: Disable 'signature on delivery' & 'recipient only' when switching to pickup location in checkout |
| 142 |
* Fix: Improve order-based calculation of highest shipping class |
| 143 |
|
| 144 |
= 2.2.0 (2017-04-03) = |
| 145 |
* WooCommerce 3.0 compatible |
| 146 |
* **Requires PHP version 5.3 or higher** |
| 147 |
* Feature: Validate NL postcodes |
| 148 |
* Fix: Multistep checkout |
| 149 |
* Fix: Email text translation typo |
| 150 |
* Fix: Remove spin button (arrows) for house number checkout field |
| 151 |
* Fix: Issues creating return shipments |
| 152 |
* Fix: Clear delivery options (&costs) when no longer available or deselected |
| 153 |
* Fix: Error exporting foreign addresses & PayPal Express checkout |
| 154 |
|
| 155 |
= 2.1.3 = |
| 156 |
* Feature: Option to autoload google fonts in delivery options |
| 157 |
* Feature: [DELIVERY_DATE] placeholder on label |
| 158 |
* Various minor fixes |
| 159 |
|
| 160 |
= 2.1.2 = |
| 161 |
* Fix: Script error on the Thank You page (interfered with Facebook/Google tracking) |
| 162 |
* Fix: Don't show delivery date (backend/emails) if delivery days window is 0 (=disabled) |
| 163 |
* Tweak: Notice for BE shop owners |
| 164 |
* Tweak: Sanity check for delivery options |
| 165 |
|
| 166 |
= 2.1.1 = |
| 167 |
* Fix: Delivery options iPad/iPhone issues |
| 168 |
* Fix: Ignore badly formatted delivery options data |
| 169 |
* Fix: Don't show delivery options when cart doesn't need shipping (downloads/virtual items) |
| 170 |
* Fix: Delivery options container not found (explicitly uses window scope) |
| 171 |
* Tweak: Shipping column width/float in order backend |
| 172 |
* Tweak: Page reloading & print dialogue flow optimizations |
| 173 |
|
| 174 |
= 2.1.0 = |
| 175 |
* Feature: Select combinations of Flat Rate & Shipping Class to link parcel settings & delivery options display |
| 176 |
* Feature: Option to show delivery options for all shipping methods (except foreign addresses) |
| 177 |
* Feature: Pick colors for the delivery options |
| 178 |
* Feature: Set custom styles (CSS) for delivery options |
| 179 |
* Feature: Enter '0' for the delivery days window to hide dates in the delivery options |
| 180 |
* Fix: Don't apply 'only recipient' fee for morning & night delivery (already included) |
| 181 |
* Fix: Order search issues |
| 182 |
* Fix: 404 header on delivery options |
| 183 |
* Tweak: Several delivery options style adjustments |
| 184 |
* Tweak: Reload page after exporting |
| 185 |
|
| 186 |
= 2.0.5 = |
| 187 |
* Fix default insurance selection |
| 188 |
* Tweak: Show shipping 'method title' instead of 'title' in settings (with fallback to title) |
| 189 |
* Tweak: added `$order` object to `wcpostnl_email_text` filter |
| 190 |
|
| 191 |
= 2.0.4 = |
| 192 |
* Improved theme compatibility |
| 193 |
|
| 194 |
= 2.0.3 = |
| 195 |
* Fix: Checkout option fees tax |
| 196 |
* Fix: Settings page conditional options display |
| 197 |
* Improved settings migration from previous versions |
| 198 |
|
| 199 |
= 2.0.2 = |
| 200 |
* Fix order search |
| 201 |
* Default delivery options background to white |
| 202 |
|
| 203 |
= 2.0.1 = |
| 204 |
* Completely revamped settings & export interface |
| 205 |
* New delivery options replaces old 'Pakjegemak': |
| 206 |
* Postponed delivery (pick a delivery date) |
| 207 |
* Home address only option |
| 208 |
* Signature on delivery option |
| 209 |
* Evening or morning delivery option |
| 210 |
* PostNL Pickup & Early PostNL Pickup |
| 211 |
* Possibility to assign cost to the above delivery options |
| 212 |
* Create return labels from the WooCommerce backend |
| 213 |
* Uses new PostNL API |
| 214 |
|
| 215 |
= 1.5.6 = |
| 216 |
* Fix: Disable pakjegemak if 'ship to different address' is disabled after selecting Pakjegemak location |
| 217 |
* Fix: Use billing postcode for Pakjegemak track & trace |
| 218 |
|
| 219 |
= 1.5.5 = |
| 220 |
* Fix: Foreign postcodes validation fix. |
| 221 |
|
| 222 |
= 1.5.4 = |
| 223 |
* Fix: Various Pakjegemak related issues (now saves & sends pakjegemak address separately to PostNL) |
| 224 |
* Fix: Postcode validation issues with Portugal |
| 225 |
|
| 226 |
= 1.5.3 = |
| 227 |
* Feature: Edit postnl address fields on user profile page |
| 228 |
* Fix: Bug with automatic order completion |
| 229 |
|
| 230 |
= 1.5.2 = |
| 231 |
* Feature: Option to keep old consignments when re-exporting |
| 232 |
* Feature: Use billing name for pakjegemak (when empty) |
| 233 |
* Feature: store pakjegemak choice |
| 234 |
* Fix: prevent illegal export settings/combinations |
| 235 |
* Tweak: Better error reporting |
| 236 |
* Tweak: Small text changes (backend) |
| 237 |
|
| 238 |
= 1.5.1 = |
| 239 |
* Tweak: Added error when no consignments available when trying to print labels |
| 240 |
* Tweak: Tip for direct processing of labels (when not enabled) |
| 241 |
* Tweak: admin styles |
| 242 |
|
| 243 |
= 1.5.0 = |
| 244 |
* Feature: Shipment type setting (Pakket/Brievenbuspakje/Ongefrankeerd label) |
| 245 |
* Feature: Multi-colli support |
| 246 |
* Feature: More advanced insurance options |
| 247 |
* Feature: Allow overriding pakjegemak passdata file via child theme (place in /woocommerce/) |
| 248 |
* Fix: Backend address formatting/styles |
| 249 |
* Fix: Unexpected output at first activation |
| 250 |
* Tweak: Hide parcel settings for other shipment types |
| 251 |
* Tweak: Remove deprecated comments field |
| 252 |
* Tweak: Settings now under WooCommerce top menu |
| 253 |
* Tweak: better error logging |
| 254 |
* Dev: Code refactor |
| 255 |
|
| 256 |
= 1.4.6 = |
| 257 |
* Fix: Foreign track & trace link updated |
| 258 |
|
| 259 |
= 1.4.5 = |
| 260 |
* Tweak: Prevent label creation if direct processing is disabled. NOTE! If you had this setting disabled and were used to downloading the labels directly, you need to change this in the settings. |
| 261 |
* Tweak: Remove required tags in checkout for disabled fields. |
| 262 |
|
| 263 |
= 1.4.4 = |
| 264 |
* Fix: error for missing shipping fields |
| 265 |
|
| 266 |
= 1.4.3 = |
| 267 |
* Fix: WooCommerce 2.2+ compatibility |
| 268 |
|
| 269 |
= 1.4.2 = |
| 270 |
* Fix: weight unit is now properly taken into account |
| 271 |
* Tweak: different bulk action hook (for better compatibility) |
| 272 |
|
| 273 |
= 1.4.1 = |
| 274 |
* Fix: Broken special characters (ë, û, à etc.) |
| 275 |
* Tweak: different API communication mode for secure configuration |
| 276 |
|
| 277 |
= 1.4.0 = |
| 278 |
* Feature: Print order number on label |
| 279 |
* Feature: PakjeGemak integration |
| 280 |
* Feature: Option to autocomplete order after successful export to PostNL |
| 281 |
* Feature: Option to display track&trace link on my account page |
| 282 |
|
| 283 |
= 1.3.8 = |
| 284 |
* Fix: Big exports now run without any warnings/problems (was limited by the server) |
| 285 |
* Fix: Names, cities etc. with quotes (') |
| 286 |
* Fix: Error on combined foreign & Dutch exports |
| 287 |
* Fix: IE9 compatibility |
| 288 |
|
| 289 |
= 1.3.7 = |
| 290 |
* Fix: Checkout placeholder data was being saved in older versions of Internet Explorer |
| 291 |
|
| 292 |
= 1.3.6 = |
| 293 |
* Feature: Option to download PDF or display in browser |
| 294 |
* Fix: warnings when debug set to true & downloading labels directly after exporting |
| 295 |
* Fix: WooCommerce 2.1 bug with copying foreign address data |
| 296 |
|
| 297 |
= 1.3.5 = |
| 298 |
* Fix: Errors when trashing & restoring trashed orders |
| 299 |
|
| 300 |
= 1.3.4 = |
| 301 |
* Fix: Errors on foreign country export |
| 302 |
* Fix: legacy address data is now also displayed properly |
| 303 |
* Tweak: background scrolling locked when exporting |
| 304 |
|
| 305 |
= 1.3.3 = |
| 306 |
* Fix: Checks for required fields |
| 307 |
* Tweak: Improved address formatting |
| 308 |
* Tweak: Removed placeholders on house number & suffix for better compatibility with old browsers |
| 309 |
|
| 310 |
= 1.3.2 = |
| 311 |
* Fix: Description labels for Custom ID ('Eigen kenmerk') & Message ('Optioneel bericht') |
| 312 |
|
| 313 |
= 1.3.1 = |
| 314 |
* Fix: button image width |
| 315 |
|
| 316 |
= 1.3.0 = |
| 317 |
* New PostNL icons |
| 318 |
* Export & PDF buttons compatible with WC2.1 / MP6 styles |
| 319 |
* Button styles are now in CSS instead of inline |
| 320 |
|
| 321 |
= 1.2.0 = |
| 322 |
* Feature: The postnl checkout fields (street name / house number) can now also be modified on the my account page |
| 323 |
* Fix: WooCommerce 2.1 compatibility (checkout field localisation is now in WC core) |
| 324 |
* Updated |
| 325 |
postnl tariffs |
| 326 |
|
| 327 |
= 1.1.1 = |
| 328 |
* Fix: Labels for Custom id ('Eigen kenmerk') & Message ('Optioneel bericht') in the export window were reversed |
| 329 |
* Fix: Removed depricated functions for better WooCommerce 2.1 compatibility |
| 330 |
|
| 331 |
= 1.1.0 = |
| 332 |
* Made extra checkout fields exclusive for dutch customers. |
| 333 |
* Show process indicator during export. |
| 334 |
* Various bugfixes. |
| 335 |
|
| 336 |
= 1.0.0 = |
| 337 |
* First release. |
| 338 |
|
| 339 |
== Upgrade Notice == |
| 340 |
= 2.1 = |
| 341 |
**Important!** Version 2.0 was a big update for this plugin, we recommend testing in a test environment first, before updating on a live site! |
| 342 |
|
| 343 |
|
