Extension

Umami Analytics

Plugin Umami non officiel, sans lien avec Umami : trafic, pages les plus vues, sources de trafic et vues par entrée dans l'administration EmDash.

• Catégorie: analytics
• Statut: Disponible
• Version: 0.1.4
• Prix: Inconnu
• Source: Registre officiel de plugins
• Installation: Plugin isolé du registre
• Vérifié: 2026-10-21

Copier le lien Ouvrir dans Claude Ouvrir dans ChatGPT

Partager sur X Partager sur LinkedIn Partager sur Reddit

Description

Plugin non officiel. Il n’est ni affilié à Umami, ni approuvé ou pris en charge par Umami.

Affiche vos chiffres Umami dans l’administration EmDash : le trafic du site sur le tableau de bord, et les pages vues à côté des entrées qui les ont générées. Compatible avec Umami Cloud et avec un Umami auto-hébergé à partir de la version 3.4.0.

• Carte de trafic Umami. Sur le tableau de bord : visites, pages vues et engagement des sept derniers jours comparés à la semaine précédente, et les cinq pages les plus vues avec leurs entrées.
• Page Umami Analytics. Un graphique quotidien sur 7, 30 ou 90 jours, le taux de rebond et la durée des visites, les entrées les plus vues, les sources de trafic, les pays, les pages vues selon les données d’événement que votre site joint (par catégorie, pour commencer), et une vérification de la configuration qui indique la correction à apporter pour chaque problème détecté.
• Page par entrée. Chaque entrée publiée avec ses pages vues sur 7 et 30 jours, triables, pour une collection ou pour toutes, avec les traductions regroupées si vous le souhaitez.
• Panneau Umami dans l’éditeur. Les pages vues sur 7 et 30 jours de chaque entrée à côté de l’éditeur, et jusqu’où vont les lecteurs lorsque votre site envoie un événement de lecture.
• Outils MCP. Quatre outils en lecture seule qui répondent à partir des chiffres stockés.

Le plugin ne fait que lire. Il ne modifie jamais rien dans Umami ni dans votre contenu. Des données de démonstration permettent de l’essayer sans site Umami.

Il est testé avec un Umami 3.4.0 auto-hébergé. La connexion à Umami Cloud suit l’API publiée par Umami et n’a pas encore été testée avec un compte Cloud.

Basé sur le plugin analytics d’EmDash d’Eisbachcode, sous licence MIT.

Installation

Vous avez besoin de : EmDash 1.0.1 ou version ultérieure avec un exécuteur de bac à sable pour les plugins ; un site web dans Umami, avec le script de suivi d’Umami déjà installé sur votre site ; un Umami auto-hébergé 3.4.0 ou ultérieur (la première version auto-hébergée avec clés d’API) ou Umami Cloud ; et EMDASH_ENCRYPTION_KEY défini sur le site afin que la clé d’API puisse être enregistrée chiffrée (npx emdash secrets generate en génère une).

1. Installez le plugin depuis le registre et vérifiez ses autorisations : lire le contenu, lire le schéma et effectuer des requêtes réseau vers n’importe quel hôte public. Le plugin ne demande jamais que l’URL de l’API Umami définie dans ses réglages.
2. Dans Umami, créez un utilisateur avec le rôle View only. Ajoutez-le à l’équipe qui possède votre site web, avec le rôle d’équipe View only. Si le site vous appartient et n’appartient pas à une équipe, déplacez-le d’abord vers une équipe.
3. Connectez-vous à Umami avec cet utilisateur et créez une clé sous Settings > API keys.
4. Dans EmDash, ouvrez Plugins, puis les réglages de ce plugin. Collez la clé dans Umami API key.
5. Pour un Umami auto-hébergé, définissez Umami API URL sur https://your-host/api. La valeur par défaut est l’adresse d’Umami Cloud.
6. Saisissez l’ID de site web Umami indiqué dans les réglages du site dans Umami. Laissez-le vide et la carte du tableau de bord liste les sites que la clé peut voir, ce qui vous permet d’en copier un. Enregistrez.
7. Ouvrez Plugins > Umami Analytics et sélectionnez Check setup. Il passe en revue tout ce dont dépendent les chiffres et donne une phrase pour chaque problème.

