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