Title: HAL
Author: Baptiste Blondelle
Published: <strong>juin 17, 2014</strong>
Last modified: février 11, 2026

---

Search plugins

![](https://ps.w.org/hal/assets/banner-772x250.png?rev=2695021)

![](https://ps.w.org/hal/assets/icon-128x128.jpg?rev=2695024)

# HAL

 By [Baptiste Blondelle](https://profiles.wordpress.org/friz/)

[Download](https://downloads.wordpress.org/plugin/hal.2.7.1.zip)

 * [Details](https://tah.wordpress.org/plugins/hal/#description)
 * [Reviews](https://tah.wordpress.org/plugins/hal/#reviews)
 *  [Installation](https://tah.wordpress.org/plugins/hal/#installation)
 * [Development](https://tah.wordpress.org/plugins/hal/#developers)

 [Support](https://wordpress.org/support/plugin/hal/)

## Description

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](https://hal.science).

## Screenshots

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

## Installation

#### Requirements:

 * 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.

#### Pages:

 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](https://doc.hal.science/afficher-une-liste-de-publications-dans-wordpress)
as well as our [documentation on HAL’s API](https://api.hal.science/docs/search).

#### Widget:

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

## FAQ

### How can I contact the support team?

You can contact the support team at the following email address: [hal.support[at]ccsd.cnrs.fr](https://tah.wordpress.org/plugins/hal/hal.support@ccsd.cnrs.fr?output_format=md).

### 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]**.

### cURL

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

## Reviews

![](https://secure.gravatar.com/avatar/af4a34335e54b44261fe0c5d4ec37bffdcba787b7aef77ed85be15cfc4497f1c?
s=60&d=retro&r=g)

### 󠀁[Un bon plugin, qui j’espère s’améliorera encore](https://wordpress.org/support/topic/un-bon-plugin-qui-jespere-sameliorera-encore/)󠁿

 [sympythy](https://profiles.wordpress.org/sympythy/) septembre 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é.

![](https://secure.gravatar.com/avatar/11f741ed1c420c05101ba9ef7f5310501a584e132db8fffa46417713ce89b3d5?
s=60&d=retro&r=g)

### 󠀁[Excellent plugin](https://wordpress.org/support/topic/excellent-plugin-1891/)󠁿

 [micheltam](https://profiles.wordpress.org/micheltam/) septembre 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 Hypotheses.org Le développeur est
réactif et prend en compte les demandes d’évolutions. Bravo Baptiste !

![](https://secure.gravatar.com/avatar/b3af610773bb628ad730f17b14e46d83a60954db5ff75c9b525eeb0deb046c4e?
s=60&d=retro&r=g)

### 󠀁[Intéressant mais lent](https://wordpress.org/support/topic/interessant-mais-lent/)󠁿

 [Blackbolt](https://profiles.wordpress.org/blackbolt/) septembre 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 ](https://wordpress.org/support/plugin/hal/reviews/)

## Contributors & Developers

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

Contributors

 *   [ Baptiste Blondelle ](https://profiles.wordpress.org/friz/)
 *   [ CCSD ](https://profiles.wordpress.org/ccsd/)

[Translate “HAL” into your language.](https://translate.wordpress.org/projects/wp-plugins/hal)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/hal/), check out the
[SVN repository](https://plugins.svn.wordpress.org/hal/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/hal/)
by [RSS](https://plugins.trac.wordpress.org/log/hal/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

2.7.1
 *Release Date – 11 Feb 2026

 * add possibility to display only one docment type. (thx to R.Trouville)

#### 2.7

*Release Date – Dec 2025

 * use new HAL API domain name
 * compat with WP 6.9

#### 2.6

*Release Date – Jun 2025

 * avoid warnings when empty response
 * compat with WP 6.8.0

#### 2.5

*Release Date – Sep 2024

 * handle API errors
 * avoid warning when updating array
 * test compatibility with WP 6.6.1

#### 2.4.2

*Release Date – Mar 2023

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

#### 2.4.1

_Release Date – Feb 2023_

 * update domain to hal.science
 * use citationFull_s instead of citationRef_s for the widget
 * fix english translation

#### 2.4

_Release Date – Nov 2022_

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

#### 2.3

_Release Date – July 2022_

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

#### 2.2.1

_Release Date – March 2022_

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

#### 2.2

_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

#### 2.1.1

_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

#### 2.1.0

_Release Date – December 2020_

 * compatibility with WordPress 5.6 RC tested
 * support for PHP 8.0 added
 * API call data caching using https://developer.wordpress.org/apis/handbook/transients/
   added
 * default type/id not mandatory when shortcode parameters indicated
 * documentation explaining the usage of [cv-hal] shortcode with parameters updated

#### 2.0.10

_Release Date – May 2020_

 * Pagination patch works, thanks to @yoannspace

#### 2.0.9

_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

#### 2.0.8

_Release Date – 25 March 2019_

Code:

 * Warning fixed for PHP 7.3

#### 2.0.7

_Release Date – 11 January 2019_

 * More precise date filter for last publications

#### 2.0.6

_Release Date – 28 September 2018_

 * Identifier authId_i added

#### 2.0.5

_Release Date – 14 February 2017_

Code:

 * Some code updated

#### 2.0.4

_Release Date – 3 February 2017_

Pages:

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

#### 2.0.3

_Release Date – 24 January 2017_

Pages:

 * CSS updated

#### 2.0.2

_Release Date – 07 December 2016_

Pages:

 * Libraries jQplot and PieRenderer loaded for the metadata Disciplines

#### 2.0.1

_Release Date – 28 July 2016_

General:

 * Minor bugs fixed

#### 2.0

_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

#### 1.4.4

_Release Date – 18 March 2016_

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

#### 1.4.3

_Release Date – 16 March 2016_

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

#### 1.4.2

_Release Date – 7 March 2016_

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

#### 1.4.1

_Release Date – 17 February 2016_

Pages:

 * Citation Full changed to Citation Ref (shorter)

Widget:

 * 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

#### 1.4

_Release Date – 9 February 2016_

Pages:

 * 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

Widget:

 * 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

#### 1.3

_Release Date – 21 January 2016_

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

#### 1.2

_Release Date – 15 January 2016_

 * Some bug fixes

#### 1.1

_Release Date – 7 September 2015_

 * Bootstrap deleted
 * New appearance for the plugin

## Meta

 *  Version **2.7.1**
 *  Last updated **2 mois ago**
 *  Active installations **500+**
 *  WordPress version ** 5.0 or higher **
 *  Tested up to **6.9.4**
 *  Language
 * [English (US)](https://wordpress.org/plugins/hal/)
 * Tags
 * [HAL](https://tah.wordpress.org/plugins/tags/hal/)[open science](https://tah.wordpress.org/plugins/tags/open-science/)
 *  [Advanced View](https://tah.wordpress.org/plugins/hal/advanced/)

## Ratings

 3.5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/hal/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/hal/reviews/?filter=4)
 *  [  1 3-star review     ](https://wordpress.org/support/plugin/hal/reviews/?filter=3)
 *  [  1 2-star review     ](https://wordpress.org/support/plugin/hal/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/hal/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/hal/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/hal/reviews/)

## Contributors

 *   [ Baptiste Blondelle ](https://profiles.wordpress.org/friz/)
 *   [ CCSD ](https://profiles.wordpress.org/ccsd/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/hal/)