EPrints Technical Mailing List Archive

See the EPrints wiki for instructions on how to join this mailing list and related information.

Message: #10311

< Previous (by date) | Next (by date) > | < Previous (in thread) | Next (in thread) > | Messages - Most Recent First | Threads - Most Recent First

Re: [EP-tech] Altmetric plugin - API key soon to be made mandatory

Please see the upgrade instructions on the GitHub readme - https://github.com/eprintsug/altmetric/blob/main/README.md

These changes and readme update were written by John Salter. So, if you are still having problems after looking the readme it is best direction questions towards him.  Basically, Altmetric were forced to enforce API keys as they have been hammered by ai crawlers.


From: eprints-tech-request@ecs.soton.ac.uk <eprints-tech-request@ecs.soton.ac.uk> on behalf of Tomasz Neugebauer <Tomasz.Neugebauer@concordia.ca>
Sent: Thursday, January 8, 2026 5:40:31 pm
To: eprints-tech@ecs.soton.ac.uk <eprints-tech@ecs.soton.ac.uk>
Subject: Re: [EP-tech] Altmetric plugin - API key soon to be made mandatory

CAUTION: This e-mail originated outside the University of Southampton.
CAUTION: This e-mail originated outside the University of Southampton.
Hi everyone!  I'm back from sabbatical at the office, and trying to get through all of the repository issues that have been waiting for me while I was away.  Thanks to John for this work on the Altmetric plugin.  I was about to upgrade ours to the one from the Bazaar (https://bazaar.eprints.org/1300/), but strange thing is happening in that I don't see Altmetric plugin from within our repository "Bazaar" admin.  Any idea why that would be?  I was thinking I would install it right from the Bazaar, but it's just not showing up. Strange. Other plugins are there, but not this one.

Tomasz


________________________________________________

Tomasz Neugebauer
Senior Librarian | Bibliothécaire titulaire
Digital Projects & Systems Development Librarian / Bibliothécaire des Projets Numériques & Développement de Systèmes
Concordia University / Université Concordia

Tel. / Tél. 514-848-2424 ext. / poste 7738
Email / courriel: tomasz.neugebauer@concordia.ca

Mailing address / adresse postale: 1455 De Maisonneuve Blvd. W., LB-540-03, Montreal, Quebec H3G 1M8
Street address / adresse municipale: 1400 De Maisonneuve Blvd. W., LB-540-03, Montreal, Quebec H3G 1M8

library.concordia.ca

From: eprints-tech-request@ecs.soton.ac.uk <eprints-tech-request@ecs.soton.ac.uk> on behalf of John Salter <J.Salter@leeds.ac.uk>
Sent: October 30, 2025 12:03 PM
To: eprints-tech@ecs.soton.ac.uk <eprints-tech@ecs.soton.ac.uk>
Subject: RE: [EP-tech] Altmetric plugin - API key soon to be made mandatory
 

Attention This email originates from outside the concordia.ca domain. // Ce courriel provient de l'extérieur du domaine de concordia.ca




CAUTION: This e-mail originated outside the University of Southampton.
CAUTION: This e-mail originated outside the University of Southampton.

Hi All,
I’ve made a new version of the Altmetric plugin.

 

It’s available as:

- an ingredient (currently https://github.com/eprintsug/altmetric/tree/v2, although this branch will be merged into the 3_4 branch)

- an EPM (https://github.com/eprintsug/altmetric/blob/main/altmetric.epm).

 

If any of you are in a position to test this, you will need to install the new version, and then refresh abstracts.

If you don’t have an Altmetric API key, the badges will now be displayed via the Altmetric ‘embed’ _javascript_.

 

There is info in the z_altmetric.pl file about options for both the API-based and embed badges.

 

  • If you have an API key, you will be able to customise the phrases/metrics displayed.

The text e.g. ‘3 facebook pages’ now use EPrints phrases, so the plugin now supports internationalisation/multi-lingual repositories better.

Thie requires an API key.

 

  • If you have a custom altmetric.css or 99_altmetric.js files, these may need to be removed/re-synced with the new versions.

 

If it seems to work OK for anyone who tests it, I will add the EPM to the Bazaar, and merge v2 into the 3_4 branch.

 

Any comments/feedback welcome.

Cheers,

John

 

PS The API key will become mandatory on the 10th November – if you haven’t updated by then, your Altmetrics badges may disappear.

 

From: eprints-tech-request@ecs.soton.ac.uk <eprints-tech-request@ecs.soton.ac.uk> On Behalf Of John Salter
Sent: 22 October 2025 13:37
To: 'eprints-tech@ecs.soton.ac.uk' <eprints-tech@ecs.soton.ac.uk>
Subject: [EP-tech] Altmetric plugin - API key soon to be made mandatory

 

CAUTION: External Message. Use caution opening links and attachments.

CAUTION: This e-mail originated outside the University of Southampton.

CAUTION: This e-mail originated outside the University of Southampton.

Hi,
I’ve been contacted by the Altmetric team, as there will soon (10th November) be a change to their API, to require an API key.

 

If you use the Altmetric plugin, and haven’t already configured an API key, you will need to either:

  • register for an API key and add it to your configuration
  • change to using the embedded version of the badges.

 

I’ve put some details here: https://wiki.eprints.org/w/Altmetric_badges

 

Altmetric ran a test of this change this morning, and I checked a few repositories. If there isn’t an API key configured, an error message is displayed, although this doesn’t indicate that it’s an API key issue.

 

A new version of the plugin will be released (which also has other changes in it to improve accessibility and internationalisation).

This will use the existing API-based display if a key has been configured, and fall back to the embedded version if not.

 

This will be advertised here when released.

 

Cheers,

John

 

John Salter

https://orcid.org/0000-0002-8611-8266

 

White Rose Libraries Technical Officer
Library and Research Management team, IT
University of Leeds