This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



This is the first (and as of today the only) WordPress plugin for the open archive HAL.

It will allow you to display on your blog publications associated with authors and other entities (structures, collections, research projects).

All data is fetched from the HAL’s website.


  • Global parameters for retrieving publications
  • Widget settings
  • Example of a page using a shortcode



  • PHP 7.0 or higher
  • WordPress 5.0 or higher
  • cURL extension in php.ini

Installation/update procedure:

  1. Desactivate the plugin if you have a previous version installed.
  2. Unzip the archive and put all files into a specific older in the directory /wp-content/plugins/, e.g. /wp-content/plugins/hal.
  3. Activate the plugin via Appearance/Plugins menu in WordPress admin panel.


  1. In WordPress admin dashboard, go to HAL and modify global parameters for retrieving publications on your blog page.
  2. Create your page and add the shortcode [cv-hal] to fetch data based on the criteria specified in the first step.

NB: you can directly add parameters to your shortcode, e.g. [cv-hal id=2497 type=structId_i].
For more information, please check the FAQ, our generic documentation as well as our documentation on HAL’s API.


In WordPress admin dashboard, go to Appearance/Plugins to configure the widget.


How can I contact the support team?

You can contact the support team at the following email address:[at]

How to insert data into my page?

Just create a page and put the shortcode [cv-hal] in your content. As simple as that.

What can I do to customize the content from within the shortcode?

You can add parameters to your shortcode, e.g. [cv-hal id=184 type=structId_i].

Supported identifiers:

  • IdHAL (sequence of characters) = authIdHal_s
  • Structure identifier (numeric) = structId_i
  • Collection identifier (sequence of characters) = collCode_s
  • ANR Project identifier (numeric) = anrProjectId_i
  • European Project identifier (numeric) = europeanProjectId_i

To retrieve contact information, add to the shortcode [cv-hal] the parameter contact taking the values yes and no, e.g. **[cv-hal contact=yes].

To display the number of documents, use the shortcode [nb-doc].


  • You need to enable the php_curl extension. Navigate to Apache/bin directory, open the php.ini file and uncomment ;extension=php_curl.dll.


September 29, 2021
Le plugin HAL permet très rapidement et simplement d’intégrer une bibliographie dans une page de son site Wordpress (depuis HAL), ainsi qu’une liste des dernières publications. J’espère qu’il évoluera en offrant plus de possibilités de configuration tout en gardant sa simplicité.
September 3, 2016 1 reply
Il serait sympa que ceux qui mettent de mauvaises notes tiennent compte des évolutions et des correctifs apportés au plugin qui est très intéressant et fonctionne très bien sur la plateforme de blogging scientifique Le développeur est réactif et prend en compte les demandes d’évolutions. Bravo Baptiste !
September 3, 2016 1 reply
Un plugin très intéressant. Toutefois deux petites critiques : – le chargement de la page est lent – les options d’affichage très réduites N.B. il nécessite une version récente de PHP (a priori 5.5 au moins)
Read all 4 reviews

Contributors & Developers

“HAL” is open source software. The following people have contributed to this plugin.


Translate “HAL” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



*Release Date – Mar 2023

  • update menu choice label and translation
  • added option to show only authors affiliated to organisation(when struct id provided)


Release Date – Feb 2023

  • update domain to
  • use citationFull_s instead of citationRef_s for the widget
  • fix english translation


Release Date – Nov 2022

  • authStructId_i is deprecated
  • build facet query according to the chosen options
  • update translation for new typology


Release Date – July 2022

  • update hal logo
  • AuthorID (authId_i) is not supported anymore (use idHal)
  • bug when using different permalink


Release Date – March 2022

  • href pagination using query strings
  • readme.txt updated
  • comments in constantes.php updated


Release Date – October 2021

  • menu displayed only when its items are selected
  • sanitizer added to the global settings form
  • strings escaped when echoing
  • constants, functions and classes renamed to avoid conflicts


Release Date – March 2021

  • translation corrected for some document types
  • research teams full list displaying fixed
  • unnecessary pagination button not displayed when the current page is the first or last one
  • checks added to avoid PHP notices
  • WP HTTP API used for HTTP requests


Release Date – December 2020

  • compatibility with WordPress 5.6 RC tested
  • support for PHP 8.0 added
  • API call data caching using added
  • default type/id not mandatory when shortcode parameters indicated
  • documentation explaining the usage of [cv-hal] shortcode with parameters updated


Release Date – May 2020

  • Pagination patch works, thanks to @yoannspace


Release Date – 6 December 2019

  • WP_PROXY* options can be used, all cURL calls now made in a sub
  • Warnings fixed
  • Some HTML code fixed
  • Other code reformatted


Release Date – 25 March 2019


  • Warning fixed for PHP 7.3


Release Date – 11 January 2019

  • More precise date filter for last publications


Release Date – 28 September 2018

  • Identifier authId_i added


Release Date – 14 February 2017


  • Some code updated


Release Date – 3 February 2017


  • Identifier types updated: structId_i for structures and authStructId_i for authors associated with a specific structure identifier


Release Date – 24 January 2017


  • CSS updated


Release Date – 07 December 2016


  • Libraries jQplot and PieRenderer loaded for the metadata Disciplines


Release Date – 28 July 2016


  • Minor bugs fixed


Release Date – 23 March 2016

  • Shortcode [nb-doc] for displaying the number of documents added
  • Possibility to display contact information for a researcher with an IdHAL


Release Date – 18 March 2016

  • Bug fix for publications having a DocType
  • Each DocType block has a CSS class, e.g. grp-div-ART


Release Date – 16 March 2016

  • Bug fix for metadata syncing with HAL
  • Bug fix for buttons using the theme Twenty Sixteen (CSS)


Release Date – 7 March 2016

  • cURL API request removed for DocType
  • New JSON repository with DocType created => performance improved


Release Date – 17 February 2016


  • Citation Full changed to Citation Ref (shorter)


  • You can now add parameters to the shortcode [cv-hal] (e.g. [cv-hal id=184 type=authStructId_i]), which will give you the possibility to retrieve different data on different pages. If no parameters given, global settings will be used
  • Bug fix for URL links in Metadata tabs
  • Performance improved


Release Date – 9 February 2016


  • Verification for cURL extension added to PHP config
  • Minor front-end updates for Publications
  • Translation added for DocType
  • DocType sorted alphabetically (e.g. ART, COMM, etc.)
  • Each item has a class or an identifier
  • You can add a stylesheet called cvhal.css to the CSS directory to override the plugin styles


  • Verification for cURL extension added to PHP config
  • New interface to personalize your widget: number of documents to show, display type (title or citation)
  • Multiple identifiers separated by commas allowed


Release Date – 21 January 2016

  • USER_AGENT set for cURL
  • Conditions added for calling the HAL’s API


Release Date – 15 January 2016

  • Some bug fixes


Release Date – 7 September 2015

  • Bootstrap deleted
  • New appearance for the plugin