Skip to content

Latest commit

 

History

History
73 lines (43 loc) · 1.67 KB

README.md

File metadata and controls

73 lines (43 loc) · 1.67 KB

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