README

PIRUS 'PUSH' implementation
    Provide data for COUNTER-compliant usage statistics.

    Copyright 2012 University of Southampton

    Released to the public domain (or CC0 depending on your juristiction).

    USE OF THIS EXTENSION IS ENTIRELY AT YOUR OWN RISK

  Installation
    Copy this file into your repository's cfg.d/ directory and restart
    Apache.

  Implementation
    This code will PING the configured tracker server whenever a full-text
    object is requested from EPrints.

    These pings can be aggregated together with data from other sources
    (publishers, other repositories) to create a fuller picture of the usage
    of individual articles.

    The data transferred are:

            - eprint.eprintid - the eprint's internal identifier
            - eprint.datestamp - the datetime the access started
            - IP address - the user's IP address
            - User Agent - the user's browser user agent
            - eprint.date - the publication date

    And either (if id_number is defined):

            - eprint.id_number - the DOI

    Or:

            - eprint.creators_name - first named author
            - eprint.title - eprint title
            - eprint.jtitle - publication title
            - eprint.issn - publication ISSN
            - eprint.volume - publication volume
            - eprint.issue - publication issue

  Changes
	1.04 Tim Brody <tdb2@ecs.soton.ac.uk>

	Set svc_format to mime_type (was commented out???)
	Set svc_dat to the requested URL (works only for live)

	1.03 ???

	???

    1.02 Justin Bradley <jb4@ecs.soton.ac.uk>

    Compatibility fixes for 3.2.

    1.01 Tim Brody <tdb2@ecs.soton.ac.uk>

    Fixed reference to 'jtitle' instead of 'publication'

    1.00 Tim Brody <tdb2@ecs.soton.ac.uk>

    Initial version