NAME

    Plack::Middleware::Matomo - a middleware to track usage information
    with Matomo

SYNOPSIS

        # in your bin/app.pl
    
        builder {
            enable "Plack::Middleware::Matomo",
                id_site => "my-service",
                base_url => "https://analytics.openaire.eu/piwik.php",
                token_auth => "secr3t",
                view_paths => ['record/(\w+)/*'],
                download_paths => ['download/(\w+)/*'],
                oai_identifier_format => 'oai:test.server.org:%s',
                ;
            $app;
        }
    
        # start your plack application with Twiggy as webserver
        $ plackup --server Twiggy bin/app.pl

CONFIGURATION

    id_site

      Required. The ID of the repository.

    base_url

      Required. The URL of the Matomo endpoint.

    auth_token

      Required. The authorization token.

    view_paths, download_paths

      One of these is required. Provide an array ref of regexes to match.

    oai_identifier_format

      Required. The format of the OAI identifier format of the repository.

    ua

      Set to 1 if user agent information should be passed to matomo.

    urlref

      Set to 1 if url referer should be passed to matomo.

DESCRIPTION

    Following the spec from
    https://developer.matomo.org/api-reference/tracking-api.

AUTHOR

    Vitali Peil <vitali.peil at uni-bielefeld.de>

COPYRIGHT

    Copyright 2019- Vitali Peil

LICENSE

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

SEE ALSO

    Plack::Middleware, Plack::Builder, Twiggy