NAME
    Apache::CookieToQuery - Rewrite query string by adding cookie
    information

SYNOPSIS
      In httpd.conf or similiar
 
      <Location /YourLocation>
            PerlAddVar IncludeCookie WSID
            PerlAddVar IncludeCookie SID
            PerlAddVar IncludeCookie QID
            PerlAddVar CookieAlias WSID:WebSiteId
            PerlAddVar CookieAlias QID:QueryId
            PerlFixupHandler Apache::CookieToQuery  
      </Location>

      Requests for http://yourhost/YourLocation?extra_params=12345

      Will now become rewritten so they look similiar to:

      http://yourhost/YourLocation?WebSiteId=<cookie WSID>;SID=<cookie SID>;QueryId=<cookie QID>;extra_params=12345

      Where <cookie WSID> for example is the value of cookie named WSID

DESCRIPTION
     This module will aid in adding cookie information to your query strings
     so that cgi scripts or handlers underneath can have immidate benefit

     It requires mod_perl + Apache web server with PERL_FIXUP callback hook enabled
     for more information on callback hooks refer to: 
     http://perl.apache.org/docs/1.0/guide/install.html#Callback_Hooks

     IncludeCookie specifies cookie names that will be added, if none are specified
     any cookie name is taken into consideration

     CookieAlias specifies cookie name to look for and cookie name to alias it with 
     when query string is rewritten, if alias for a cookie name does not exist, 
     original cookie name will be used 

     Please note that in the current implementation cookies always take precedence 
     over query string paramaters 

     This package should always be installed as PerlFixupHandler so that it can execute before
     standard PerlResponseHandler is called

BUGS
     If you find any, please let the author know

AUTHOR
            Alex Pavlovic
            CPAN ID: ALEXP
            alex-1@telus.net
        
COPYRIGHT
    Copyright (c) 2002 Alex Pavlovic. All rights reserved. This program is
    free software; you can redistribute it and/or modify it under the same
    terms as Perl itself.

    The full text of the license can be found in the LICENSE file included
    with this module.

SEE ALSO
    perl(1).

PUBLIC METHODS
    Each public function/method is described here. These are how you should
    interact with this module.

  handler

     Usage     : handler ( $apache ) 
     Purpose   : rewrites the query string of the original request
     Returns   : Server constant OK
     Argument  : apache instance