Les premières synchronisations remontent jusqu’à Keep daily rows for (90 jours par défaut), en commençant par les plus récentes. Sous Node, cela prend environ deux heures pour un site de 100 entrées.

Chaque collection a besoin d’un modèle d’URL (sous Types de contenu), faute de quoi les pages ne peuvent pas être associées aux entrées. Sur Cloudflare Workers, la synchronisation nécessite le déclencheur Cron décrit dans le guide de déploiement d’EmDash.

Un Umami auto-hébergé doit avoir un nom d’hôte public : EmDash refuse les adresses privées ; localhost, une adresse de réseau local ou un nom accessible uniquement par VPN ne fonctionneront donc pas.

Pour utiliser les outils MCP, activez l’accès Agent pour le plugin sous Plugins. Réactivez-le après une mise à jour qui modifie un outil.

FAQ

Pourquoi tout affiche zéro ? La plupart des erreurs de configuration donnent des zéros sans message d’erreur. Ouvrez Plugins > Umami Analytics et sélectionnez Check setup : il indique la correction à apporter pour chaque problème détecté.

Pourquoi mes chiffres diffèrent-ils de ceux du tableau de bord d’Umami ? Les jours suivent le réglage Time zone : utilisez le fuseau horaire du site dans Umami, sinon les chiffres quotidiens diffèrent autour de minuit. Les pages sous /_emdash sont exclues, et les totaux ne comptent que les noms d’hôte listés dans Hostnames to count (l’URL de votre site et sa forme en www, sauf modification).

Fonctionne-t-il avec Umami Cloud ? Il suit l’API publiée par Umami, mais n’a pas encore été testé avec un compte Cloud. Merci de signaler vos constats dans les issues du dépôt.

Mon Umami se trouve derrière un proxy d’authentification. Laissez passer sans lui les huit points de terminaison de l’API Umami utilisés par le plugin. Le README les liste, et Umami vérifie la clé d’API sur chacun d’eux.

Combien de requêtes effectue-t-il ? Une synchronisation effectue au plus sept requêtes vers Umami. L’ouverture de la page Umami Analytics en effectue cinq.

Puis-je l’essayer sans Umami ? Oui. Définissez Data source sur Demo data et sélectionnez Refresh sur la carte du tableau de bord. Il génère 90 jours de trafic fictif sur vos vraies entrées. Changer de source de données efface tous les chiffres stockés, de sorte que les chiffres de démonstration ne se mélangent jamais aux vrais.

Qui peut voir les chiffres ? Les éditeurs et les administrateurs voient la carte du tableau de bord, les deux pages Umami et les outils MCP. Les auteurs voient le panneau de l’éditeur pour leurs propres entrées.

D’où viennent les tableaux par catégorie ? Des données d’événement que votre site joint à ses pages vues grâce au hook data-before-send du traceur Umami. Indiquez jusqu’à trois propriétés dans Views by event data. Un site qui n’en envoie aucune ne voit aucun tableau.

Comment fonctionne le taux de lecture ? Votre site envoie un événement personnalisé lorsqu’un lecteur atteint chaque profondeur d’une entrée, par exemple post_read avec post et depth. Renseignez les quatre réglages Read-through en conséquence. Ils sont vides par défaut, ce qui désactive la fonction.

Quelles langues parle-t-il ? L’anglais et l’allemand, selon la langue d’administration de chaque utilisateur.

Sécurité

Signalez un problème de sécurité en privé via le formulaire d’avis de sécurité du dépôt : https://github.com/shanelord01/emdash-umami-analytics/security/advisories/new

Ce que peut faire la clé d’API Umami

Une clé d’API Umami n’a aucune autorisation propre. Elle peut faire tout ce que peut faire l’utilisateur qui l’a créée. Une clé créée sous un utilisateur administrateur pourrait modifier ou supprimer tous les sites de votre Umami ; créez-la donc sous un utilisateur au rôle View only, ajouté à l’équipe du site avec le rôle d’équipe View only. Une clé créée ainsi peut lire les sites de cette équipe et ne rien modifier. Le plugin lui-même n’envoie que des requêtes GET.

