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