NAME
    Mojolicious::Plugin::UrlWith - Preserve parts of the url

VERSION
    0.0501

DESCRIPTION
    This helper provides the same method as "url_for" in
    Mojolicious::Controller with the difference that it keeps the query
    string.

SYNOPSIS
        package MyApp;
        sub startup {
            my $self = shift;

            $self->plugin('Mojolicious::Plugin::UrlWith' => {
                parse_fragment => 1,
                current_page_class => 'current-page',
            });

            # ...
        }

ATTRIBUTES
  parse_fragment
    Will remove the '#fragment' part from the first arugment to "url_with",
    and use it use it for "fragment" in Mojo::URL.

  current_page_class
        $self->current_page_class($classname);
        $classname = $self->current_page_class;

    Will add the $classname to the link in "link_with" if the path part of
    the link match the currently requested path. You need to set this
    attribute when registering the plugin, since the default value is empty
    string, cancelling the behavior.

    This attribute is EXPERIMENTAL and may be removed/changed without
    warning.

HELPERS
  url_with
    The examples below has this current request url:
    "http://somedomain.com/search?page=1".

    $controller->url_with({ name => 'bob' });
        Will result in "http://somedomain.com/search?page=1&name=bob".

    $controller->url_with({ page => undef });
        Will result in "http://somedomain.com/search".

    $controller->url_with('named', { age => 42 });
        Will result in
        "http://somedomain.com/some/named/route?page=1&age=42".

    $controller->url_with('/path', { random => 24 });
        Will result in "http://somedomain.com/path?page=1&random=24".

    $controller->url_with('/path', [ c => 313 ]);
        Will result in "http://somedomain.com/path?c=313".

    Summary: A hash-ref will be merged with existing query params, while an
    array-ref will create a new set of query params.

  link_with
    Same as "link_to" in Mojolicious::Plugin::TagHelpers, but use "url_with"
    instead of "url_to" in Mojolicious::Controller to construct the hyper
    reference.

METHODS
  register
    Will register the methods under "HELPERS".

COPYRIGHT & LICENSE
    This library is free software. You can redistribute it and/or modify it
    under the same terms as Perl itself.

AUTHOR
    Jan Henning Thorsen

