Zotero Notes

English

Zotero Notes inserts numbered citations and a references list on individual posts or pages. It retrieves bibliographic data through the Zotero API over HTTPS with TLS certificate verification.

Shortcode examples (the shortcode name can be changed in Settings):

• [zref]VP5PKI56[/zref]
• [zref name="source"]VP5PKI56[/zref]
• [zref name="source" /] (reuse a previously named reference)

Configure your Zotero user ID and, for private libraries, your API key under Settings > Zotero Notes. The key is kept server-side; leaving the key field blank when editing settings preserves the saved value. The plugin does not modify article content in the database and preserves the historical shortcode and option keys.

Cache and availability limitations

• First retrieval requires Zotero API access and a valid user ID (plus an authorized API key for private libraries). Without a previous successful retrieval, no fallback copy is available.
• Successful responses remain fresh for 12 hours by default (configurable between 1 and 168 hours). After expiry, the plugin attempts to refresh them.
• During temporary network or API failures, the last successfully retrieved response may be displayed. It can be outdated and does not guarantee that the reference is current or still exists in Zotero. After a temporary failure, retries are delayed (currently five minutes).
• HTTP 401, 403 and 404 responses do not trigger the stale fallback. A manual purge removes fresh and last-known-good copies; Zotero must then be reachable to retrieve those references again.
• Changes made in Zotero are not pushed to the plugin instantly. If Zotero is unavailable and no valid cached response exists, the reference cannot be rendered.

Français

Zotero Notes ajoute des appels de notes numérotés et une bibliographie à la fin des articles et pages consultés individuellement. Les références proviennent de l’API Zotero, interrogée en HTTPS avec vérification du certificat TLS.

Exemples de shortcodes (le nom du shortcode peut être personnalisé dans les réglages) :

• [zref]VP5PKI56[/zref]
• [zref name="source"]VP5PKI56[/zref]
• [zref name="source" /] (réutilisation d’une référence nommée)

Renseignez l’identifiant Zotero et, pour une bibliothèque privée, la clé API dans Réglages > Zotero Notes. La clé reste côté serveur et laisser son champ vide lors de la modification des réglages préserve la valeur enregistrée. L’extension ne modifie pas les contenus en base de données et conserve les shortcodes et options historiques.

Limites d’accès et de cache

• La première récupération nécessite un accès à l’API Zotero, un identifiant valide et, pour les bibliothèques privées, une clé autorisée. Sans récupération préalable réussie, aucune copie de secours n’est disponible.
• Les réponses restent fraîches pendant 12 heures par défaut (durée réglable entre 1 et 168 heures). Passé ce délai, l’extension tente une actualisation.
• En cas d’échec temporaire du réseau ou de l’API, la dernière réponse valide peut être affichée. Elle peut être périmée et ne garantit ni l’actualité ni la présence de la référence dans Zotero. Les nouveaux essais sont espacés (actuellement cinq minutes).
• Les réponses HTTP 401, 403 et 404 ne déclenchent pas le repli sur la dernière valeur. Une purge manuelle efface les copies fraîches et les copies de secours : un nouvel accès à Zotero sera alors nécessaire.
• Les changements effectués dans Zotero ne sont pas répercutés instantanément. Sans accès à Zotero ni réponse conservée valide, la référence ne peut pas être affichée.