-
Notifications
You must be signed in to change notification settings - Fork 9
/
readme_edit_orders.html
748 lines (740 loc) · 62.7 KB
/
readme_edit_orders.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Edit Orders</title>
<link rel="icon" href="vinos_favicon.ico" type="image/x-icon">
<link href="https://fonts.googleapis.com/css?family=Roboto" rel="stylesheet">
<style>
a, a:active, a:visited { color: #006666; text-decoration: underline; }
.tab a, .tab a:active, .tab a:visited { text-decoration: none; }
a:hover { color:#00CC99; text-decoration: underline; }
body, p, h1, h2, h3, h4, h5, h6, li, td, dd, img, dt, dl, table { font-family: Roboto, verdana, avantgarde, tahoma, arial, sans-serif; font-size: 12pt; color: black; padding: 0px; margin: 10px 20px; line-height: 1.75em; }
h1, h2, h3, h4 { font-weight: bold; padding: 5px; }
h1 { font-size: 20px; text-align: center; border-bottom: 1px solid #666; }
h2 { font-size: 16px; }
h2, h3 { border: 1px solid #666; background-color: #eee; }
h1+h3 { border: none; background-color: inherit; }
h5 { border-bottom: 1px dashed #666; padding-bottom: 5px; }
ol li, ol li p { margin-left: 0; }
span.title { font-style: italic; font-weight: bold; color: #006666; }
.corefile, .red, .edit { color: red; }
.bold-red { color: red; font-weight: bold; }
.template { color: green; }
.added { color: blue; }
.removed { text-decoration: line-through; }
.forward { float: right; }
ol li, ul li { margin-top: 5px; margin-bottom: 5px; }
ul li ul { padding-left: 0; }
.clearBoth { clear: both; }
.smaller { font-size: smaller; }
.e { background-color: #eee; }
.back { float: left; }
</style>
<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.7.2/css/all.css" integrity="sha384-fnmOCqbTlWIlj8LyTjo7mOUStjsKC4pOpQbqyi7RrhN7udi9RwhKkMHpvLbHG9Sr" crossorigin="anonymous">
</head>
<body>
<h1 id="title">Edit Orders for Zen Cart®</h1>
<p>Version 5.0.0. Copyright © 2015-2024, <a href="https://vinosdefrutastropicales.com" target="_blank">Vinos de Frutas Tropicales</a>.</p>
<p>Current Support Thread on the Zen Cart forums: <a href="https://www.zen-cart.com/showthread.php?200407" target="_blank">https://www.zen-cart.com/showthread.php?200407</a></p>
<p>Released under the General Public License (see the file named <code>LICENSE</code> in the plugin's distribution for full details). This script is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</p>
<p><strong>Usage Notes:</strong></p>
<ol>
<li>A working copy of Zen Cart (v2.0.0 or later) running on a PHP version >= 8.0.2 is required by Edit Orders v5.0.0 and later.</li>
<li>Some <code>order-total</code> modules are incompatibile with <em>EO</em>, especially if they require storefront conditions to perform their processing.</li>
<li>Products added to an order via <em>EO</em> cannot include a "file-upload" option as that option-type is not currently supported.</li>
<li>If your store's shipping-tax rate is different from the products' tax-rate, the setting <b><em>My Store :: Show Split Tax Lines</em></b> must be set to <code>true</code> to enable <em>EO</em> to correctly locate the shipping-tax rate on an order's initial edit.</li>
</ol>
<h2>Overview</h2>
<p><em>Edit Orders (EO)</em> is a Zen Cart admin module that allows administrative users to edit a customer's order to:</p>
<ul>
<li>Change the customer, billing or shipping information</li>
<li>Add, delete, and edit products in an order</li>
<li>Update product quantities and pricing</li>
<li>Modify product attributes</li>
<li>Add, delete, and edit order totals</li>
</ul>
<p>See <em>Edit Order</em>'s <a href="https://github.com/lat9/edit_orders/wiki" target="_blank">Wiki</a> for additional information.</p>
<h2>Installing, Upgrading or Uninstalling</h2>
<p>This section identifies the processes you'll use to initially install <em>Edit Orders</em>, upgrade or uninstall <em>EO</em> entirely.</p>
<p><i class="fas fa-exclamation-circle fa-5x red"></i><strong class="red">Notes:</strong></p>
<ol>
<li>Before you install <em>EO</em> v5.0.0 (or later), you'll need a working copy of Zen Cart 2.0.0 or later (2.1.0 recommended), running on a PHP version >= 8.0.2.</li>
<li>Edit Orders provides an additional admin-sanitization script so that its inputs don't get over-sanitized by the zc155+ sanitizer. This, unfortunately, affects stores that have both EO installed and a cron-job set up to run the <code>/admin/currency_cron.php</code> script; see <a href="https://github.com/zencart/zencart/issues/2849" target="_blank">this</a> Zen Cart issue for details.</li>
</ol>
<h3>Initial Installation or Upgrade</h3>
<p>Unzip the plugin's package file and then:</p>
<ol type="A">
<li>Rename the YOUR_ADMIN sub-directory to match your custom admin sub-directory's name.</li>
<li>Sign into your Zen Cart's admin panel.</li>
<li>Copy the plugin's files to your store's directory structure:<ol>
<li>/includes/languages/english/modules/order_total/lang.ot_onetime_discount.php</li>
<li>/includes/languages/english/modules/order_total/lang.ot_misc_cost.php</li>
<li>/includes/modules/order_total/ot_onetime_discount.php</li>
<li>/includes/modules/order_total/ot_misc_cost.php</li>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/auto_loaders/config.eo.php</li>
<li>/YOUR_ADMIN/includes/auto_loaders/config.eo_cautions.php <span class="smaller">(Added in v4.3.5)</span></li>
<li>/YOUR_ADMIN/includes/classes/attributes.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/classes/EditOrdersOtShippingStub.php <span class="smaller">(Added in v4.5.4)</span></li>
<li>/YOUR_ADMIN/includes/classes/EditOrdersQueryCache.php</li>
<li>/YOUR_ADMIN/includes/classes/mock_cart.php</li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php <span class="smaller">(Added in v4.2.0)</span></li>
<li>/YOUR_ADMIN/includes/extra_datafiles/edit_orders_defines.php</li>
<li>/YOUR_ADMIN/includes/extra_datafiles/eo_sanitization.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/edit_orders_cautions.php <span class="smaller">(Added in v4.3.5)</span></li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/languages/english/lang.edit_orders.php</li>
<li>/YOUR_ADMIN/includes/languages/english/extra_definitions/lang.edit_orders.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_add_prdct_action_display.php <span class="smaller">(Added in v4.6.0)</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_add_prdct_action_processing.php <span class="smaller">(Added in v4.6.0)</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_common_address_format.php <span class="smaller">(Added in v4.6.0)</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_addresses_display.php <span class="smaller">(Added in v4.6.0)</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_display.php <span class="smaller">(Added in v4.6.0)</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_osh_table_display.php <span class="smaller">(Added in v4.6.0)</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_ot_table_display.php <span class="smaller">(Added in v4.6.0)</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_update_order_action_processing.php <span class="smaller">(Added in v4.6.0)</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_navigation.php <span class="smaller">(Added in v4.6.0)</span></li>
</ol></li>
<li>Click the "Admin Home" link in your Zen Cart's top admin menu. This action will cause the plugin's installation script to run.</li>
</ol>
<h4><span class="red">Optional Core-File Overwrites</span></h4>
<p>If your site uses either <em>Coupons</em> (<code>ot_coupon</code>) or <em>Customer Group Pricing</em> (<code>ot_group_pricing</code>), you have a higher probability of orders with "penny-off rounding" issues. That is, where an order's total value doesn't equal the sum of its individual order-total elements.</p>
<p>EO v4.7.0 (and later) provides <em>optional</em> updates to each of those order-total modules in an attempt to alleviate those situations. Please note:</p>
<ol>
<li>The change-basis for each module is that currently present in the <code>master</code> branch of Zen Cart's <a href="https://github.com/zencart/zencart" target="_blank">GitHub repository</a>.</li>
<li>There are no change-related comments in either of these modules.</li>
<li>I have not tested these changes on a site that "displays prices with tax".</li>
</ol>
<p>If you <em>choose</em> to install these overwrites, be sure to make a backup copy of the as-shipped Zen Cart version of each file. <b>Do not</b> simply rename a file, as that will lead to PHP errors on both your storefront and admin's <em>Modules :: Order Totals</em> tool! Choose a file extension that you'll remember, but don't use <code>.php~</code> or <code>.bak</code> as those can lead to issues with PCI compliance.</p>
<p>Once the base files have been renamed, copy the updated versions from EO's <code>/optional-core-overwrites</code> sub-directory to the like-named sub-directory of your site's file-system:</p>
<ol>
<li>/includes/languages/english/modules/order_total/lang.ot_group_pricing.php <span class="smaller">(Added in v4.7.1)</span></li>
<li>/includes/modules/order_total/ot_coupon.php</li>
<li>/includes/modules/order_total/ot_group_pricing.php</li>
</ol>
<h3>Uninstalling</h3>
<p>First, delete the files that were copied to your Zen Cart's file-system (restoring any <span class="corefile">core-file overwrites</span>), then copy the contents of the plugin's <code>/docs/edit_orders/uninstall/uninstall_eo.sql</code> to your clipboard and paste into your admin's <em>Tools->Install SQL Patches</em> to complete the uninstall process.</p>
<h2>Change History</h3>
<p>You can view the details of these changes on the plugin's <a href="https://github.com/lat9/edit_orders/issues" target="_blank">GitHub repository.</a></p>
<ul>
<li>v4.7.1, 2024-03-19 (lat9)<ul>
<li>BUGFIX: Correct "naggy" status-history messages when an address has html-special-characters.</li>
<li>BUGFIX: FA icons don't display on zc158a installation.</li>
<li>BUGFIX: Correct <em>optional</em> <code>ot_group_pricing</code> override's calculations; include updated language file.</li>
<li>INTROP: Add a notification once the 'base' <em>Group Pricing</em> deduction is calculated, giving the opportunity for override.</li>
<li>The following files were changed or <span class="added">added</span>:<ol>
<li><span class="added">/optional-core-overwrites/includes/languages/english/modules/order_total/lang.ot_group_pricing.php</span></li>
<li>/optional-core-overwrites/includes/modules/order_total/ot_group_pricing.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_common_address_format.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_addresses_display.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_update_order_action_processing.php</li>
</ol></li>
</ul></li>
<li>v4.7.0, 2024-02-28 (lat9)<ul>
<li>CHANGE: Drop support for Zen Cart versions <em>prior to</em> 1.5.8 (1.5.8<b>a</b> recommended).</li>
<li>BUGFIX: Set <code>orders_products::products_prid</code> to the product's uprid, not its products_id.</li>
<li>CHANGE: Use the zc158 search function.</li>
<li>BUGFIX: Include read-only attributes when updating, if they're enabled.</li>
<li>CHANGE: Enable a site to control position of icons/buttons on admin orders' listing.</li>
<li>CHANGE: Added notifications in support of updated/added product attributes and downloads.</li>
<li>BUGFIX: <var>ot_tax</var> order-totals' dropped when zero-value 'default' tax is present.</li>
<li>BUGFIX: Remove any order-totals that were previously recorded in the database, but are no longer present.</li>
<li>The following files were changed, <span class="added">added</span> or <span class="removed">removed</span>:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li><span class="removed">/YOUR_ADMIN/images/icon_billing.png</span></li>
<li><span class="removed">/YOUR_ADMIN/images/icon_comment_add.png</span></li>
<li><span class="removed">/YOUR_ADMIN/images/icon_customers.png</span></li>
<li><span class="removed">/YOUR_ADMIN/images/icon_details.png</span></li>
<li><span class="removed">/YOUR_ADMIN/images/icon_shipping.png</span></li>
<li><span class="removed">/YOUR_ADMIN/images/icon_track_add.png</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/edit_orders.css</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/auto_loaders/config.vinos_common_admin.php</span></li>
<li>/YOUR_ADMIN/includes/classes/EditOrdersQueryCache.php</li>
<li>/YOUR_ADMIN/includes/classes/attributes.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/classes/mock_cart.php</li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li><span class="removed">/YOUR_ADMIN/includes/extra_configures/edit_orders.php</span></li>
<li>/YOUR_ADMIN/includes/extra_datafiles/eo_sanitization.php</li>
<li><span class="removed">/YOUR_ADMIN/includes/functions/extra_functions/common_orders_functions.php</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/functions/extra_functions/zen_cfg_read_only.php</span></li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li><span class="removed">/YOUR_ADMIN/includes/languages/english/images/buttons/button_add_product.gif</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/languages/english/edit_orders.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/languages/english/lang.edit_orders.php</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/languages/english/extra_definitions/edit_orders_extra_definitions.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/languages/english/extra_definitions/lang.edit_orders_extra_definitions.php</span></li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_add_prdct_action_display.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_add_prdct_action_processing.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_common_address_formatting.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_addresses_display.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_display.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_osh_table_display.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_ot_table_display.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_update_order_action_processing.php</li>
<li><span class="removed">/includes/auto_loaders/config.vinos_common.php</span></li>
<li><span class="removed">/includes/classes/VinosAutoload.php</span></li>
<li><span class="removed">/includes/classes/vinos/common/NotifierCheck.php</span></li>
<li><span class="removed">/includes/init_includes/init_vinos_autoload.php</span></li>
<li><span class="added">/includes/languages/english/modules/order_total/lang.ot_misc_cost.php</span></li>
<li><span class="added">/includes/languages/english/modules/order_total/lang.ot_onetime_discount.php</span></li>
<li><span class="removed">/includes/languages/english/modules/order_total/ot_misc_cost.php</span></li>
<li><span class="removed">/includes/languages/english/modules/order_total/ot_onetime_discount.php</span></li>
<li>/includes/modules/order_total/ot_misc_cost.php</li>
<li>/includes/modules/order_total/ot_onetime_discount.php</li>
<li><span class="corefile added">/optional-core-overwrites/includes/modules/order_total/ot_coupon.php</span></li>
<li><span class="corefile added">/optional-core-overwrites/includes/modules/order_total/ot_group_pricing.php</span></li>
</ol></li>
</ul></li>
<li>v4.6.2, 2022-04-28 (lat9)<ul>
<li>BUGFIX: Correct <em>strict</em> MySQL Fatal error when updating using "Auto" price calculations.</li>
<li>BUGFIX: Multiple tax-groups' tax-record not added on order-update if "Show Split Tax Lines" is set to <em>false</em>.</li>
<li>BUGFIX: Use <code>zen_cfg_read_only</code> for EO's "Version" configuration setting, since it's expected to be read-only!</li>
<li>The following files were changed, <span class="added">added</span> or <span class="removed">removed</span>:<ol>
<li>/YOUR_ADMIN/includes/functions/edit_orders_functions.php</li>
<li><span class="added">/YOUR_ADMIN/includes/functions/extra_functions/zen_cfg_read_only.php</span></li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.6.1, 2022-03-05 (lat9)<ul>
<li>BUGFIX: Correctly manage $_SESSION['currency'] for orders placed in a currency other than the site's default.</li>
<li>BUGFIX: Remove "Ty Package Tracker" and other duplicates from the language file.</li>
<li>BUGFIX: Correct unwanted "Edit" button (and log) when an order-deletion is being confirmed.</li>
<li>BUGFIX: Ensure 'EO_DEBUG_ACTION_LEVEL' configuration setting is recorded; might not be for way-old versions when updating.</li>
<li>BUGFIX: On add/update, TEXT attributes' maximum-entry should be based on the option's <b>length</b>, not the <b>size</b>.</li>
<li>CHANGE: Add hidden field on order-update to include each ordered product's "products_id"</li>
<li>The following files were changed, <span class="added">added</span> or <span class="removed">removed</span>:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/languages/english/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_add_prdct_action_display.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_display.php</li>
</ol></li>
</ul></li>
<li>v4.6.0, 2021-06-16 (lat9/proseLA/jage9)<ul>
<li>CHANGE: Dropping support for Zen Cart versions prior to 1.5.6 and PHP versions < 5.6.</li>
<li>CHANGE: Remove <a href="https://www.zen-cart.com/downloads.php?do=file&id=75" target="_blank">Ty Package Tracker</a> integration; use <b>TyPT</b> v4.0.0 or later for continued tracking support.</li>
<li>CHANGE: Don't display price-input fields when pricing is auto-calculated.</li>
<li>CHANGE: Restructuring, migrating various processing sections to their own module.</li>
<li>BUGFIX: Correcting MySQL error when product tax and/or price is set to an empty string.</li>
<li>BUGFIX: Add changes to make EO more 'friendly' to screen-readers.</li>
<li>BUGFIX: Correct order-update calculations when an order-total module is taxed.</li>
<li>CHANGE: eo_get_country, return input value if already an array ... as set by a previously-run observer.</li>
<li>CHANGE: eo_get_new_product, gather and return <em>all</em> fields from the <code>products</code> and <code>products_description</code> tables.</li>
<li>BUGFIX: Correct PHP notice generated during an add-product action's processing.</li>
<li>The following files were changed, <span class="added">added</span> or <span class="removed">removed</span>:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/auto_loaders/config.eo.php</li>
<li>/YOUR_ADMIN/includes/auto_loaders/config.eo_cautions.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/classes/EditOrdersQueryCache.php</li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/languages/english/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/languages/english/extra_definitions/edit_orders.php</li>
<li><span class="removed">/YOUR_ADMIN/includes/modules/edit_orders/eo_addresses_cbs.php</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/modules/edit_orders/eo_addresses_csb.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_add_prdct_action_display.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_add_prdct_action_processing.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_common_address_format.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_addresses_display.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_display.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_osh_table_display.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_edit_action_ot_table_display.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_navigation.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_update_order_action_processing.php</span></li>
<li><span class="removed">/zc155/*.*</span></li>
</ol></li>
</ul></li>
<li>v4.5.7, 2021-03-04 (lat9/swguy)<ul>
<li>BUGFIX: Correct mySQL error when adding a product with a TEXT attribute.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.5.6, 2021-03-01 (lat9/swguy)<ul>
<li>BUGFIX: Correct "missing variable" PHP notice when updating an order to have no products.</li>
<li>BUGFIX: [zc157 Interoperability] Apply new HTML email constants to status-update emails.</li>
<li>BUGFIX: Use foreach where possible as order-totals array might not be numerically populated.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.5.5, 2020-12-04 (lat9)<ul>
<li>BUGFIX: Include zc156-added fields in <code>orders</code>, <code>orders_products</code> and <code>orders_products_downloads</code> tables.</li>
<li>CHANGE: Update the 'EDIT_ORDERS_ADD_PRODUCT' notification to include the SQL array used to create the base <code>orders_products</code> table record.</li>
<li>BUGFIX: Display <b>Total Price</b> as the price with tax when the store displays prices with tax.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/mock_cart.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
</ol></li>
</ul></li>
<li>v4.5.4, 2020-10-31 (lat9, jage9)<ul>
<li>BUGFIX: Correct PHP Notice issued during product-addition.</li>
<li>BUGFIX: Correct PHP Notices issued by the <code>ot_shipping</code> order-total.</li>
<li>CHANGE: Update quick-link button display on admin's orders' listing for Zen Cart 1.5.7 and later.</li>
<li>CHANGE: Add <code>role="table"</code> to aid screen readers' interpretation of address blocks. <span class="smaller">(Thanks, @jage9)</span></li>
<li>The following files were changed or <span class="added">added</span>:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li><span class="added">/YOUR_ADMIN/includes/classes/EditOrdersOtShippingStub.php</span></li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/languages/english/extra_definitions/edit_orders.php</li>
</ol></li>
</ul></li>
<li>v4.5.3, 2020-09-23 (lat9, proseLA)<ul>
<li>BUGFIX: Correct early-rounding issue when product's pricing has more significant digits than the currency.</li>
<li>CHANGE: Use <code>floatval</code> instead of float-cast to reduce the possibility of penny-off calculations.</li>
<li>BUGFIX: Correct PHP warning issued when shipping-cost is removed from an order. <span class="smaller">(Thanks, @proseLA)</span></li>
<li>BUGFIX: Identify (via this readme) that stores using a separate shipping tax-rate must also set <b>My Store :: Display Split Tax Lines</b> must be set to <code>true</code>.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
</ol></li>
</ul></li>
<li>v4.5.2, 2020-08-28 (lat9, mc12345678, proseLA)<ul>
<li>BUGFIX: Correct MySQL error when shipping-tax-rate is entered as a non-numeric value.</li>
<li>BUGFIX: Correct product addition for SBA-managed products. <span class="smaller">(Thanks, @mc12345678)</span></li>
<li>CHANGE: Use <code>zen_output_string_protected</code> instead of to-be-deprecated <code>zen_db_output</code>. <span class="smaller">(Thanks, @proseLA)</span></li>
<li>BUGFIX: Correct function name (was generating PHP fatal error). <span class="smaller">(Thanks, @proseLA)</span></li>
<li>CHANGE: Use CSS buttons during the Edit Orders processing for zc156 and later. <span class="smaller">(Thanks, @proseLA)</span></li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li><span class="added">/YOUR_ADMIN/includes/css/edit_orders.css</span></li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/languages/english/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_addresses_cbs.php</li>
<li>/YOUR_ADMIN/includes/modules/edit_orders/eo_addresses_csb.php</li>
</ol></li>
</ul></li>
<li>v4.5.1, 2020-03-31 (lat9)<ul>
<li>BUGFIX: Shipping taxes double-recorded for stores that display prices with tax.</li>
<li>BUGFIX: Correct javascript error when an order contains all configured order-totals.</li>
<li>BUGFIX: Correct 'ot_onetime_discount' installation check.</li>
<li>The following files were changed:<ol>
<li>/includes/modules/order_total/ot_onetime_discount.php</li>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.5.0, 2019-12-02 (lat9)<ul>
<li>BUGFIX: Correct PHP notices when an order has no 'tax_groups'.</li>
<li>BUGFIX: Selected attribute-value not displayed on order's initial display.</li>
<li>BUGFIX: Incorrect constant name used for Ty Package Tracker link.</li>
<li>BUGFIX: Correct 'Add Product' PHP notices, missing numeric fields' override variables.</li>
<li>CHANGE: Enable a store to configure the display-order for the order's addresses.</li>
<li>BUGFIX: Incorrect detection of additional order-status-history fields.</li>
<li>The following files were changed or <span class="added">added</span>:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_addresses_cbs.php</span></li>
<li><span class="added">/YOUR_ADMIN/includes/modules/edit_orders/eo_addresses_csb.php</span></li>
</ol></li>
</ul></li>
<li>v4.4.3, 2019-10-05 (lat9)<ul>
<li>BUGFIX: Correct variable-name identifying product to use for attribute-pricing.</li>
<li>BUGFIX: Correct PHP notices when updating an order's totals.</li>
<li>BUGFIX: Correct empty order rendered if observer disallows the order's update.</li>
<li>BUGFIX: Correct PHP notice, adding the 'Edit' button to the Customers::Orders display.</li>
<li>CHANGE: zc157 future-proofing; change to <code>zen_draw_input_field</code>.</li>
<li>CHANGE: zc157 future-proofing; Multi-lingual countries.</li>
<li>BUGFIX: Correct PHP notice during 'EDIT_ORDERS_DISPLAY_ONLY_TOTALS' notification processing.</li>
<li>CHANGE: zc156+, restore the order's shipping-address information when the order's shipping-method is 'storepickup'.</li>
<li>BUGFIX: Correct new order-totals can no longer be added.</li>
<li>CHANGE: Sort orders-status values by their <code>sort_order</code>, if the field exists in the database.</li>
<li>CHANGE: Additional notifications provided to enable customization.</li>
<li>CHANGE: Enable a store to override EO's use of numeric fields; see <a href="https://github.com/lat9/edit_orders/issues/136" target="_blank">this</a> GitHub issue for details.</li>
<li>BUGFIX: Provide mock-cart 'total' and 'weight' values (interoperation).</li>
<li>BUGFIX: Correct MySQL error if a store doesn't use <code>ot_shipping</code.</li>
<li>BUGFIX: Document change required if a store uses a cron-job for the currency-cron.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/classes/mock_cart.php</li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.4.2, 2019-07-27 (lat9)<ul>
<li>BUGFIX: Correctly enable non-integer tax rates for the gross/net handling for stores that display prices with tax.</li>
<li>BUGFIX: Properly center the top order-navigation links and form.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.4.1, 2019-07-09 (lat9)<ul>
<li>BUGFIX: Correctly manage products' quantities on order's updates.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.4.0, 2019-06-01 (lat9)<ul>
<li>CHANGE: Additional notifications for external tax-handlers.</li>
<li>BUGFIX: Remove doubly-defined constant.</li>
<li>BUGFIX: Correct various PHP warnings.</li>
<li>BUGFIX: Remove multiple trailing colons (':') from the shipping-method's title on an order-update.</li>
<li>BUGFIX: Correct 'ot_misc_cost' taxable issues.</li>
<li>CHANGE: Update array-formatting for eo-logs.</li>
<li>BUGFIX: Correct rounding errors.</li>
<li>CHANGE: Provide net/gross jQuery calculations for stores that display prices with tax.</li>
<li>CHANGE: Provide styled buttons/icons for Zen Cart 1.5.6 and later.</li>
<li>CHANGE: Enable integration with <a href="https://vinosdefrutastropicales.com/index.php?main_page=product_info&cPath=2_7&products_id=49" target="_blank">Attribute Image Swapper</a>.</li>
<li>CHANGE: All <em>EO</em> cart-related actions are now provided by its "mock" cart class.</li>
<li>CHANGE: Enable automatic pricing calculations, either with or without specials' pricing.</li>
<li>BUGFIX: Apply existing coupon when adding a product to the order.</li>
<li>BUGFIX: Record a coupon's "coupon_code" in the order when a coupon is added via <em>EO</em>'s processing.</li>
<li>CHANGE: Additional notification issued for customized, display-only order totals.</li>
<li>CHANGE: Add configuration settings to control the display of the status-history and comments section.</li>
<li>CHANGE: Additional notification issued to enable additional javascript to be included.</li>
<li>CHANGE: Additional notification issued to enable additional columns in an order's status-history table.</li>
<li>CHANGE: Display an <b>Updated By</b> column in the status-history table, if that field is present in the store's database.</li>
<li>BUGFIX: <code>ot_onetime_discount</code> causes PHP warning on initial display in admin's <b><i>Modules->Order Total</i></b>.</li>
<li>The following files were changed:<ol>
<li>/includes/languages/english/modules/order_total/ot_misc_cost.php</li>
<li>/includes/modules/order_total/ot_misc_cost.php</li>
<li>/includes/modules/order_total/ot_onetime_discount.php</li>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/edit_orders.css</li>
<li>/YOUR_ADMIN/includes/auto_loaders/config.eo.php</li>
<li>/YOUR_ADMIN/includes/classes/attributes.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/classes/mock_cart.php</li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/languages/english/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/languages/english/extra_definitions/edit_orders.php</li>
</ol></li>
<li>The following changes are made to the database:<ol>
<li>Adds the column <code>shipping_tax_rate</code> to the <code>orders</code> table.</li>
<li>Removes the configuration setting 'Use a mock shopping cart?'.</li>
<li>Updates the <em>Product Price Calculations</em> configuration settings, enabling an additional calculation method.</li>
<li>Adds the <em>Status-history Display Order</em> and <em>Status-update: Customer Notification Default</em> configuration settings.</li>
</ol></li>
</ul></li>
<li>v4.3.5, 2018-10-31 (lat9)<ul>
<li>BUGFIX: New configuration settings not included on initial install.</li>
<li>BUGFIX/CHANGE: Ensure that order totals' <em>sort_order</em> is a numeric value.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.3.4, 2018-04-08 (lat9)<ul>
<li>BUGFIX/CHANGE: Re-align /YOUR_ADMIN/orders.php notifiers with v1.5.6 and later.</li>
<li>BUGFIX: Change to shipping-method doesn't "stick".</li>
<li>CHANGE: Additional notifiers for stock-decrement and order-total processing.</li>
<li>BUGFIX: Correct interaction with various order-total plugins, especially with tax calculations.</li>
<li>BUGFIX: Correct PHP 7.1+ warning about "A non-numeric value".</li>
<li>CHANGE: Modify <em>ot_onetime_discount</em> to enable the entry of both additions to and deductions from an order's total. You'll need to remove and re-install the order-total module prior to use.</li>
<li>BUGFIX/CHANGE: Entered product prices no longer honored after v4.3.3 update; additional configuration settings added.</li>
<li>The following files were changed:<ol>
<li>/includes/modules/order_total/ot_onetime_discount.php</li>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li><span class="corefile">/YOUR_ADMIN/orders.php</span> <span class="smaller">Single line (#928) changed, modifying notification id from <code>NOTIFY_ADMIN_ORDERS_LISTING_ROW</code> to <code>NOTIFY_ADMIN_ORDERS_SHOW_ORDER_DIFFERENCE</code>.</span></li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/languages/english/edit_orders.php</li>
</ol></li>
</ul></li>
<li>v4.3.3, 2018-03-09 (lat9)<ul>
<li>BUGFIX: Product price not updated when attributes are changed.</li>
<li>BUGFIX: Incorporate zc156+ notification.</li>
<li>CHANGE: Display warning if <em>Configuration->Stock->Allow Checkout</em> is set to 'false' and insufficient stock is available.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/includes/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li>/YOUR_ADMIN/includes/languages/english/edit_orders.php</li>
</ol></li>
</ul></li>
<li>v4.3.2, 2018-03-07 (lat9)<ul>
<li>BUGFIX: Attributes are lost from products when an order is updated.</li>
<li>BUGFIX: Load admin extra functions only for <code>edit_orders</code> use; corrects unwanted interaction with <em>Admin New Order</em>.</li>
<li>CHANGE: Log-file formatting updates.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/includes/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.3.1, 2018-01-16 (lat9)<ul>
<li>BUGFIX: Correct shipping-tax calculations when shipping is the only taxed portion of the order.</li>
<li>BUGFIX: Correct shipping-tax calculations when a store "Displays prices with tax".</li>
<li>BUGFIX: Correct unwanted multiple messages on initial plugin installation.</li>
<li>BUGFIX: Allow "special characters" in updated address fields.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/extra_datafiles/eo_sanitization.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.3.0, 2017-10-01 (lat9)<ul>
<li>BUGFIX: Include "products_ordered" in columns retrieved from the "products" table.</li>
<li>CHANGE: Add notifiers to enable additional address fields to be inserted.</li>
<li>BUGFIX: Use "correct" variable in the mock cart's <code>get_products</code> function.</li>
<li>BUGFIX: Correct PHP "notify" logs for missing/undefined variables.</li>
<li>BUGFIX: Correct PHP "notify" logs when an order-total doesn't include a TAX_CLASS.</li>
<li>BUGFIX: Missing notifiers were not being reported.</li>
<li>BUGFIX: Order-total recalculation incorrect when some order-totals (e.g. Group Pricing) are included.</li>
<li>The following files were changed:<ol>
<li>/includes/classes/vinos/common/NotifierCheck.php</li>
<li>/YOUR_ADMIN/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/classes/editOrders.php</li>
<li>/YOUR_ADMIN/includes/classes/mock_cart.php</li>
<li>/YOUR_ADMIN/includes/functions/extra_functions/edit_orders_functions.php</li>
<li>/YOUR_ADMIN/includes/languages/english/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/languages/english/extra_definitions/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.2.3, 2017-04-23 (lat9)<ul>
<li>BUGFIX: Correct attribute-sorting issue.</li>
<li>The following files were changed:<ol>
<li>/YOUR_ADMIN/includes/classes/attributes.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.2.2, 2017-03-20 (lat9)<ul>
<li>BUGFIX: Correct PHP parse error introduced in v4.2.1.</li>
<li>The following files were changed:<ol>
<li><span class="corefile">/YOUR_ADMIN/orders.php</span></li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.2.1, 2017-03-19 (lat9)<ul>
<li>BUGFIX: Incorrect variable used in Packing Slip and Invoice links on an order's details page.</li>
<li>The following files were changed:<ol>
<li><span class="corefile">/YOUR_ADMIN/orders.php</span></li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
</ol></li>
</ul></li>
<li>v4.2.0, 2017-03-01 (lat9)<ul>
<li>CHANGE: Require Zen Cart 1.5.5a or later.</li>
<li>CHANGE: Remove integration with <em>Ty Package Tracker</em> from <code>\YOUR_ADMIN\orders.php</code>.</li>
<li>CHANGE: Restructure plugin installation.</li>
<li>The following files were changed, <span class="added">added</span> or <span class="removed">removed</span>:<ol>
<li><span class="added">/includes/auto_loaders/init_vinos_autoload.php</span></li>
<li><span class="removed">/includes/classes/order_total.php</span><sup>1</sup></li>
<li><span class="removed">/includes/classes/shipping.php</span><sup>1</sup></li>
<li><span class="added">/includes/classes/VinosAutoload.php</span></li>
<li><span class="added">/includes/classes/vinos/common/NotifierCheck.php</span></li>
<li><span class="added">/includes/init_includes/init_vinos_autoload.php</span></li>
<li>/YOUR_ADMIN/orders.php</li>
<li><span class="removed">/YOUR_ADMIN/images/icon_edit.gif</span><sup>1</sup></li>
<li>/YOUR_ADMIN/includes/auto_loaders/config.eo.php</li>
<li><span class="removed">/YOUR_ADMIN/includes/auto_loaders/config.zc154_compatibility.php</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/classes/eo_plugin.php</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/classes/plugin.php</span><sup>2</sup></li>
<li><span class="added">/YOUR_ADMIN/includes/classes/observers/EditOrdersAdminObserver.php</span></li>
<li>/YOUR_ADMIN/includes/extra_configures/edit_orders.php</li>
<li>/YOUR_ADMIN/includes/extra_datafiles/edit_orders_defines.php</li>
<li>/YOUR_ADMIN/includes/init_includes/init_eo_config.php</li>
<li><span class="added">/YOUR_ADMIN/includes/init_includes/init_vinos_common_admin.php</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/init_includes/init_zc154_compatibility.php</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/languages/english/orders.php</span><sup>1</sup></li>
<li>/YOUR_ADMIN/includes/languages/english/extra_definitions/edit_orders.php</li>
<li><span class="removed">/YOUR_ADMIN/includes/languages/english/plugins/eo.php</span></li>
<li><span class="removed">/YOUR_ADMIN/includes/languages/english/plugins/plugin.php</span><sup>2</sup></li>
</ol><sup>1</sup>Identifies that the file was removed from this plugin's distribution <strong>only</strong>; use the version associated with your Zen Cart distribution.<br /><sup>2</sup>Other plugins, notably <em>Ultimate SEO URLs</em>, that make use of a module using the same name but different contents; make sure that the module isn't required by others prior to removing.</li>
</ul></li>
<li>v4.1.7, 2016-10-24 (lat9)<ul>
<li>BUGFIX: Modify <em>order.php</em> to include the "value" for each order-total in the order.</li>
<li>BUGFIX: Correct interaction with "ot_cod_fee".</li>
<li>BUGFIX: Correctly handle taxable order-totals.</li>
<li>BUGFIX: Correct currency-related rounding issues.</li>
</ul></li>
<li>v4.1.6, 2016-08-06 (lat9)<ul>
<li>CHANGE: Convert tabs to 4 spaces in some of the files.</li>
<li>CHANGE: Re-factor debug-output; the EO debug output file is now generated on an order-by-order basis.</li>
<li>BUGFIX: Don't display the "Missing shipping information" message is the order contains only virtual products.</li>
<li>BUGFIX: Tax not added if the order didn't start with taxes and/or if a product is added to the order.</li>
<li>BUGFIX: Missing echo in admin's orders.php merge; the bottom "Edit Order" button was rendered useless.</li>
</ul></li>
<li>v4.1.5, 2016-05-19 (<a href="http://www.zen-cart.com/member.php?115838" target="_blank">A. Ballanger</a> and lat9)<ul>
<li>BUGFIX: Correct "Unknown column 'p.products_quantity' in 'field list".</li>
<li>BUGFIX: Corrections for coupons with category / product restrictions.</li>
<li>CHANGE: Account for order-total modules that have been removed.</li>
<li>CHANGE: Mimic storefront sort-order for attributes' display.</li>
<li>BUGFIX: Correct incorrect tax-calculations after editing an order.</li>
<li>BUGFIX: Correct multi-line comments display with \r\n.</li>
<li>CHANGE: Include a "Miscellaneous Cost" order-total that's <em>Edit Orders</em> specific.</li>
<li>BUGFIX: Correct interaction with stores that use the "Split Tax Lines" configuration.</li>
<li>CHANGE: Remove reliance on the built-in currency initialization scripts.</li>
<li>CHANGE: Add support for the "admin sanitization" introduced in Zen Cart 1.5.5.</li>
</ul></li>
<li>v4.1.4, 2015-01-27 (<a href="http://www.zen-cart.com/member.php?115838" target="_blank">A. Ballanger</a>)<ul>
<li>Updated the installation, upgrade, and removal process to use "Plugin Manager" 0.5rc2 core files.</li>
</ul></li>
<li>v4.1.3, 2014-01-06 (<a href="http://www.zen-cart.com/member.php?115838" target="_blank">A. Ballanger</a> and lat9)<ul>
<li>Updated the installation, upgrade, and removal process to use a newer version of "Plugin Manager" core files.</li>
<li>Cleaned up the english language files. Obsolete entries were removed and some new entries added.</li>
<li>Removed the optional language files as they no longer contain all the neccessary defined constants.</li>
<li>Added various changes to support Zen Cart 1.5.2 (including copying additional functions from the catalog side).</li>
<li>Added a mock "shopping cart" class which reads product data from the current order. This should help with Order Total modules which only look at the shopping cart ($_SESSION['cart']) and ignore the order ($order).</li>
<li>Added optional "debug" file logging. This should only be used for problem solving as it may adversely affect performance.</li>
<li>When a product is loaded from the database, additional fields are populated to match Zen Cart 1.5.2 handling.</li>
<li>Added handling for updating an order containing a deleted product. It is strongly recommended to not delete products until after all editing of orders containing the product are completed.<ul>
<li>The tax description is neccessary and will be generated using TEXT_UNKNOWN_TAX_RATE.</li>
<li>Tax class details will not be present or generated.</li>
<li>Attribute information may not fully populate or may be lost.</li>
</ul></li>
<li>One can now place the coupon code by itself in the "title" for "ot_coupon"</li>
<li>Included an optional "Onetime Discount" order total module.</li>
<li>Changes to the way order status / order history is handled:<ul>
<li>If the status is changed it will be recorded (with or without comment).</li>
<li>The comment (if any) will be added to the order history (previously only added if the status changed).</li>
<li>The tracking number(s) (if any) will be added to the order history.</li>
<li>If the option to notify the customer is selected the customer will be sent an email.</li>
<li>When the option to append comments is selected the following will be included in the email:<ul>
<li>The comment (if any) along with EMAIL_TEXT_COMMENTS_UPDATE.</li>
<li>The tracking number(s) along with EMAIL_TEXT_COMMENTS_TRACKING_UPDATE.</li>
</ul></li>
</ul></li>
<li>Added the option to "strip" HTML and PHP tags from the list of enabled shipping modules.</li>
<li>Added warning messages if ot_total or ot_subtotal are disabled.</li>
<li>Added a check (and repair) for missing core configuration directives related to attributes.</li>
<li>Moved initial checks and warnings performed by the edit orders admin page to a function.</li>
<li>Fixed a bug which did not allow products to use "partial" quantities (fractions).</li>
<li>Fixed a bug causing an obsolete file to not be removed upon install / upgrade.</li>
<li>File Upload attributes will now be passed along when updating the product. Removing a File Upload attribute is not supported.</li>
<li>Updated the code removing products from an order. These now use the Zen Cart "stock" configuration options to increment / decrement stock quantities.</li>
</ul></li>
<li>v4.1.2, 2017-07-28 (<a href="http://www.zen-cart.com/member.php?115838" target="_blank">A. Ballanger</a>)<ul>
<li>Changed the "local_sales_tax" line to no longer be editable as the value is automatically generated based upon the order.</li>
<li>When adding a coupon code, if the code is not valid the order total will not be added (and if invalid and present will be removed).</li>
<li>Added a check when adding checkboxes to avoid generating a warning when no checkbox in the option group was selected.</li>
<li>When removing a product from the order, other items in the order are now correctly processed and updated (if changed).</li>
<li>Fixed a bug caused when adjusting the quantity of an item in an order (introducted in Edit Orders 4.1.1).</li>
<li>Fixed a bug when adding a product to an order w/ a text attribute containing a double quote (").</li>
<li>Functions handling form inputs now utilize zen_db_output (added in Zen Cart 1.5.1) or fall back to htmlspecialchars.</li>
<li>One Time Charges for a product are now reflected in the Total Price column for the product (were already added to the subtotal).</li>
</ul></li>
<li>v4.1.1, 2013-07-13 (<a href="http://www.zen-cart.com/member.php?115838" target="_blank">A. Ballanger</a>)<ul>
<li>Updated tax calculations to Zen Cart 1.5.1 based code.</li>
<li>Fixed a tax calculation bug when all products were removed from an order.</li>
<li>Fixed the code handling product attribute updates to be more accurate.</li>
<li>Fixed a bug which caused the subtotal to always be zero.</li>
<li>Fixed a bug with the automatic calculation of onetime charges based on attributes (when adding a product).</li>
<li>When the order is loaded address information more closely matches the information found during checkout.
<ul>
<li>If we can determine the country by id, name, or iso code:
<ul>
<li>The "country" field will contain the Zen Cart country array.</li>
<li>The "zone_id" field will be populated based upon country and state.</li>
</ul>
<li>Otherwise, the "country field will contain the country name. This allows one to see / update the country (to one found in the Zen Cart country database).</li>
</ul>
</li>
<li>The country listed for addresses will now be displayed as a dropdown if the country exists in the Zen Cart database. Otherwise it will be displayed as text.</li>
<li>Copied the catalog tax function "zen_get_tax_rate_from_desc()" from Zen Cart 1.5.1 to support additional order total modules.</li>
<li>Copied the catalog function "zen_get_country_list" from Zen Cart 1.5.1 to support country dropdowns in the addresses.</li>
<li>Zen Cart functions copied from the "catalog" side are only included if not already present.</li>
<li>Disabled manual editing of the "Low Order Fee" order total module. This is handled automatically.</li>
<li>If no remaining order total modules are available to add to an order, the order total entry fields will not be shown.</li>
<li>Ty Tracker will add a tracking number to the sent email when:
<ol>
<li>The order is updated and notify customer is selected.</li>
<li>Ty Tracker is installed and enabled.</li>
<li>A Tracking Code is present for the "shipper".</li>
<li>The "shipper" is enabled in Ty Tracker.</li>
</ol>
</li>
<li>Included the "plugin" class and associated files.
<ul>
<li>The class and files are not part of "Edit Orders".</li>
<li>Provides for simplification of the installation / upgrade process.</li>
<li>Provides for simplification of the removal process.</li>
<li>Does some extra checks against Zen Cart's configure.php files.</li>
</ul>
</li>
<li>Created new install, upgrade, and removal processes.
<ul>
<li>Makes use of the "plugin" class and associated files</li>
<li>On upgrade attempts to make needed modifications to any existing orders.php from "Super Orders" or "Admin New Order"</li>
</ul>
</li>
<li>Cleaned up comments in "orders.php" to be more friendly.</li>
<li>Links in "orders.php" to edit will no longer appear if Edit Orders is not installed.</li>
<li>Moved 'BOX_CONFIGURATION_EDIT_ORDERS' into a language file (used to display the configuration menu item).</li>
<li>Updated readme (collaboration of Zen Cart forum members).</li>
</ul></li>
<li>v4.1, 2017-04-12 (<a href="http://www.zen-cart.com/member.php?115838" target="_blank">A. Ballanger</a> and <a href="http://overthehillweb.com" target="_blank">C. Jones</a>)<ul>
<li>Reduced duplicate code for Ty Package Tracker support.</li>
<li>Complete rewrite of the code handling products and attributes.
<ul>
<li>Utilizes Zen Cart functions and classes where possible.</li>
<li>Added many new functions to provide better support products and attributes.</li>
<li>Added a class used to abstract access to product attributes.</li>
<li>Used when displaying, updating, and adding products (including attributes).</li>
</ul>
</li>
<li>Added updated versions of some Zen Cart core classes to allow them to work correctly from the admin side of Zen Cart.
<ul>
<li><strong>admin/init_includes/init_currencies.php</strong> to load the currencies class.</li>
<li><strong>includes/classes/order_total.php</strong> to load the correct language files.</li>
<li><strong>includes/classes/shipping.php</strong> to load the correct language files.</li>
</ul>
</li>
<li>When adding a product:
<ul>
<li>You can now search by product id, name, description, and model.</li>
<li>Step 2 now shows both the product name and model.</li>
<li>The built-in Zen Cart functions are called in a similar manner as adding a product to your shopping cart. This ensures the order totals can be automatically updated.</li>
<li>You can disable the use of "specials / sales prices" still. This is not recommended.</li>
<li>The store settings for handling attributes (including showing / hiding) are utilized.</li>
</ul>
</li>
<li>When updating a product: product information is pulled from the database, then requested changes (such as name and price) are merged. This ensures the correct product information is always present in the order.</li>
<li>Updated to utilize the order_totals class and modules
<ul>
<li>Order Total modules are loaded when adding or updating a product.</li>
<li>Ensures proper calculation of subtotal and total.</li>
<li>Tax calculation now is done automatically using the store settings (same as during a customer checkout).</li>
<li>Order Total Lines are now added by selecting the desired module from a dropdown.</li>
<li>The Order Total dropdown contains a list of installed order totals not already present in the order.</li>
<li>Added support for specifying and changing the shipping module when a shipping line is used.</li>
<li>Removed field for changing the shipping tax. This is automatically calculated by <strong>includes/modules/order_total/ot_shipping.php</strong>.
</li>
</ul>
</li>
<li>Copied (and modified for use in the admin side of Zen Cart) a handful of the catalog tax functions to <strong>admin/functions/extra_functions/edit_orders_functions.php</strong></li>
<li>Updated the installation script to add additional failure messages and not report success if a step fails.</li>
<li>Fixed the order status dropdown to correctly select order status. This avoids the status being accidentally changed if the status is not "Pending (1)".</li>
<li>Moved the "edit" button in the order menu over so the "details" button is more likely to be clicked by someone quickly looking at an order. This should hopefully lower the number of "accidentally" edited orders.</li>
<li>Added special handling to support the <code>ot_loworderfee</code> module.</li>
<li>Added some "dummy" files for those upgrading from an older version.</li>
<li>Minor updates to the readme for version 4.1.</li>
</ul></li>
<li>Older, pre-v4.1 changes can be viewed <a href="older_versions_change_list.html" target="_blank">here</a>.</li>
</ul>
</body>
</html>