/
gotcha.txt
1827 lines (1424 loc) · 76.6 KB
/
gotcha.txt
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
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
####################################################################
# WebGUI Upgrade Gotchas #
####################################################################
This file contains a list of any changes you should be aware of when
upgrading from one version to the next, or even between multiple
versions. Be sure to heed the warnings contained herein as they will
save you many hours of grief.
8.0.0
--------------------------------------------------------------------
* WebGUI 8 is not API compatible with WebGUI 7. If you have custom
code, chances are you'll need to update it to make it work with
WebGUI 8. Please read docs/migration.txt for information about
changes to the WebGUI API.
* Many scripts in the sbin directory have been replaced by the webgui.pl
master script.
* upgrade.pl -> webgui.pl upgrade
* The rotation, deletion and reordering of Photos in a Gallery Album
has been removed because the way it was implemented in WebGUI 7
is incompatible with WebGUI 8.
* As part of the migration to Template::Toolkit, we will be changing template
variables from using dots to underscores. All templates using that namespace were
automatically upgraded to use the new variables.
In this version, these templates were updated:
Account Macro template
Admin Toggle Macro template
* The new Admin Console required changes to layout templates. Old templates
will continue to work, but show two sets of editing and drag controls.
* WebGUI 8 does not support HTTP Basic Authentication any longer.
* Support for server-side spell checking in the Rich Editor TinyMCE has been removed.
* The field metaData_values.value has been changed from 'char(255)' to varchar(1024).
This may be incompatible with some MySQL operations. Please check any custom modules
that access this field.
* Template::Toolkit is no longer an optional dependency. Please install it before attempting
to upgrade to 8.0.
7.10.24
--------------------------------------------------------------------
* WebGUI now depends on Business::OnlinePayment::AuthorizeNet. This version
should install automatically via the testEnvironment.pl script, or the
perl-standard CPAN module.
7.10.23
--------------------------------------------------------------------
* The default_search2 template had a bad template attachment pointing to
an old WebGUI CSS Snippet called /webgui.css. Any attachment with that
URL will be removed from ALL templates in the Search namespace.
7.10.21
--------------------------------------------------------------------
* WebGUI now depends on Kwargs.
7.10.17
--------------------------------------------------------------------
* Due to a formatting problem with form variables in the PayPal driver, WebGUI
in-shop credit was not being recieved by PayPal. This means that Shop users
were charged the full amount of the cart instead of the discounted amount.
7.10.15
--------------------------------------------------------------------
* WebGUI now depends on Geo::Coder::Googlev3 for it's Map asset
* canView has to pass for any www_ methods to get called at all on account
plugins. This is the correct behavior, but is a change in this version.
Please review your custom account plugins to make sure you aren't
relying on the old buggy behavior.
7.10.13
--------------------------------------------------------------------
* WebGUI now depends on XML::FeedPP::MediaRSS.
7.10.12
--------------------------------------------------------------------
* The Dashboard has been extended to include Asset Dashlets. This gives
Assets fine control over which properties can be extended and which can't.
Assets in the Dashboard can be set to be required, which prevents them from
being deleted, and fixed, which prevents them from moved.
* The StockData and WeatherData assets now include cache settings to reduce
server side load. The browser interface for the StockData asset still does
real time lookups.
* A new macro has been added, LastModifiedBy. This returns the username of
the user who last modified an Asset. If the asset in question is a Page
Layout or Folder, then querying that asset will also check all children.
* The Group form control has been extended to add a simple interface for
adding new Groups and changing their membership.
7.10.11
--------------------------------------------------------------------
* Modified TimeField, now provides popupless immediate validation with
an alert if the value is not interpretable when the user leaves that field
7.10.10
--------------------------------------------------------------------
* Asset metadata is now versioned.
* The updated versions of HTML::Packer, JavaScript::Packer and CSS::Packer
added for 7.10.9 require perl 5.8.9 or higher to run.
7.10.9
--------------------------------------------------------------------
* WebGUI now depends on Data::ICal for making and reading iCal feeds
for the Calendar.
* WebGUI now depends on updated versions of the HTML::Packer, JavaScript::Packer and
CSS::Packer modules. These new versions have much better performance than their
earlier incarnations.
7.10.4
--------------------------------------------------------------------
* WebGUI now depends on Monkey::Patch for doing sanely scoped
monkeypatches.
* WebGUI now depends on version 0.20 of Scope::Guard.
7.10.3
--------------------------------------------------------------------
* In the Collaboration System, previously the Group to Post group
was also allowed to view the CS. This made it difficult to
make the CS not viewable to regular users, so the behavior was
removed in 7.10.3. If your site depended on the Group To Post being
able to view the CS, then make the it a sub-group of Group To View.
7.10.2
--------------------------------------------------------------------
* The URL used by Display Message on Login always returns the user to
the page where they logged in. If your site depended on the old,
buggy behavior of returning the user to the home page after showing
a message, then in the Settings you can assign Redirect After Login Url
to /.
* The UKPLayer - a slideshow that displays images as a movie -
is in WebGUI again. Licencing information was overlooked. An
upgrade to 7.10.1 will break the Matrix. This is fixed now.
7.10.1
--------------------------------------------------------------------
* WebGUI now depends on PerlIO::eol, for doing line ending translation.
* The UK Flash player has been removed due to licensing issues with Debian
and the GPL. If you need this functionality, try using the Carousel
Asset instead.
7.10.0
--------------------------------------------------------------------
* Due to a bug in the 7.8.24-7.9.11 upgrade, the ordering of template
attachments has been lost. The bug has been fixed in 7.9.14 for sites
that have not been upgraded yet. Unfortunately, due to the nature of
the bug, the correct ordering cannot be automatically restored.
Another bug, in the new attachments javascript, will change all attachments
to type CSS when the template is saved. Since there are 2 types of Javascript
attachments, there's no way of recovering the original type. If you are using
template attachments and have upgraded to 7.9.13 directly, you will need to
check each template and update the types.
7.9.8
--------------------------------------------------------------------
* Starting in WebGUI 7.9.4, the Net::Twitter module is required.
7.9.7
--------------------------------------------------------------------
* Due to a bug introduced in 7.9.3, Scheduler tasks may have been deleted
from your site. The 7.9.7 upgrade will restore all default tasks, and tasks
for handling email from Collaboration Systems, but you should check any Scheduler
tasks that you have created.
7.9.6
--------------------------------------------------------------------
* The javascript check for email addresses has been removed.
7.9.5
--------------------------------------------------------------------
* Starting in WebGUI 7.9.4, the CHI and Cache::FastMmap modules are required.
* Starting in WebGUI 7.9.5, you cannot enter in a URL that is a has more than 2 dashes,
"-", in a row. They will be collapsed down into 1 dash.
7.9.4
--------------------------------------------------------------------
* Shop and Cart changes
This release contains a rework of the shopping cart to make it faster to checkout. Please
review the following list of changes;
* If no shipping address is entered for an item, it will not display the cart's shipping address.
* Visitors no longer have address books. To have an address book, users must log in.
* Users are still, at this point, required to login before they can checkout. The point where
the user must be logged in has been moved back in the checkout process. Before a user is allowed
to enter in any address information, they must be logged in.
* There are only two cart screens now. The main cart, where address information is entered, and
second screen where the summary of all charges (taxes, shipping, etc.) are summarized before the
user pays. Both screens are templatable.
* The Cart will now work without javascript. Javascript is used to make parts of the cart easier,
and to automatically update the user's cart so they don't have to manually update it.
* All custom Payment drivers have to be rewritten. Please read the POD for
WebGUI::Shop::PayDriver for information about the update. The upgrade script for 7.9.4
is designed to die if a non-core payment driver is detected, so after updating your custom
driver you will need to change the upgrade script.
* Custom cart templates will need to be updated to accomodate the new cart design.
7.9.3
--------------------------------------------------------------------
* Test:Deep, which had been an optional dependency for testing, has been used
in components of the core for a while, since the release of the new Survey.
Test::Deep version 0.095 or higher is now required.
7.9.2
--------------------------------------------------------------------
* new dependency: DateTime::Event::ICal 0.10 or higher
7.9.0
--------------------------------------------------------------------
* WebGUI new requires Test::Harness 3.17 or higher to enable the testing functions
the Survey.
7.8.13
--------------------------------------------------------------------
* A new gotcha was not documented in the 7.8.11 release, the new required version
of Javascript::Packer, 0.04. The correct version was put into the testEnvironment
script.
7.8.11
--------------------------------------------------------------------
* WebGUI now requires DateTime::Format::HTTP, to handle parsing HTTP dates.
* WebGUI now requires JavaScript Packer v0.04, for compressing javascript.
* The Google sitemap generator in WebGUI was including hidden pages in the list of
pages. This is now configurable, with the default being to NOT show hidden pages.
If you wish hidden pages to be shown, then in the config file set showHiddenPages
to 1.
7.8.6
--------------------------------------------------------------------
* WebGUI now requires LWP 5.833 or higher, to fix a bug in that module.
7.8.5
--------------------------------------------------------------------
* WebGUI now requires Locales 0.10 or higher, to replace the deprecated
module Locales::Country.
* WebGUI now requires Net::CIDR::Lite 0.20 or higher, to replace the deprecated
module Net::Subnets.
* Users, no matter if they are created via anonymous registration,
via the Admin Console Users screen, or via code, now always get
their default values from the Profile Fields instead of via
the Visitor account. Previously, based on how the user was created,
they would get default values from different places.
* The following style templates have been cleaned up by the TWG:
- WebGUI 6 Blank Style, Style 01; Style 02, Style 03:
- no structural changes
- Fail safe:
- added new CSS that is more robust and validates (in external file: style.css);
- it was also necessary to update the css to work with the new navigation templates
- changed the markup and the order of the home/login/user/admin controls at the bottom
- All of the above templates:
- added a link tag to wg-base.css
- added conditional comments at the top and bottom of the body tag to be able to target
IE versions easily with css
* Added wg-base.css, which is linked to in each style template. This stylesheet is for css that
is used in more than one tempalte, like pagination inline icons etc. Inline styles that are
removed from templates, will be replaced with styles in wg-base.css (and example is RFE 11182).
Elements that are styled in wg-base.css have a classname that starts with "wg-".
wg-base.css replaces webgui.css, which will be removed from the site.
7.8.4
--------------------------------------------------------------------
* A bug introduced in 7.8.1 could cause the Shop sale notification
group to be reset to the group Everyone. The bug has been fixed,
and the group has been reset to Admins. If you were using a different
group, you will need to edit the Shop Settings and reselect the
proper group.
7.8.3
--------------------------------------------------------------------
* WebGUI now requires Locales::Country 0.05 or higher to use
the UPS shipping driver.
7.8.2
--------------------------------------------------------------------
* WebGUI now requires Business::PayPal::API 0.62 or higher.
7.8.1
--------------------------------------------------------------------
* The EventManagementSystem schedule template was accidently given
the same namespace as the main EMS template. This allowed the
wrong template to be chosen for the main EMS template and the
schedule template. The upgrade from 7.8.0 to 7.8.1 will attempt
to fix this when default templates have been used.
* In the past, it was possible to leave WebguiRoot undefined
or incorrectly specified, and WebGUI would still function. It
must now be properly specified, which means it must be configured
in the global Apache section (outside any VirtualHost or
Directory sections) and point to the correct WebGUI root
directory. For example:
PerlSetVar WebguiRoot /data/WebGUI
* WebGUI creates thumbnails for uploaded images. The name for
those thumbnail files is created by prepending "thumb-" to the
name of the file. If a file that start with "thumb-" is created
then WebGUI would throw an error. Starting with 7.8.1, files
that start with "thumb-" will be renamed by removing that
prefix from the filename.
7.8.0
--------------------------------------------------------------------
!!! IMPORTANT !!!
You must upgrade to 7.7.20 before upgrading to 7.8.0
7.7.19
--------------------------------------------------------------------
* The search indexer was not properly indexing non-ASCII content
entered via TinyMCE. The behaviour has been corrected. If your
site has content in languages other than English, you should
re-index the site. This can be done with the search.pl utility
script by running
perl search.pl --configFile=www.mysite.com.conf --indexsite
or, to index all of the sites on the server:
perl search.pl --indexall
* For searching content with ideograms, ft_min_word_len must be
set to 2 in the Mysql config file. WebGUI will safely pad the
characters so that it does not need to be set to 1. The WRE
has ft_min_word_len set to 2 by default.
* If upgrading from WebGUI 7.6, you must first upgrade to 7.6.35,
then you can upgrade to WebGUI 7.7.19 and beyond.
7.7.18
--------------------------------------------------------------------
* The search indexer was not properly indexing non-ASCII content. The
behaviour has been corrected. If your site has content in languages
other than English, you should re-index the site. This can be done
with the search.pl utility script by running
perl search.pl --configFile=www.mysite.com.conf --indexsite
or, to index all of the sites on the server:
perl search.pl --indexall
7.7.17
--------------------------------------------------------------------
* It was found that the combination of
DBI: 1.52
DBD-mysql: 3.002
will cause an error during the 7.6.32 upgrade. Later versions
of these modules should work.
* Spectre now works like many other programs and uses a PID
file. By default, it will use /var/run/spectre.pid, but you
can change that in your spectre.conf file:
# The location of the file that keeps track of the master spectre
# processId.
"pidFile" : "/var/run/spectre.pid", ##Or some other location
After installing this version, you should manually kill spectre and
then modify the spectre.conf file to add the pidFile directive.
* The Default Gallery Album View Thumbnails template has been reworked
to get rid of intermittent rendering bugs with IE7. The thumbnail
pop-up is now completely CSS. The thumbnails.js file is still available,
but is now considered deprecated.
7.7.16
--------------------------------------------------------------------
* There was some confusion about the state of
WebGUI::Shop::PayDriver::PayPal::PayPalStd. While it was in fact
dysfunctional, it was using the Paypal Website Standard API, while
the new Paypal module was using Express Checkout. Express checkout
is only available in the US, UK, and Canada. PayPalStd has
been repaired, and the newly written Express Checkout module is
available at WebGUI::Shop::PayDriver::PayPal::ExpressCheckout.
7.7.15
--------------------------------------------------------------------
* WebGUI::Shop::PayDriver::PayPal::PayPalStd has been replaced by
WebGUI::Shop::PayDriver::PayPal. The old module by that name (a base
class for PayPalStd) has been removed. If you had the PayPalStd working,
the new module very likely will not work (the old one did some very
un-Shop things, which is why it was replaced). Please test the new one
with your setup.
* 29 templates have been replaced with new ones. These are the templates
for the Article, File, Folder, Image, Navigation, Layout, Poll, Search
and Syndicated Content assets. 13 templates have been deleted (Article,
Navigation and Layout templates). These were deleted because of deprecated
code, redundancy and because we are want to reduce the number of
templates. This will make the whole set of templates more comprehensible.
Changes for all these templates:
- extra divs, classes and IDs have been added;
- consistent markup for recurring code, like titles, descriptions, attachments and pagination;
- inline styles and deprecated code removed.
Article
- All Article templates:
- Removed pagination. This will be re-added later, when the pagination macro bug has been fixed (bug #10619)
- Default Article:
- Added attachment loop (RFE #4152)
- Removed code for image, since there now is a dedicated Article with Image template
- Center Image:
- Deleted: align="center" is deprecated
- Left align image:
- Changed name to Article with Image
- Removed tables and added styles for img positioning
- Linked Image with Caption
- Removed tables and added styles for img positioning
- Item:
- Added attachment loop
- Item w/ popup links:
- Deleted: pop-up links are bad practice and this doesn't need to be a default
- Article with files:
- Deleted: attachment loop now added to Default Article
- article.css added
File
- Default File:
- The linktext is title instead of the filename (RFE #10173)
- Flash File:
- Template now uses swfobject code
- Absolute width and height attributes are set in the html to replace the percentage value and inline style
Folder
- File Folder:
- The linktext is title instead of the filename (like in the Default File template)
- Tables have not been removed, since they are semantically correct here
Image
- Image:
- Only added extra div with ID and class
- Annotate Image:
- No changes
Changes for Navigation
- crumbTrail:
- No specific changes
- verticalMenu:
- Deleted: best practice is using "Bulleted List" for vertical navs
- horizontalMenu:
- Based on unordered list
- Added styles
- DropMenu:
- Javascript cleaned up
- Noscript alternative added
- Tabs:
- Based on unordered list
- Added styles
- Tree Navigation:
- Javascript cleaned up
- Hierarchical top nav:
- Javascript cleaned up
- Synopsis:
- HTML based on definition list
- Bulleted list:
- Now always generates validating html (closing ul and li tags)
- Indent Nav:
- No specific changes
- navigation.css added
Layout
- All table layouts:
- Deleted: using tables for positioning is bad practice
- All non table layouts:
- Removed unnecessary divs ("layoutColumnPadding" and "content")
- Styles for positioning added
- One Over Two:
- Newly added
- Replaces News, but has one less content position
- News, Three Over One, Left column:
- Deleted: we want to reduce the number of templates and only kept the basic/most used page layouts
- layout.css added
Poll
- Default Poll:
- General cleanup, added extra classes and IDs
- poll.css added
Search
- Default Search:
- Results in a definitions list
- Form post back to the current page instead of to the asset in wobject focus,
this prevents possible "breaking" of the style
Syndicated Content
- Default Syndicated Content:
- General cleanup, added extra tags, classes and IDs
- Syndicated Articles:
- General cleanup, added extra tags, classes and IDs
- Removed inline style
7.7.13
--------------------------------------------------------------------
* WebGUI has allowed metadata possible values to be processed differently
by Posts than from other Assets. This causes problems when metadata is
shared between Posts and other Assets. To rememdy this, all metadata
possible values are being moved into the standard "pipe format", and
the Post will no longer process data in the other format.
7.7.8
--------------------------------------------------------------------
* A basic behavior of the Inbox has been changed. If a message is
sent to a Group of WebGUI users, and any member of the group reads
the message, then that message is marked as read by all members. This
most often happens for commit reminders for version tags that require
approval. The old behavior often resulted in several users trying
to approve version tags that had already been approved.
7.7.7
--------------------------------------------------------------------
* WebGUI now requires Digest::SHA.
* WebGUI now requires JavaScript::Minifier::XS 0.05
* WebGUI now requires CSS::Minifier::XS 0.03
7.7.6
--------------------------------------------------------------------
* You must upgrade to WebGUI 7.7.5 before going to this version.
* WebGUI now requires Business::Tax::VAT::Validation.
* WebGUI now requires Crypt::SSLeay 0.57 or greater.
* WebGUI now requires Scope::Guard 0.03 or greater.
7.7.5
--------------------------------------------------------------------
* You must upgrade to WebGUI 7.7.4 before going to this version.
* Due to a long standing bug in the Profile system, if the type of a
Profile Field was changed, the database column was not updated to match
the requirements for the new type. The most common place this problem
would be noticed would be if a text field was changed to HTML field.
* The Event url template variable was being used incorrectly. This has
been fixed, but requires new template variables for viewing a list
of events, printing events and editing and deleting events. Please
check the online Help for the new template variables.
Event templates using HTML::Template are automatically updated. If your
site uses a different parser for this template it will need to be manually
upgraded.
* WebGUI now requires HTML::Packer, JavaScript::Packer, and CSS::Packer
7.7.4
--------------------------------------------------------------------
* You must upgrade to WebGUI 7.7.3 before going to this version.
* WebGUI now requires XML::FeedPP version 0.40 or greater.
7.7.2
--------------------------------------------------------------------
* WebGUI now requires Clone version 0.31 or greater.
* You must upgrade to WebGUI 7.7.2 before going on to higher versions of WebGUI due
to changes in the database table for the Cart.
* The RSSCapable class and RSSFromParent asset have been removed.
Any custom assets using those are recommended to switch to the new
RssFeed AssetAspect. If not used by custom assets, the tables
used by them will be removed from the database.
This will change the URLs for your RSS Feeds from "myAsset.rss" to
"myAsset?func=viewRss". You will need to update all Syndicated Content
assets and other content aggregators that had the old URLs. Alternately,
you can use Redirect assets to forward the old URL to the new one.
7.7.1
--------------------------------------------------------------------
* Keywords are now comma separated rather than space separated. Quotes are
no longer treated specially and will become part of keywords. Keywords
cannot contain commas. Keyword searching is still case insensitive, but
keyword will preserve the case of what is entered.
7.7.0
--------------------------------------------------------------------
* WebGUI now requires Params::Validate version 0.81 or greater.
7.6.11
--------------------------------------------------------------------
* If upgrading from WebGUI 7.5, you should upgrade to 7.5.40 first,
then you can upgrade to WebGUI 7.6.11 and beyond.
7.6.10
--------------------------------------------------------------------
* The Survey JSON fields (Survey.surveyJSON and Survey_response.responseJSON)
will alter to longText from LongBlob's.
7.6.9
--------------------------------------------------------------------
* The ukplayer example, slideshow.html in /extras/ukplayer, used
to be loaded with a javascript called AC_RunActiveContent.js.
This file is removed due to licencing issues. If you use this
script in custom HTML, you should replace it with swfobject.js
as is demonstrated in the new example slideshow.html file.
7.6.8
--------------------------------------------------------------------
* Due to an error during the 7.6.6 development cycle, an Itransact template,
for displaying the credentials screen, needs to be reimported. Any changes
that you have made to this module will be lost, so please make a back up
of this template.
7.6.5
--------------------------------------------------------------------
* The deprecated use of Graphics::Magick has been eliminated. WebGUI uses
Image::Magick exclusively for all image processing functions once again.
* The Head Block of Templates has been merged into the Extra Head
Tags field. Extra Head Tags are now added for all templates and
assets included on a page, except for Style templates, which do
not have Extra Head Tags. Existing Extra Head Tags for Style
templates will be lost. If your current Style template uses
the Head Block please put any content from there directly into your
style template inside the <head></head> tags.
* Web Services Client is no longer part of the official distribution of
WebGUI, but is still available to be maintained by third-parties. However,
if you don't want to use Web Services Client any longer, make sure you
delete all Web Services Clients from your site prior to the upgrade *and*
purge them from your trash. Then the upgrade will automatically uninstall
the Web Services Client from your site.
7.6.4
--------------------------------------------------------------------
* The user facing portions of WebGUI's profile, inbox, friends, and "invite
a friend" systems have been completely updated. No data will be lost
but all templates including custom templates that are related to these
systems will be deleted on upgrade. Please make sure you export your
custom templates prior to upgrading as you will need to modify them for
the new system.
* The Auth display account template no longer has the account.options loop
available. This loop has been replaced entirely by macros to provide more
flexibility. Any custom templates will need to be updated accordingly.
* The Survey system has been completely updated. Please make sure you
create full backups of your survey results and export them as needed.
Results will not be imported into the new Survey system. Your old surveys
will be imported into the new survey system.
7.6.3
--------------------------------------------------------------------
* WebGUI now requires XML::FeedPP version 0.36 or greater.
* The Syndicated Content asset has been heavily modified. Your templates
and settings should automatically migrate, but in less than 1% of cases
there will be problems that the migration cannot handle. Check your
Syndicated Content assets after upgrade to ensure they are still
working as expected.
7.6.1
--------------------------------------------------------------------
* WebGUI now requires Class::C3 version 0.19 or greater.
7.6.0
--------------------------------------------------------------------
* WebGUI now requires Module::Find version 0.06 or greater.
* You must be fully upgraded to 7.5.24 before upgrading to 7.6.0
* You can no longer template the AdminBar macro. Any custom template
id that you pass it will be ignored, and the original template will
be removed from your site.
7.5.21
--------------------------------------------------------------------
* Previous versions of WebGUI used the wrong day of the week for
scheduled workflows. This resulted in them being run a day later
than they should have. If you relied on the old behavior, you
will need to update your workflow schedules.
7.5.19
--------------------------------------------------------------------
* WebGUI now requires Text::CSV_XS version 0.52. If you have been
using an earlier version you will need to upgrade this perl
module before you upgrade.
* If a user profile field allowed multiple selects, and it also had
more than one default value, the User method profileField would
return the first. It will now return all default values as a string,
joined by commas.
7.5.17
--------------------------------------------------------------------
* If users are allowed to self register and emails are not required, this
might cause downstream bugs in other assets that require email addresses.
7.5.16
--------------------------------------------------------------------
* You need the following Perl Modules installed before you upgrade:
File::Path
7.5.13
--------------------------------------------------------------------
* RSSFromParent now uses the parent asset's canView method to
determine if the user is allowed to see the RSS feed.
The upshot of this is that a user must be able to view the
Collaboration System in order to view its RSS feed.
Previously, RSSFromParent did no view restrictions, allowing
anyone with the right URL to see an RSS feed, even if they do not
have permission to view the Collaboration System it came from.
* The 7.5.11 upgrade contained a bug that didn't import existing
Data Form entries properly. The script has been corrected, so if
you didn't already upgrade to 7.5.11, there is nothing to worry
about. If you already upgraded, the information can be restored
from a backup. See
http://www.webgui.org/bugs/tracker/data-form-listing-existing-entries-wrong-missing-data
for information on how to retrieve this information without having
to revert entirely to a past backup.
7.5.11
--------------------------------------------------------------------
* You need the following new Perl Modules installed before you upgrade:
Archive::Any
Exception::Class
Path::Class
Image::ExifTool
List::MoreUtils
* SQL Form is no longer part of the official distribution of WebGUI,
but is still being actively maintained by third-parties. However, if you
don't want to use SQL Form any longer, make sure you delete all SQL Forms
from your site prior to the upgrade *and* purge them from your trash. Then
the upgrade will automatically uninstall the SQL Form from your site.
* WebGUI versions since 7.3.0 (when the new Calendar was added)
have allowed users to post Events to Calendars, but the owner of
the Event has been saved as Admin (user ID 3). Also, anyone who
was allowed to add an Event was allowed to edit any Event in the
Calendar.
The permissions have now been fixed, but it is not possible to
fix the owner of Events posted by individual users. Users are
not allowed to edit the owner of an Event from the web interface
as a security measure.
The new permissions are:
* Users who post an Event are allowed to edit and delete the
Events they post
* Users who can edit the Calendar are allowed to add, edit,
and delete all Events
* The commerce system was completely rewritten. As such you will need
to tweak some settings to get commerce back up and running.
* Shipping configurations are going to be lost when you upgrade. You'll
need to set up a shipping option if you're using the commerce system.
* Products in the old Commerce system have been converted to new Asset-based
Products in a new folder called Products. Instead of using the ^Product()
macro to display a Product on a page, either place the Product directly
onto a page (like any other asset) or use the AssetProxy macro. In all
Wobjects, Templates and Snippets, the Product macro has been replaced
with the AssetProxy macro.
* The Product template variables now use the new WebGUI standard of not
using dots in their names. For example, brochure.icon is now brochure_icon
* All Product Templates that shipped with earlier versions of WebGUI have
been deleted, except for the Default Product Macro. During the upgrade,
all products have been updated to use the Default Product Macro. If you want
to keep these, you will need to make a copy of them before the upgrade.
* All Commerce Templates that shipped with earlier versions of WebGUI have
been deleted. If you want to keep these, you will need to make a copy of
them before the upgrade.
* Subscriptions have been converted to assets. These assets will be placed in
the import node in the folder 'Migrated Subscriptions'.
* It used to be possible to link subscription codes to multiple subscriptions.
This is no longer the case. Subscription code that are not yet expired or used
and link to multiple subscriptions will be migrated in the following manner:
1) The subscription codes will remain valid for one of the subscriptions they
linked to.
2) For the other subscriptions connected to these codes new subscription codes
will be generated. The upgrade script print all the new codes in the case.
The new codes will also be logged in the webgui log file.
* With the new shop system the Payment plugins have been changed too. The default
WebGUI Payment Plugins are automatically migrated for you, but custom plugins
will have to be adapted to use the new WebGUI::Shop API.
* If you are using the ITransact payment plugin you'll have to change the postback
url. The new value is printed by the upgrade script and can also be found in
the edit screen of the ITransact plugin.
* The Commit With Approval and Commit Without Approval workflows have been
rebuilt. If you have changed these default workflows and wish to retain your
changes, be sure to back them up before you install 7.5.11
7.5.9
--------------------------------------------------------------------
* WebGUI 7.5.6 uses a Unicode database connection, but this can cause problems
with old data stored in an erroneous format. The 7.5.6 upgrade has been
adjusted to compensate for this. If you are upgrading from prior to 7.5.6,
the data should be repaired automatically. However, if you had already upgraded
past 7.5.6, there is no automated way to resolve the differences in the data.
For information on how to resolve this if you have already upgraded, see
http://www.webgui.org/bugs/tracker/charset-db-connection
7.5.4
--------------------------------------------------------------------
* YUI has been upgraded to 2.5.0. The resizable textarea implementation in
WebGUI has been rewritten using YUI instead of the Ext library. This has
removed Ext as a depenancy, and it has been removed.
7.5.1
--------------------------------------------------------------------
* The resizable textarea implementation in WebGUI has been reimplemented to use
the code present in YUI 2.5.0. As such, WebGUI's YUI implementation has been
updated to version 2.5.0, and the no-longer-needed extjs library has been
removed.
7.5.1
--------------------------------------------------------------------
* There was a corrupt template in a package for the 7.5.0 upgrade.
If you already upgraded to 7.5.0, please import the package
located at:
WebGUI/docs/upgrades/packages-7.5.0/root_import_timetracking_user.wgpkg
* WebGUI requires newer versions of some existing modules. Be sure to
install them BEFORE upgrading. They are:
JSON 2.04
Config::JSON 1.1.2
7.5.0
--------------------------------------------------------------------
* You must upgrade to 7.4.40 before you upgrade to 7.5
* Event related links are now displayed using a template loop
rather than a template variable. See the default templates for
details.
Your custom Event Edit and Event View templates may need fixing.
* If you want to use the beta, you must first upgrade to 7.4.21 then
upgrade to the beta. If you upgrade past 7.4.21 then you cannot
use the beta.
7.4.12
--------------------------------------------------------------------
* Any customizations made to the Matrix default Search, Compare or
Detailed listing templates will be lost. Please back up your
custom templates before running the upgrade.
7.4.11
--------------------------------------------------------------------
* The 7.4.8 upgrade script had an error for sites using Dashboards.
This would prevent the script from completing successfully. The
script has been fixed for future releases.
7.4.3
--------------------------------------------------------------------
* You must upgrade to Config::JSON 1.1.0 or higher prior to upgrading.
Due to a bug in CPAN you should type "force install Config::JSON" in
order to upgrade to this version.
* For Poll Wobjects, we're using a new way to store the graph
configuration. If you were having problems with your Poll graphs,
you will need to re-create the graph's configuration. It may not
be possible to read your graph configuration, so if you have
problems with the Poll graphs you will need to re-create the graph's
configuration. After you create a new configuration, everything will
work fine.
7.4.0
--------------------------------------------------------------------
* You must upgrade to the latest 7.3.x release before upgrading to
7.4.0 or you will encounter fatal errors during the upgrade
process.
* The userProfileData table has been completely re-done. Now, each
user profile field has its own column in the userProfileData table.
Any applications that you may have that makes raw SQL queries against
the userProfileData table will need to be updated to reflect these
changes.
* DatabaseLinks no longer automatically set LongReadLen and LongTruncOk
for Oracle or ODBC databases. These parameters, and others, can now
be set in the DatabaseLink. The old settings used were
LongReadLen: 512*1024
LongTruncOK: 1
* WebGUI now requires the following additional perl modules to operate,
and you should install them prior to upgrading:
Config::JSON
Text::CSV_XS
Class::InsideOut
HTML::TagCloud
* WebGUI now uses Graphics::Magick instead of Image::Magick for
image processing functions. However, for the next few versions you
will still be able to use Image::Magick if you already have it
installed, to make the transition easier. Graphics::Magick is a
fork of Image::Magick, but it's focus is stability and compatibility
over adding new features. Another note will be added to this file
when support for Image::Magick is officially removed. That will
most likely happen in WebGUI 7.6.0. Note that WRE 0.8.0 includes
Graphics::Magick, so if you upgrade to WRE 0.8.0 then you'll
automatically be ready for the future.
* Any customizations made to the Inbox or Inbox/Message templates
will be lost. Please back up your custom templates before running
the upgrade
* The Transaction Error template in commerce has been merged with the Checkout
template. All Transaction Error templates are purged from the system on upgrade.
Make sure you back up your custom templates and apply them to the Checkout template.
None of the template variables have changed.
7.3.19
--------------------------------------------------------------------
* There was a bug fixed in this release relating to the Image asset.
The bug was that if you edited an Image, then the original image file
in the asset was replaced with its thumbnail. There is no easy way to
automatically fix this the results of this bug. To recover affected
Image Assets, then just upload a copy of the original image file. You
do not need to Trash/Delete the Image Asset.
7.3.16
--------------------------------------------------------------------
* There was an inadvertent override of the Asset method isLocked inside
of WebGUI::Asset::Post::Thread.pm. Normally, isLocked will return true
if the Asset is being edited by another user. However, the isLocked inside
of Thread.pm returned true if the Thread was locked to prevent more
replies from being added to the it.
In 7.3.16, the thread lock method inside Thread.pm was renamed
isThreadLocked. No template variables, field names or database
columns were changed.
* The create.sql script for 7.3.15 was released with 7.3.16. While
upgrading to 7.3.17 you'll notice it also processing the 7.3.15-
7.3.16 upgrade. This is to be expected.
7.3.15
--------------------------------------------------------------------
* The Event Management System now uses an extra table to store
information about events in the user's cart. This fixes a bug
where a user that logs out after adding events to their cart but
before they complete their transaction will be charged for their
events but not registered for them.
Existing sessions affected by this bug are not fixed, so there may still
be errors. This SQL query will get the session IDs of the
sessions affected by this bug: