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