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