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