Accès réseau

Le plugin demande network:request:unrestricted, car un Umami auto-hébergé se trouve sur un hôte que vous saisissez dans les réglages, qu’aucune liste fixe d’hôtes ne pourrait nommer. Il ne demande jamais que l’URL de l’API Umami définie dans ses réglages (https://api.umami.is/v1 sauf modification), avec la clé comme jeton Bearer. Les données de démonstration n’effectuent aucune requête. EmDash refuse les adresses privées pour tous les plugins.

Ce qui est envoyé et ce qui est stocké

• Umami reçoit la clé d’API, l’ID du site web et les noms d’hôte à compter. Rien de votre contenu ne quitte le site.
• La clé est enregistrée comme réglage chiffré (AES-GCM avec EMDASH_ENCRYPTION_KEY). Sans cette clé, EmDash refuse de l’enregistrer plutôt que de la stocker en clair. Le plugin ne l’écrit jamais dans ses journaux.
• La base de données du site contient les pages vues et les visites par jour et par chemin, les totaux du site et l’engagement par jour, la correspondance de chaque chemin avec son entrée, avec les nombres de vues et le taux de lecture de cette entrée, ainsi que l’état de la synchronisation avec les pages, sources de trafic et pays les plus importants de la dernière semaine. Les lignes quotidiennes plus anciennes que Keep daily rows for sont supprimées.

Qui peut faire quoi

La carte du tableau de bord, les pages Analytics et Par entrée et les outils MCP nécessitent le rôle d’éditeur. Le panneau de l’éditeur nécessite le rôle d’auteur et n’affiche que les entrées que l’utilisateur peut modifier. La modification des réglages nécessite le rôle d’administrateur.

Journal des modifications

0.1.4

• Les pages sont regroupées dans un seul dossier Umami dans la barre latérale (Analytics, Per entry) sur EmDash 1.2 et ultérieur. Leurs adresses sont inchangées, et les versions plus anciennes d’EmDash les listent une par une.
• Aucune nouvelle autorisation et aucun changement des outils MCP.

0.1.3, 9 octobre 2026

• Les jours suivent votre fuseau horaire. Ils correspondaient auparavant à des jours UTC, si bien qu’une page vue avant environ 10 h à Sydney était comptée la veille. Le nouveau réglage Time zone est initialisé à Australia/Sydney. Définissez le fuseau du site web dans Umami.
• Lors de la mise à jour, les chiffres stockés sont effacés une fois puis relus depuis Umami, en commençant par les plus récents. Les graphiques et les vues par entrée se remplissent pendant le rattrapage : environ deux heures pour 90 jours et 100 entrées sous Node, au rythme du déclencheur Cron sur Cloudflare Workers. Modifier ce réglage plus tard produit le même effet.
• Nommés d’après Umami pour ne pas être confondus avec ceux d’un autre plugin : les pages Umami Analytics et Umami per entry (mêmes adresses), la carte de trafic Umami et le panneau Umami dans l’éditeur.
• La page du registre comporte des onglets, dont ce journal des modifications, et une bannière.
• Corrections de l’administration : plus de faux « aucune page n’est associée », les pages principales du tableau de bord couvrent ses 7 jours, le graphique quotidien nomme sa série, et le panneau de l’éditeur indique le jour où commence son historique stocké.
• Aucune nouvelle autorisation. Les outils MCP décrivent désormais leurs jours dans votre fuseau horaire ; EmDash désactive donc l’accès Agent après la mise à jour. Réactivez-le sous Plugins.

0.1.2, 1er octobre 2026

• L’engagement à côté des totaux : taux de rebond, visite moyenne et pages par visite comparés à la période précédente, et un nouveau champ engagement dans site_totals.
• Taux de lecture par entrée (quatre réglages, désactivé par défaut) et deux nouveaux points de terminaison Umami utilisés uniquement lorsqu’il est activé. Rattrapage plus rapide après l’installation.
• Réactivez l’accès Agent sous Plugins après la mise à jour.

Historique complet : CHANGELOG.md.