NAME
   Mojolicious::Plugin::MethodOverride - Simulate HTTP Verbs

VERSION
   Version 0.020

SYNOPSIS
     package My::App;
     use Mojo::Base 'Mojolicious';

     sub startup {
       my $self = shift;

       $self->plugin('MethodOverride');

       ...
     }

     1;

DESCRIPTION
   This plugin can simulate any HTTP verb (a.k.a. HTTP method) in
   environments where HTTP verbs other than GET and POST are not available.
   It uses the same approach as in many other restful web frameworks, where
   it replaces the "HTTP POST" method with a method given by an "HTTP"
   header. It is also possible to define a query parameter for the same
   purpose.

   Any token built of US-ASCII letters is accepted as a valid value for the
   HTTP verb.

CONFIGURATION
   The default HTTP header to override the "HTTP POST" method is
   "X-HTTP-Method-Override". Overriding through a query parameter is off by
   default.

   These settings can be changed in the plugin method call as demonstrated
   in the examples below:

     # Mojolicious
     $self->plugin(
       MethodOverride => {
         header => 'X-Tunneled-Method',
         param  => 'x-tunneled-method',
       }
     );

     # Mojolicious::Lite
     plugin 'MethodOverride',
       header => 'X-HTTP-Method',
       param  => 'http_method';

   HTTP header can be disabled by setting to "undef":

     # A Mojolicious app, that enables method overriding
     # by query parameter only:
     $self->plugin(
       MethodOverride => {
         header => undef,
         param  => 'x-tunneled-method',
       }
     );

AUTHOR
   Bernhard Graf "<graf at cpan.org>"

BUGS
   Please report any bugs or feature requests to
   "bug-mojolicious-plugin-methodoverride at rt.cpan.org", or through the
   web interface at
   <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Mojolicious-Plugin-Metho
   dOverride>. I will be notified, and then you'll automatically be
   notified of progress on your bug as I make changes.

SEE ALSO
   Plack::Middleware::MethodOverride,
   Catalyst::TraitFor::Request::REST::ForBrowsers,
   HTTP::Engine::Middleware::MethodOverride,
   <http://code.google.com/apis/gdata/docs/2.0/basics.html>

LICENSE AND COPYRIGHT
   Copyright (C) 2012 Bernhard Graf.

   This library is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.

   See http://dev.perl.org/licenses/ for more information.