PluginProbe
PostNL for WooCommerce / 3.1.6
PostNL for WooCommerce v3.1.6
5.9.12 5.9.11 5.9.10 5.9.9 5.9.8 5.9.7 5.9.6 trunk 2.5.0 2.5.1 2.5.2 2.5.3 2.5.4 2.5.5 3.1.4 3.1.5 3.1.6 3.1.7 4.0.0 4.0.1 4.0.2 4.3.2 4.3.3 4.4.0 4.4.1 All 72 releases
woo-postnl / readme.txt

readme.txt in PostNL for WooCommerce 3.1.6, at readme.txt

480 lines 19.0 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === Plugin Name ===
2 Tags: woocommerce, WooCommerce, export, Orders, orders, Bestellingen, bestellingen, Delivery, delivery options, bezorgopties, Packages, packages, PostNL, postnl, PostNL
3 Requires at least: 3.5.1 & WooCommerce 2.0+
4 Tested up to: 5.2.0
5 Stable tag: trunk
6 Requires PHP: 5.4
7 License: GPLv3 or later
8 License URI: http://www.opensource.org/licenses/gpl-license.php
9
10 Export your WooCommerce orders to PostNL (www.postnl.nl) and print labels directly from the WooCommerce admin
11
12 == Description ==
13
14 This WooCommerce extension allows you to export your orders to the PostNL service (www.postnl.nl).
15
16 **Online Manual (in Dutch):** https://postnl.github.io/woocommerce/
17
18 = Main features =
19 - Delivery options integrated in your checkout
20 - Export your WooCommerce orders to PostNL with a simple click, single orders or in batch
21 - Print shipping labels directly (PDF)
22 - Create multiple shipments for the same order
23 - Choose your package type (Parcel, mailbox package or unpaid letter)
24 - Define preset PostNL shipping options (signature required, extra insurance, etc.)
25 - Modify the PostNL shipping options per order before exporting
26 - Extra checkout fields to separate street name, house number and house number suffix for more precise address data
27 - View the status of the shipment in the order details page
28 - Add track&trace link to the order confirmation email
29
30 A PostNL API account is required for this plugin! Contact your PostNL account manager for the API key.
31
32 == Installation ==
33
34 = Automatic installation =
35 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.
36
37 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.
38
39 = Manual installation via the WordPress interface =
40 1. Download the plugin zip file to your computer
41 2. Go to the WordPress admin panel menu Plugins > Add New
42 3. Choose upload
43 4. Upload the plugin zip file, the plugin will now be installed
44 5. After installation has finished, click the 'activate plugin' link
45
46 = Manual installation via FTP =
47 1. Download the plugin file to your computer and unzip it.
48 2. Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's wp-content/plugins/ directory.
49 3. Activate the plugin from the Plugins menu within the WordPress admin.
50
51 = Setting up the plugin =
52 1. Go to the menu `WooCommerce > PostNL`.
53 2. Fill in your API Details.
54 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.
55 4. The plugin is ready to be used!
56
57 = Testing =
58 We advise you to test the whole checkout procedure once to see if everything works as it should. Pay special attention to the following:
59
60 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.
61
62 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.
63
64 == Frequently Asked Questions ==
65
66 **Online Manual (in Dutch):** https://postnl.github.io/woocommerce/
67
68 = How do I get an API key? =
69 For the api key, you must be contacting PostNL.
70
71 = How do I change the track&trace email text? =
72 You can change the text (which is placed above the order details table by default) by applying the following filter:
73 `
74 add_filter( 'wcpostnl_email_text', 'wcpostnl_new_email_text' );
75 function wcpostnl_new_email_text($track_trace_tekst) {
76 // Tutoyeren ipv vousvoyeren
77 $nieuwe_tekst = 'Je kunt je bestelling volgen met het volgende PostNL track&trace nummer:';
78 return $nieuwe_tekst;
79 }
80 `
81
82 == Screenshots ==
83
84 1. Export or print postnl label per order
85 2. Bulk export or print postnl labels
86 3. Change the shipment options for an order
87 4. postnl actions on the order overview page
88 5. postnl information on the order details page
89
90 == Changelog ==
91
92 = 3.1.6 (2019-07-04) =
93 * Fix: Trying to get property of non-object
94 * Fix: Shipment validation error (PakjeGemak)
95 * Fix: Set default to 0 if there's no tax rate set up
96 * Fix: Issue with shipping class term id
97 * Fix: Shipping method issue with pickup
98 * Fix: Saturday cutoff time
99 * Fix: Use constants for delivery_type
100 * Improvement: Barcode in order grid
101 * Improvement: Cut the product title after 50 characters
102 * Improvement: Show deliveryday only for NL shipments
103
104 = 3.1.3 (2019-02-26) =
105 * Fix: Showing delivery date in the order when consumer using safari
106 * Fix: Scrolling of the order overview when an input is clicked.
107
108 = 3.1.2 (2019-02-19) =
109 * Improvement: 18+ check
110 * Fix: Standard delivery text
111 * Fix: showing checkout
112
113 = 3.1.1 (2019-01-30) =
114 * Fix: Remove some styling code
115 * Fix: Text changes
116 * Fix: Hide delivery options
117 * Fix: Get the total weight on a later moment
118 * Fix: Unset weight by mailbox package
119 * Fix: Since WooCommerce 3.0, logging can be grouped by context (error code 0 when exporting / printing)
120 * Fix: The checkout is still loading when change the country.
121
122 * Improvement: Add maxlength to number suffix field
123 * Improvement: Translate all text inside the checkout
124 * Improvement: The option to give a discount on the shipping method ( negative amounts)
125
126 = 3.1.0 (2018-12-12) =
127 * Hotfix: Show delivery options when checkout form already filled in.
128
129 = 3.0.10 (2018-12-05) =
130 * Hotfix: Flashing of the order summary.
131
132 = 3.0.9 (2018-12-04) =
133 * Hotfix: Get mailbox delivery option and save it into the order.
134
135 = 3.0.8 (2018-12-04) =
136 * Fix: The multiple calls that are made to retrieve the shipping data.
137 * Fix: The option for Pick up extra early
138 * Fix: Wrong house number / postcode message and the possibility to adjust the address in the postnl checkout
139 * Fix: Woocommerce tabel rates
140 * Improvement: Better support the default WooCommerce checkout address fields
141
142 = 3.0.7 (2018-11-20) =
143 * Fix: Set default values for dropoff days and delivery days window
144
145 = 3.0.6 (2018-11-16) =
146 * Fix: Remove concatenation from constant (causes an error on php version < 5.6)
147 * Fix: No more double address fields with delivery options disabled
148
149 = 3.0.5 (2018-11-15) =
150 * Fix: Error message about money_format
151 * Fix: Add the priority to the checkout field for support WooCommerce 3.5.1
152 * Fix: The PostNL logo is not visible with all browsers
153 * Improvement: Support Channel Engine
154 * Improvement: Information inside the checkout and the translations
155 * Improvement: Support WooCommerce default shipping fields (_address_1 and _address_2)
156
157 = 3.0.4 (2018-10-23) =
158 * Fix: mollie payments
159 * Improvement: Check for minimum php version (php 5.4)
160 * Improvement: Hide automatic pickup express if pickup is not enabled
161
162 = 3.0.3 (2018-10-09) =
163 * Fix: Problem with WooCommerce PDF Invoices & Packing Slips
164 * Fix: error about "Bewaar barcode in een notitie" size
165 * Fix: Turn of the option allow Pickup Express
166 * Fix: Save settings with a new update
167 * Improvement: PostNL delivery header titel
168 * Improvement: Support WooCommerce 3.5.0
169 * Improvement: add preliminary support for "digitale postzegel"
170
171 = 3.0.2 (2018-10-09) =
172 * Fix: Error a non-numeric value encountered in class-wcmp-frontend-settings.php
173 * Fix: Notice Undefined index: checkout_position
174 * Fix: Add version number after the nl-checkout.css call
175
176 = 3.0.0 (2018-10-09) =
177 * Changes: The whole checkout has a new look. A choice has been made to go back to the basic checkout. The checkout is designed so that he will take the styling of the website.
178
179 These are the biggest changes:
180 * No use of libraries (only jQuery)
181 * No iframe is used
182 * The checkout is more stable
183 * Easier to implement improvements
184
185 * Fix: Use street and house number fields for export a Belgium order
186 * Fix: The at home or at work delivery title inside the checkout
187 * Fix: The default settings
188 * Improvement: The option to change the position of the checkout (edited)
189
190 = 3.0.0-beta.2 (2018-09-08) =
191 * Fix: at home delivery title
192 * Fix: Export Belgium delivery, use the street/number input fields
193
194 = 2.4.14 (2018-07-03) =
195 * Fix: Select the correct package type inside admin when there is one shipping used.
196
197 = 2.4.13 (2018-07-26) =
198 * Fix: Tabel rate shipping witch WooCommerce Table Rate Shipping by Automattic / Bolder Elements 4.0 / Bolder Elements 4.1.3
199 * Fix: The option to show the checkout only when he is linked to package
200
201 = 2.4.12 (2018-07-09) =
202 * Fix: #102 change Iceland to world shipping
203 * Fix: #106 tabel rates shipping
204 * Improvement: #94 support legacy consignment and tracktrace data
205 * Improvement: #95 Speed up order list view
206 * Improvement: #104 Add reference identifier, that is always the order id
207 = 2.4.11 (2018-04-30) =
208 * Fix: Export shipment labels
209
210 = 2.4.10 (2018-04-26) =
211 * Improvement: Support Effect Connect, you can place the barcode inside a note of the order
212
213 = 2.4.9 (2018-04-03) =
214 * Fix: Scrolling when changing package type in orderview
215 * Fix: Select the correct delivery methode inside the checkout
216 * Improvement: Support Cloudflare
217
218 = 2.4.8 (2018-02-27) =
219 * Fix: The array error from the userAgent (https://wordpress.org/support/topic/parse-error-syntax-error-unexpected-in-wp-content-plugins-woocommerce-post/)
220 * Fix: The countries Norway, Turkey, Switzerland changed to world country
221 * Fix: Changing Type from Order List (https://wordpress.org/support/topic/changing-type-from-order-list/#post-10020043)
222
223 = 2.4.7 (2018-02-07) =
224 * Improvement: WooCommerce 3.3.1 compatibility
225
226 = 2.4.6 (2018-02-01) =
227 * Improvement: WooCommerce 3.3 compatibility
228 * Feature: The option to print the label on A4 and A6 format
229
230 = 2.4.5 (2018-01-10) =
231 * Fix: Export an order with an old delivery date
232 * Refactor: Error about rest api (https://wordpress.org/support/topic/error-in-woocommerce/)
233 ```des/class-wcmp-rest-api-integration.php): failed to open stream```
234
235 = 2.4.4 (2018-01-09) =
236 * Fix:Error about rest api (https://wordpress.org/support/topic/error-in-woocommerce/)
237 ```des/class-wcmp-rest-api-integration.php): failed to open stream```
238
239 = 2.4.3 (2018-01-05) =
240 * Fix: Add postnl fields to REST api to create order request
241 * Fix: Hide days when the pickup delivery is selected
242
243 = 2.4.2 (2017-10-29) =
244 * Fix: Price changes for 2018
245
246
247 = 2.4.1 (2017-10-12) =
248 * Fix: WooCommerce 3.2 compatibility
249
250 = 2.4.0 (2017-09-25) =
251 * Feature: Export world shipments + customs declaration form
252 * Feature: Show delivery options on thank you page
253 * Feature: Use WC logger when possible
254 * Fix: Return shipment error
255 * Fix: Order details layout for pickup location
256 * Fix: Delete cache of admin notices
257 * Fix: Display of negative delivery options price
258 * Fix: Improved tax handling on delivery options fees
259
260 = 2.3.3 (2017-06-27) =
261 * Fix: Pickup locations in Safari
262
263 = 2.3.2 (2017-06-26) =
264 * Fix: Delivery options header order
265 * Feature: Support for region (=state) in international addresses
266 * Feature: Hide Delivery options if PostNL service is unavailable
267
268 = 2.3.1 (2017-06-12) =
269 * Fix: Table Rate Shipping + WooCommerce 2.6 (error in settings)
270
271 = 2.3.0 (2017-06-12) =
272 * Feature: WooCommerce Table Rate Shipping support (woocommerce.com & Bolder Elements 4.0)
273 * Feature: Support for monday delivery
274 * Feature: Start print position
275 * Feature: Individual label printing from the order details page
276 * Fix: Delivery options checkout in Edge browser
277 * Fix: HTTPS issue with google fonts
278 * Fix: Multi-colli printing
279 * Fix: Delivery options tax in WC3.0
280 * Fix: Disable 'signature on delivery' & 'recipient only' when switching to pickup location in checkout
281 * Fix: Improve order-based calculation of highest shipping class
282
283 = 2.2.0 (2017-04-03) =
284 * WooCommerce 3.0 compatible
285 * **Requires PHP version 5.3 or higher**
286 * Feature: Validate NL postcodes
287 * Fix: Multistep checkout
288 * Fix: Email text translation typo
289 * Fix: Remove spin button (arrows) for house number checkout field
290 * Fix: Issues creating return shipments
291 * Fix: Clear delivery options (&costs) when no longer available or deselected
292 * Fix: Error exporting foreign addresses & PayPal Express checkout
293
294 = 2.1.3 =
295 * Feature: Option to autoload google fonts in delivery options
296 * Feature: [DELIVERY_DATE] placeholder on label
297 * Various minor fixes
298
299 = 2.1.2 =
300 * Fix: Script error on the Thank You page (interfered with Facebook/Google tracking)
301 * Fix: Don't show delivery date (backend/emails) if delivery days window is 0 (=disabled)
302 * Tweak: Notice for BE shop owners
303 * Tweak: Sanity check for delivery options
304
305 = 2.1.1 =
306 * Fix: Delivery options iPad/iPhone issues
307 * Fix: Ignore badly formatted delivery options data
308 * Fix: Don't show delivery options when cart doesn't need shipping (downloads/virtual items)
309 * Fix: Delivery options container not found (explicitly uses window scope)
310 * Tweak: Shipping column width/float in order backend
311 * Tweak: Page reloading & print dialogue flow optimizations
312
313 = 2.1.0 =
314 * Feature: Select combinations of Flat Rate & Shipping Class to link parcel settings & delivery options display
315 * Feature: Option to show delivery options for all shipping methods (except foreign addresses)
316 * Feature: Pick colors for the delivery options
317 * Feature: Set custom styles (CSS) for delivery options
318 * Feature: Enter '0' for the delivery days window to hide dates in the delivery options
319 * Fix: Don't apply 'only recipient' fee for morning & night delivery (already included)
320 * Fix: Order search issues
321 * Fix: 404 header on delivery options
322 * Tweak: Several delivery options style adjustments
323 * Tweak: Reload page after exporting
324
325 = 2.0.5 =
326 * Fix default insurance selection
327 * Tweak: Show shipping 'method title' instead of 'title' in settings (with fallback to title)
328 * Tweak: added `$order` object to `wcpostnl_email_text` filter
329
330 = 2.0.4 =
331 * Improved theme compatibility
332
333 = 2.0.3 =
334 * Fix: Checkout option fees tax
335 * Fix: Settings page conditional options display
336 * Improved settings migration from previous versions
337
338 = 2.0.2 =
339 * Fix order search
340 * Default delivery options background to white
341
342 = 2.0.1 =
343 * Completely revamped settings & export interface
344 * New delivery options replaces old 'Pakjegemak':
345 * Postponed delivery (pick a delivery date)
346 * Home address only option
347 * Signature on delivery option
348 * Evening or morning delivery option
349 * PostNL Pickup & Early PostNL Pickup
350 * Possibility to assign cost to the above delivery options
351 * Create return labels from the WooCommerce backend
352 * Uses new PostNL API
353
354 = 1.5.6 =
355 * Fix: Disable pakjegemak if 'ship to different address' is disabled after selecting Pakjegemak location
356 * Fix: Use billing postcode for Pakjegemak Track & Trace
357
358 = 1.5.5 =
359 * Fix: Foreign postcodes validation fix.
360
361 = 1.5.4 =
362 * Fix: Various Pakjegemak related issues (now saves & sends pakjegemak address separately to PostNL)
363 * Fix: Postcode validation issues with Portugal
364
365 = 1.5.3 =
366 * Feature: Edit postnl address fields on user profile page
367 * Fix: Bug with automatic order completion
368
369 = 1.5.2 =
370 * Feature: Option to keep old consignments when re-exporting
371 * Feature: Use billing name for pakjegemak (when empty)
372 * Feature: store pakjegemak choice
373 * Fix: prevent illegal export settings/combinations
374 * Tweak: Better error reporting
375 * Tweak: Small text changes (backend)
376
377 = 1.5.1 =
378 * Tweak: Added error when no consignments available when trying to print labels
379 * Tweak: Tip for direct processing of labels (when not enabled)
380 * Tweak: admin styles
381
382 = 1.5.0 =
383 * Feature: Shipment type setting (Pakket/Brievenbuspakje/Ongefrankeerd label)
384 * Feature: Multi-colli support
385 * Feature: More advanced insurance options
386 * Feature: Allow overriding pakjegemak passdata file via child theme (place in /woocommerce/)
387 * Fix: Backend address formatting/styles
388 * Fix: Unexpected output at first activation
389 * Tweak: Hide parcel settings for other shipment types
390 * Tweak: Remove deprecated comments field
391 * Tweak: Settings now under WooCommerce top menu
392 * Tweak: better error logging
393 * Dev: Code refactor
394
395 = 1.4.6 =
396 * Fix: Foreign Track & Trace link updated
397
398 = 1.4.5 =
399 * 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.
400 * Tweak: Remove required tags in checkout for disabled fields.
401
402 = 1.4.4 =
403 * Fix: error for missing shipping fields
404
405 = 1.4.3 =
406 * Fix: WooCommerce 2.2+ compatibility
407
408 = 1.4.2 =
409 * Fix: weight unit is now properly taken into account
410 * Tweak: different bulk action hook (for better compatibility)
411
412 = 1.4.1 =
413 * Fix: Broken special characters (ë, û, à etc.)
414 * Tweak: different API communication mode for secure configuration
415
416 = 1.4.0 =
417 * Feature: Print order number on label
418 * Feature: PakjeGemak integration
419 * Feature: Option to autocomplete order after successful export to PostNL
420 * Feature: Option to display Track & Trace link on my account page
421
422 = 1.3.8 =
423 * Fix: Big exports now run without any warnings/problems (was limited by the server)
424 * Fix: Names, cities etc. with quotes (')
425 * Fix: Error on combined foreign & Dutch exports
426 * Fix: IE9 compatibility
427
428 = 1.3.7 =
429 * Fix: Checkout placeholder data was being saved in older versions of Internet Explorer
430
431 = 1.3.6 =
432 * Feature: Option to download PDF or display in browser
433 * Fix: warnings when debug set to true & downloading labels directly after exporting
434 * Fix: WooCommerce 2.1 bug with copying foreign address data
435
436 = 1.3.5 =
437 * Fix: Errors when trashing & restoring trashed orders
438
439 = 1.3.4 =
440 * Fix: Errors on foreign country export
441 * Fix: legacy address data is now also displayed properly
442 * Tweak: background scrolling locked when exporting
443
444 = 1.3.3 =
445 * Fix: Checks for required fields
446 * Tweak: Improved address formatting
447 * Tweak: Removed placeholders on house number & suffix for better compatibility with old browsers
448
449 = 1.3.2 =
450 * Fix: Description labels for Custom ID ('Eigen kenmerk') & Message ('Optioneel bericht')
451
452 = 1.3.1 =
453 * Fix: button image width
454
455 = 1.3.0 =
456 * New PostNL icons
457 * Prepare & PDF buttons compatible with WC2.1 / MP6 styles
458 * Button styles are now in CSS instead of inline
459
460 = 1.2.0 =
461 * Feature: The postnl checkout fields (street name / house number) can now also be modified on the my account page
462 * Fix: WooCommerce 2.1 compatibility (checkout field localisation is now in WC core)
463 * Updated PostNL tariffs
464
465 = 1.1.1 =
466 * Fix: Labels for Custom id ('Eigen kenmerk') & Message ('Optioneel bericht') in the export window were reversed
467 * Fix: Removed depricated functions for better WooCommerce 2.1 compatibility
468
469 = 1.1.0 =
470 * Made extra checkout fields exclusive for dutch customers.
471 * Show process indicator during export.
472 * Various bugfixes.
473
474 = 1.0.0 =
475 * First release.
476
477 == Upgrade Notice ==
478 = 2.1 =
479 **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!
480