Vitali Peil
and 3 contributors

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