Aide du plugin Publesia pour SPIP

Introduction

Publesia est un plugin de SPIP permettant de faire la liaison entre un site sous SPIP et une instance de Publesia.

Ce plugin permet d'afficher sur une page une requête vers cette instance de Publesia. On peut par exemple faire afficher toutes les publications d'un auteur, toutes les publications d'un certain laboratoire ou pôle entre une année donnée et une autre.

Ce plugin permet également de contrôler l'apparence de l'affichage des ces publications en permettant d'ajouter des CSS, du Javascript personnalisé, jouer sur la pagination etc...

Le modèle

Pour afficher des publications issues d'une requête vers une instance de Publesia dans un article ou une rubrique, il faut invoquer le modèle fourni par le plugin de la façon suivante :

Voiçi une liste des paramètres disponible pour ce modèle :

• nom_auteur : Nom de famille de l'auteur recherché
• prenom_auteur : Prénom de l'auteur recherché
• nom : Nom complet de l'auteur recherché
• id_auteur : id_auteur dans l'instance de Publesia de l'auteur recherché
• mail_auteur : Courriel de l'auteur recherché
• annee_debut : Année de début de la recherche
• annee_fin : Année de fin de la recherche
• id_publication : Recherche d'une publication par son identifiant dans l'instance de Publesia
• pole : Pole où rechercher les publications
• affiliation : Recherche des publications affiliées à un laboratoire où l'on recherche "affiliation" dans son sigle, nom, adresse, ou bien l'origine de l'affiliation telle qu'elle était lorsque l'on a importé la publication dans Publesia.
• id_labo : identifiant du laboratoire d'origine dans l'instance de Publesia
• type_publi : Type de publications recherchées (ACL, SCL, etc...). Plusieurs types peuvent être spécifiés, séparés par des virgules, exemple : ACL,SCL
• resultats : Nombre de résultats maximum
• auteurs_cliquables : Lors de l'affichage, les auteurs sont cliquable. Si la valeur de ce paramètre est "publesia" , le lien est celui d'une page de l'instance de Publesia où sont affichées toutes ses publications. S'il a la valeur "ldap" et que la configuration de l'instance de Publesia est correctement renseignée, les liens sous les auteurs renvoient à leur page web, qu'ils ont renseignée grâce à l'annuaire LDAP de leur institution/organisation. Dans ce cas, les chercheurs n'ayant pas renseigné leur page web ne seront pas cliquables. Enfin, pour avoir en priorité la page web du chercheur si elle est connue et sinon un lien vers l'instance de Publesia, il faut donner au paramètre la valeur "oui".
• page : Nombre de résultats par page
• trier : Les résultats doivent être triés suivant les champs spécifiés. Plusieurs champs peuvent être spécifiés par ordre d'importance décroissant. Le caractère "!" placé devant le nom du champ spécifie que l'on veut un tri par ordre du champ décroissant. Exemple : !annee,titre organise les publications retournées par ordre d'années décroissant, puis par titre par ordre alphabétique croissant.
  Voir ci-dessous pour connaître les champs que l'on peut trier...
• resume : Affiche ou omet le résumé. La valeur oui affiche le résumé dans tous les cas. non empêche l'affichage du résumé. Si ce paramètre est omis, le résumé n'est affiché que si l'usager clique sur un bouton pour le déplier ou le replier.
• style : Affiche le résultat selon un style pré-défini. L'unique style pré-défini est pour le moment acs, permettant un affichage comme spécifié sur cette page.

Par défaut, les champs suivants sont affichés (dans cet ordre) :

• Le titre
• Le code du type de publication
• Le ou les auteurs de la publicatin
• L'année de parution
• Un permalien vers la publication
• Le Résumé
• Numéro de référence DOI
• Numéro de référence ADS
• Numéro de référence HAL

Mais si jamais dans le modèle ou dans la balise, on renseigne le champ "field", on peut controler totalement les champs affichés et leur ordre d' affichage dans la page. Les champs disponibles sont les suivants :

titre

Titre

titre_ouvrage

Titre de l'ouvrage

annee

Année

titre_conference

Titre de la conférence

lieu_conference

Lieu de la conférence

date_conference

Date de la conférence

numero

Numéro

volume

Volume

editeur

Éditeur

editeur_scientifique

Éditeur scientifique

mention_edition

Mention de l'éditeur

collection

Collection

specialite

Spécialité

code_these

Code de la thèse

ref_doi

Référence DOI

ref_ads

Numéro ADS

ref_wos

Numéro Web of Science

ref_hal

Numéro HAL (archives-ouvertes)

ref_arxiv

Numéro ArXix

code_type

Code du type de document

nom_type

Type de document

nom_revue

Nom de la revue

auteur

L'auteur ou les auteurs

type_these

Type de la thèse

nom_univ

Nom de l'université

resume

Résumé

permalink

Permalien

date_modification

Date de modification

Pour sélectionner les champs que vous voulez afficher, le paramètre "fields" s'écrit par exemple comme ceci :

fields=auteur,annee,resume,permalink

Pour contrôler l'affichage, les paramètres sont :

• resultats : Nombre maximal de résultats retournés
• lang : Langue d'affichage du nom des champs et de la pagination
• charset : Encodage des résultats (par défaut : UTF-8)
• page : Nombre maximal de publications affichées à la foi sur une mêmpage
• css : Spécification d'une CSS additionnelle pour modifier l'affichage des publications
• js : Spécification d'un script JS additionnel

Exemple :

<publesia0|id_auteur=10603|lang=en|page=6|css=pmmh.css>

La balise

Cette balise s'utilise dans une squelette avec exactement les mêmes paramètres que le modèle. Exemple :

Petite précision, cette balise, comme le modèle qui l'utilise, n'est réactualisée qu'une fois par heure. C'est à dire que si les données de la base de l'instance de Publesia ont été modifiées, les résultats de la balise et du modèle ne le seront qu'une fois ce délai écoulé.

Note d'installation

Ce plugin fonctionne avec les fonctions APC de PHP. Il est donc impératif que le module APC soit disponible sur les serveur web.