Changes

   1 This file documents the revision history for Perl extension Maypole.
   2 For information about current developments and future releases, see:
   3     http://maypole.perl.org/?TheRoadmap
   4
   5
   6
   7 2.13 April 2008
   8 SVN Revision
   9
  10 Bug 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
  22 Improvements :
  23    link macro now takes a target argument, and has slightly better pod
  24
  25 2.121 29 August 2007
  26
  27 SVN revision 581
  28
  29 Bug 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
  36 2.12  22 June 2007
  37
  38 SVN revision 573
  39
  40 Bug 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
  56 API 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
  69 Internal 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
  75 2.111 Mon 30 April 2007
  76    - forked - see 2.111 changelog
  77
  78 2.11 Mon 31 July 2006
  79
  80 SVN revision 519
  81
  82 Deprecated:
  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
  93 Incompatible 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
 105 API 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
 146 Bug 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
 168 Documentation:
 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
 181 Requirements:
 182    HTTP::Body now required
 183    CGI::Untaint >= 1.26 now required rather than >= 0
 184
 185
 186 2.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
 201 2.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
 209 2.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
 220 2.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
 240 2.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
 246 2.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
 298 2.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
 305 2.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
 312 2.02  Mon Oct 25 13:00:00 2004
 313     - Fixed charset in http header.
 314     - replaced action links with forms in factory templates
 315
 316 2.01  Sun Oct 24 14:50:00 2004
 317     - documentation fix to make t/03podcoverage happy
 318
 319 2.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
 349 1.7   Sat Jul 17 20:15:26 BST 2004
 350     - Emergency release - we lost the "use Maypole::Constants" from
 351       CLI.pm somehow
 352
 353 1.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
 358 1.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
 374 1.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
 384 1.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
 388 1.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
 400 1.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
 408 1.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
 413 0.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
 417 0.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