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