1This file documents the revision history for Perl extension Maypole.
2For information about current developments and future releases, see:
3    http://maypole.perl.org/?TheRoadmap
4
5
6
72.13 April 2008
8SVN Revision
9
10Bug Fixes :
11   DBD::SQLite no longer required by Makefile.PL
12   CGI handler now produces response for fatal error (bug 29981)
13   Fix to link macro
14   Fix to redirect_request in Apache::MVC
15   Fix to mime detection by file extension
16   Fixed MODIFY_CODE_ATTRIBUTES and FETCH_CODE_ATTRIBUTES to work with mod_perl threaded model
17     - Patch from Ben Hutchings http://rt.cpan.org/Public/Bug/Display.html?id=29984
18   fixes for bug 29982 Inconsistency between examples and tutorial (patch from Ben Hutchings)
19   fixed apache_mvc.t to work with Apache2 (bug #29979 patch from Ben Hutchings)
20   added post_chomp as default option for TT view
21
22Improvements :
23   link macro now takes a target argument, and has slightly better pod
24
252.121 29 August 2007
26
27SVN revision 581
28
29Bug Fixes :
30   Apache::Request is fetched with a new object instead of instance if request options are provided
31   additional, request_options and view_options attributes of Maypole::Config are initialised with hashref
32   do_delete action now has exported attribute in ::Model::CDBI::Base
33   Fixed links in flox to cookbook (bug 22899)
34   Applied change from bug 14565
35
362.12  22 June 2007
37
38SVN revision 573
39
40Bug Fixes :
41   Fixed some db_colinfo test bugs
42   Fixed typo in edit form template
43   AsForm fixes to stringification _to_select
44   made DFV and FromCGI warn instead of die on unexpected cgi params
45   small improvements to some factory templates
46   fix to path handling in mod_perl and CGI when location ends in /
47   fixed template path ordering so i.e. /tablename/list is used before /list when provided with a tablename
48   fixed template path with array refs
49   fix to template being reset from path in plain templates (i.e. where no model), may affect those relying on the bug ( bug 23722 )
50   fix to display_line macro in factory templates (bug 22920)
51   fix to correct problem with LocationMatch and regex based Location directives in apache config.
52   fix to redirect_request
53   Fixed typo in _do_update_or_create (bug 26495)
54
55
56API additions and enhancements :
57   new Class::DBI::DFV based model
58   New config method : additional, for stashing additional info, especially from additional_data method
59   new warn method in maypole/request class/object, over-ridden by Apache::MVC, etc or own driver
60   new build_form_elements attribute for Maypole request and Maypole::Config, set it to 0 to avoid building cgi form if you don't need it
61   added CGI params to TT error template
62   improvements to factory templates
63   added search_columns method to base cdbi model class, provides display_columns unless over-ridden
64   added new hook - preprocess_location
65   added new attribute to Maypole::Config - request_options
66   improved pager template macro
67
68
69Internal additions and enhancements :
70   Inheritence simpler and nicer and less hacked
71   add_model_superclass method moves @ISA munging into the model
72   new test to check everything compiles
73   Model inheritance re-organised
74
752.111 Mon 30 April 2007
76   - forked - see 2.111 changelog
77
782.11 Mon 31 July 2006
79
80SVN revision 519
81
82Deprecated:
83    Directly accessing the attributes of the request object, or the parameters
84    in $r->params, or anything else, is DEPRECATED and likely to break in future
85    releases. Be good, and use proper method calls.
86
87    Maypole no longer uses Class::DBI::AsForm, instead Maypole::Model::CDBI::AsForm
88    has replaced it.
89
90    $config->{$table}{required_cols} is deprecated, please use $class->required_columns instead
91
92
93Incompatible API changes:
94    Maypole
95	 - is_applicable() deprecated for is_model_applicable(). is_applicable is
96         an alias for is_model_applicable now.
97    Maypole::Constants
98	 - ERROR constant now 500, previously -1 (bug #18901)
99    Maypole::Model
100	- delete and search actions are now deprecated - use do_search and do_delete
101	  instead
102    Maypole::View
103	- table name rather than moniker is used to find templates
104
105API additions and enhancements:
106    Maypole::Application:
107    	- -Init flag (wishlist 14123)
108        - recognises Maypole::HTTPD and installs Maypole::HTTPD::Frontend
109            as its frontend
110    Maypole::Headers:
111    	add() alias to push() (wishlist 14142)
112    Maypole:
113        - get_session() method (no-op)
114        - get_user() method (no-op)
115        - get_session() is called during handler_guts() before authenticate()
116        - new preprocess_path() method added and called by parse_path(),
117	        parse_path() will leave any properties set by preprocess_path() in
118            place
119        - start_request_hook() added
120        - status() attribute added (though only used by start_request_hook()
121            so far)
122        - setup() split into setup(), setup_model(), and load_model_subclass()
123        - added new path processing methods for ssl and default table/action
124        - added make_path()
125        - added make_uri()
126	- improved exception handling
127	- now uses File::MMagic::XS to guess mime type of output unless already set
128	- new component method provides Maypole::Component functionality
129	- new object method gets/sets first/only object in objects
130     Maypole::Model
131	- do_delete, do_search in place of delete/search actions
132     Maypole::View::TT:
133	- new report_error method
134	- new embedded error report page in __DATA__
135     Templates:
136        - Improved pager macro/include
137	- Improved factory templates
138        - added the status() attribute, although it's not used in many places
139            yet
140	- Changed factory edit/view to use object instead of objects
141     Maypole::Model::CDBI
142	- improved error messages in do_edit action
143        - new required_columns mutator method
144        - new column_required accessor method
145
146Bug fixes:
147    Fix to cgi_maypole.t (bug 11346)
148    Fix to TT error reporting (bug 13991)
149    Template xhtml validation (bug 13975)
150    Apache2 fixes in Apache::MVC (bug 13888)
151    Fixed inheritance issues in Mp::Application - Mp::App now manipulates the
152        caller's @ISA directly, and doesn't inject itself into the chain (bugs
153        12923 & 14120)
154    Improved Template error reporting (14133)
155    Maypole::Session::generate_unique_id() now returns the id (bug 14124)
156    Moved ar accessor to Apache::MVC (bug 14014)
157    Refactored core to support further development in 2.11 and onwards
158    Fixed related_class() method (bug 14566)
159    Added a cgi() attribute in Maypole::CGI
160    Factory templates now less vulnerable to XSS (bug 16659)
161    Reduced risk of XSS in factory templates (bug 16659)
162    model search/delete methods in model and subclassing the cdbi mode (bug 16661)
163    fixed problems with stringify_self and untaint missing ignore columns (bug 15678)
164    fixed Maypole::Model::CDBI::Plain to JustWork(TM) with plain CDBI Classes (bug 16977)
165    some silent death scenarios resolved
166	Now initializes template_args, stash, parmas, objects and others to correct data type. (bug 15147)
167
168Documentation:
169    Fix to documentation for CGI::Maypole (bug 7263)
170    Simplified Net::Amazon example (bug 14073)
171    Numerous major and minor updates to docs.
172    Renamed Maypole::Manual::Request to Maypole::Manual::Cookbook
173	Added Maypole::Manual::Install, with material removed from
174	    Maypole::Manual::About
175	Added Maypole::Manual::Inheritance
176	Added Maypole::Manual::Terminology
177        - updated Maypole::Manual::View
178        - updated Maypole::View:TT
179    Examples of fancy forms and templates using new features
180
181Requirements:
182   HTTP::Body now required
183   CGI::Untaint >= 1.26 now required rather than >= 0
184
185
1862.10 Tue 19 Jul 2005
187    Multiple Template Paths added ( http://rt.cpan.org/NoAuth/Bug.html?id=13447 )
188    Small fix to templates/factory/frontpage ( http://rt.cpan.org/NoAuth/Bug.html?id=11236 )
189    MasonX support in Maypole::Application ( https://rt.cpan.org/NoAuth/Bug.html?id=12383 )
190    Maypole::Model::CDBI::Plain / Maypole Config issue ( http://rt.cpan.org/NoAuth/Bug.html?id=11530 )
191    Repeat Submission detection support ( Bug #6500 )
192    Fix to setup_database in Maypole::Model::CDBI ( Bug #12384 )
193    Fix to plugin to allow Maypole::Plugin::Config::YAML to work
194    Fix to Maypole::Model::CDBI order sub from list
195    Improvement to primary display column using CDBI
196    Improved efficiency of finding stringified columns using new classmetadata field
197    Fixed BeerDB to untaint pub fields
198
199    Additional Requirements : Digest::MD5
200
2012.09  Mon Jan 25 22:00:00 2005
202    Fixes:
203    - Fixed plugin inheritance set up by Maypole::Application, added tests
204
205    Templates:
206    - factory/addnew will only prefill values when there's a row creation error
207
208
2092.08  Mon Jan 24 20:45:00 2005
210    - Added $r->config->template_extension() to set optional file extension
211      for templates (Dave Howorth)
212
213    Fixes:
214    - Maypole::Application adds plugin classes to caller's @ISA (Marcus Ramberg)
215    - FETCH_CODE_ATRIBUTES in M::M::Base should return an empty list if there
216      are no attributes
217    - M::M::CDBI will warn() about Class::DBI::FromCGI errors
218
219
2202.07  Sun Jan 16 18:45:00 2005
221    (This version was not uploaded to CPAN)
222
223    Internal changes:
224    - Removed Maypole::Model->description. It didn't work as expected and
225      clashed with 'description' columns in the database
226
227    Fixes:
228    - Model->process() shouldn't set $r->objects() to a list with a single,
229      undefined element
230    - Fixed overriding $r->template_args->{classmetadata} in M::V::Base
231      (Thanks to Dave Howorth for spotting the mistake)
232    - #9473: Maypole::Model::CDBI->related_class (Thanks David Baird)
233    - #9434: M::M::CDBI->search generated "uninitialized value" warnings
234
235    Templates:
236    - The addnew template will attempt to prefill form fields with request
237      parameters
238    - edit template includes 'addnew' if there is no object to edit
239
2402.06  Wed Dec 29 01:30:00 2004
241    Fixes:
242    - Minor restructuring of the manual so search.cpan.org indexes it better
243    - #9129: Skip t/apache_mvc.t if Apache::Request isn't installed
244
245
2462.05  Fri Dec 24 03:20:00 2004
247    - Revised and updated documentation. Many thanks to Dave Howorth for his
248      hard work and 120kb documentation patches.
249    - Added support for request and response HTTP headers with
250      $r->headers_in & $r->headers_out (Maypole::Headers)
251    - Support for compound primary keys for Maypole::Model::CDBI classes
252    - Template toolkit objects are configurable with M::Config->view_options
253    - Templating performance should be improved when running Maypole with
254      mod_perl since compiled templates remain in memory. CGI users can use
255      TT2's COMPILE_DIR or COMPILE_EXT options with
256      Maypole::Config->view_options to improve performance
257
258    Internal changes:
259    - Added a new override for the model: fetch_objects().
260    - 'classmetadata' template variables can now be overriden individually
261    - New unit tests for Maypole, CGI::Maypole, Maypole::Headers, and others.
262      More to come.
263
264    Fixes:
265    - Maypole::CLI is more tolerant of trailing slashes in the request/uri_base
266    - fixed a bug in CGI::Maypole::parse_location() (Dave Howorth)
267    - Also applied that fix to Apache::MVC (Marcus Ramberg)
268    - some fixes for Maypole::Config, Maypole::Model::Base and
269      Maypole::Model::CDBI::Plain (Dave Howorth)
270    - Documented adding new accessors to Maypole::Config
271    - Added Apache::RequestIO to Apache::MVC (michael#diaspora.gen.nz)
272    - Applied patch to fix length of utf8 documents.
273    - support compound primary keys in CDBI fetch_objects.
274    - Check if has_a actually points to a Maypole::Model (Dave Howorth)
275    - Make test suite work with DBD::SQLite2
276    - default search() action removes empty fields from search parameters
277    - #6622 - Maypole::Application will create a separate Maypole::Config for
278      each application (instead of the current workaround for multiple apps
279      under mod_perl)
280    - #7643 - improve M::V::Base's error() messages. prefix error with label,
281      and carp()
282    - #7651 - minor POD improvements in M::M::CDBI (Dave Howorth)
283    - #7834 - minor POD update in M::M::CDBI (Kevin Connor)
284    - #7917 - if do_edit fails for object creation, try again with the correct
285      template (addnew)
286    - #7930 - handle Class::DBI constraint failures in do_edit.
287
288    Templates:
289    - add support for compound primary keys in factory templates
290      (Dagfinn Ilmari Manns�ker)
291    - Only show buttons for public actions.
292      (Dagfinn Ilmari Manns�ker)
293    - Split the meat of the view template off to a view_item macro.
294    - New login template
295    - Other assorted css/template fixes
296
297
2982.04  Tue Oct 27 14:00:00 2004
299    - fixed Apache::MVC version (Randal Schwartz)
300    - fixed template_args (Dave Howorth)
301    - new Maypole::Config documentation (Dave Howorth)
302    - Maypole::Model::Base::process() no more steals you the first
303      arg after fetching objects
304
3052.03  Tue Oct 26 13:00:00 2004
306    - increased version number of Apache::MVC
307    - fixed display_tables bug (Steve Simms)
308    - fixed templates, now again XHTML compliant
309    - documentation fix (Dave Howorth)
310    - only set charset for text/*
311
3122.02  Mon Oct 25 13:00:00 2004
313    - Fixed charset in http header.
314    - replaced action links with forms in factory templates
315
3162.01  Sun Oct 24 14:50:00 2004
317    - documentation fix to make t/03podcoverage happy
318
3192.0   Fri Oct 22 20:00:00 2004
320    - added parse_args() (Simon Flack)
321    - call additional_data() and authenticate() for plain templates
322    - merged Apache2::MVC (mod_perl2 support) into Apache::MVC
323    - added Maypole::Application universal front-end
324    - config parameter handling for Maypole::Model::CDBI
325    - $r->{query} is now deprecated, use $r->{params} for GET and POST
326    - fixed multiple value handling (Simon Flack)
327    - added exception handling (Simon Flack)
328    - fixed documentation bugs
329    - changed default documentencoding to utf8. Change with
330      $r->config->{document_encoding}
331    - removed Maypole::View::Mason as it's distributed separately on CPAN.
332    - factory templates are now XHTML 1.1 compliant.
333    - made the config hash into -> Maypole::Config
334    - accessors for everything
335    - win32 support
336    - new documentation for Maypole.pm (Simon Flack)
337    - moved doc/*.pod to lib/Maypole/Manual
338    - added Maypole::Model::Base::is_public() to make it simple to overload
339      :Exported behavior
340    - added support for replacing use base qw/All My Modules/ with
341      use Maypole::Application qw/Redirect AnotherPlugin/; note that this
342      will only triggers with parameters to import, to preserve backwards
343      compability.
344    - fixed search ordering in Maypole::Model::CDBI and parameter
345      handling in CGI::Maypole (Dave Slack)
346    - sweet new factory templates (Danijel Milicevic)
347    - zero search fix (Dave Slack)
348
3491.7   Sat Jul 17 20:15:26 BST 2004
350    - Emergency release - we lost the "use Maypole::Constants" from
351      CLI.pm somehow
352
3531.6   Fri Jul 16 23:51:21 BST 2004
354    - Two very trivial fixes:
355    - Put ::Plain in the MANIFEST, so it actually ships this time
356    - Make CLI test == OK, not just true
357
3581.5   Mon Jun 21 14:36:54 BST 2004
359    - CLI mode correctly uses Constants module
360    - Template footers as well as headers (Markus Ramberg)
361    - Fix problems on failed object create (Jesse Sheidlower)
362    - Fix related() to deal with latest version of Class::DBI (Markus)
363    - Add sample CSS to distribution
364    - Maypole::Model::CDBI::Plain, for those who already have a CDBI set
365      of classes set up
366    - Friendlier errors when a template can't be found
367    - Don't authenticate without a model class
368    - #6569 Passing DBI options in setup() (Mickael Joanne)
369    - #6571 User-defined ok_tables: patch
370    - #6572 Makefile patch: require up-to-date CBDI::AsForm (Markus Ramberg)
371    - #6573 Set empty params to '' instead of undef (Jody Belka)
372    - #6617 Required cols patch in CDBI.pm (Jesse Sheidlower)
373
3741.4   Fri Apr 16 18:11:41 BST 2004
375    - Much, much more documentation
376    - CLI debugging mode
377    - CGI frontend (CGI::Maypole)
378    - Beginnings of a test suite
379    - Maypole::Constants module to remove dependency on Apache
380    - Refactoring of view classes to base/module-specific modules
381    - HTML::Mason view class
382    - Various small template bug fixes and enhancements
383
3841.3   Fri Mar 26 19:16:33 GMT 2004
385    - Fix serious order/CDBI::Page interaction bug.
386    - Die if model/view class can't be compiled.
387
3881.2   Thu Mar 25 12:35:21 GMT 2004
389    - Ensure safety when dereferencing any ->objects
390    - Support for the "frontpage" template
391    - Maypole itself no longer uses ->{ar}, which is now completely
392      refactored into the Apache::MVC class
393    - The beginnings of the documentation framework
394    - Support for paging and ordering in searches
395    - Stringify column changed from magic "name" to customizable
396      property
397    - Move BeerDB to ex/
398    - Fix SQLite dependency
399
4001.1   Wed Feb 25 10:29:25 GMT 2004
401    - Update CDBIL dependency
402    - Don't stringify to "name" if there isn't one
403    - Better support for authentication and template changes
404    - Full set of templates
405    - Allow passing of username and password to ->setup
406    - display_columns method
407
4081.0   Wed Feb 11 17:34:12 GMT 2004
409    - Renamed from Apache::MVC to Maypole.
410    - Clearer separation of model and view classes from controller
411    - Factoring out of Apache-specific code back into Apache::MVC
412
4130.2   Thu Feb  5 18:03:33 GMT 2004
414    - This release adds paging of list results and ordering by column
415      (ascending and descending)
416
4170.01  Thu Jan  8 15:50:17 2004
418	- original version; created by h2xs 1.22 with options
419		-AX -b 5.6.0 -n Apache::MVC
420
421