Plugin Lightroom Classic

Le plugin Helpho pour Lightroom Classic te permet de publier tes galeries directement depuis ton flux de retouche, sans aller sur helpho.io. Compatible Mac et Windows, inclus gratuitement dans tous les plans Pro.

Ce que tu peux faire avec le plugin

• Publier depuis LR : crée une *Collection publiée* = une galerie Helpho. Glisse tes photos sélectionnées dedans, clic *Publier* → tout arrive sur Helpho avec les bons clients et sections.
• Ré-uploader / supprimer : modifie une photo dans LR, republie-la, l'ancienne version est remplacée côté Helpho.
• Récupérer les sélections : quand ton client coche ses photos préférées sur la galerie, lance la synchro depuis le menu Library. Les photos sélectionnées reçoivent un label rouge (à retoucher), les favoris un label jaune dans ton catalogue Lightroom.
• Récupérer les autorisations de publication : quand ton client a validé quelles photos il t'autorise à publier (droit à l'image), récupère-les dans LR avec un label vert + des mots-clés par usage (réseaux sociaux, site web…) pour filtrer et exporter en un clic ce que tu as le droit de publier.

Installation (5 minutes)

1. Télécharge le plugin

Va sur [helpho.io/lightroom](https://www.helpho.io/lightroom) et clique Télécharger le plugin. Tu obtiens un fichier helpho-lightroom-plugin-X.Y.Z.zip. Décompresse-le où tu veux sur ton disque (ex. ~/Documents/Lightroom Plugins/).

2. Génère ton token API

Sur Helpho, va dans Paramètres → API & plugin Lightroom. Clique Créer un token, donne-lui un nom (« Lightroom MacBook Pro » par exemple). Copie le token immédiatement — il ne sera plus jamais réaffiché.

3. Ajoute le plugin dans Lightroom

Dans Lightroom Classic, ouvre Fichier → Gestionnaire de modules externes… (raccourci ⌥⇧⌘, sur Mac, Ctrl+Alt+Shift+, sur Windows). Clique Ajouter en bas à gauche et sélectionne le dossier helpho.lrplugin. Le plugin apparaît dans la liste, état *Activé*. Ferme le gestionnaire.

4. Connecte ton compte

Dans le module Bibliothèque, panneau gauche Services de publication, clic-droit sur Helpho → Configurer…. Colle ton token dans le champ « Token API », clique Tester la connexion : tu dois voir « Connexion OK » en vert. Valide.

5. Publie ta première galerie

• Clic-droit sur Helpho dans Services de publication → Créer une collection publiée
• Choisis Créer une nouvelle galerie, sélectionne le client, le type d'événement, valide
• Glisse tes photos dans la nouvelle collection
• Bouton Publish en haut → c'est parti

La galerie est créée sur Helpho au premier publish. Tu peux la retrouver dans Galeries sur helpho.io, ou directement depuis le clic-droit sur la collection LR → *Voir la galerie sur helpho.io*.

Synchroniser les sélections client

Quand ton client a fait son tri (coché ses photos préférées sur la galerie), reviens dans Lightroom :

1. Menu Bibliothèque → Module externe — Extras → Helpho : synchroniser les sélections clients

2. Le plugin parcourt toutes tes galeries publiées et applique les labels :

- Rouge = photo cochée (à retoucher)

- Jaune = photo favorisée

3. Filtre ton catalogue par label rouge → tu n'as plus qu'à retoucher

Récupérer les autorisations de publication

Si tu utilises le consentement d'usage sur tes galeries (le client autorise ou refuse la publication de chaque photo — réseaux sociaux, site web, plaquette…), plus besoin de repointer les tout petits statuts photo par photo dans Helpho pour retrouver ce que tu as le droit de publier. Le plugin te ramène tout ça directement dans Lightroom.

1. Menu Bibliothèque → Module externe — Extras → Helpho : récupérer les autorisations de publication

2. Pour chaque galerie publiée, le plugin pose sur les photos autorisées à la publication :

- un label vert → tri visuel immédiat (le vert ne rentre pas en conflit avec le rouge/jaune des sélections)

- des mots-clés hiérarchiques Helpho — Autorisé publication ▸ Réseaux sociaux, ▸ Site web… (un mot-clé par usage autorisé)

3. Filtre ton catalogue par le mot-clé Helpho — Autorisé publication (ou par un usage précis), ou crée une collection dynamique dessus → tu n'exportes que les photos que tu as le droit de publier, par réseau. Gérable même sur une galerie de plusieurs centaines d'images.

🔒 Sécurité par défaut. Une photo n'apparaît que si le client l'a explicitement autorisée. Dès qu'un usage est refusé (par n'importe quel destinataire de la galerie), il est exclu. Une photo absente = à ne pas publier.

↻ Synchro additive. La récupération ajoute des labels/mots-clés mais n'en retire pas : si un client révoque une autorisation après coup, relancer la synchro ne l'enlèvera pas automatiquement. En cas de doute, Helpho (la galerie) reste la source de vérité — le plugin est un accélérateur de tri.

Mettre à jour le plugin

Quand on publie une nouvelle version du plugin, tu reçois une notification directement dans Lightroom Classic. Voici comment l'installer sans perdre tes galeries, tes services de publication, ni ton token API.

1. Tu es notifié dans Lightroom

Au lancement du Gestionnaire de modules externes → Helpho, un bandeau coral apparaît si une nouvelle version est disponible :

✨ Nouvelle version disponible : 0.3.0

Télécharge le nouveau .lrplugin, remplace l'ancien dossier au même endroit, puis clique « Reload Plug-in » ci-dessous. Tes services, galeries et tokens sont conservés (rien à reconfigurer).

Clique Télécharger la mise à jour — ton navigateur ouvre helpho.io et le téléchargement démarre.

2. Remplace le dossier du plugin (et c'est tout)

• Dézippe le nouveau helpho-lightroom-plugin-X.Y.Z.zip
• Repère où se trouve l'ancien helpho.lrplugin (probablement dans ~/Documents/Lightroom Plugins/ ou là où tu l'avais placé). Tu peux le vérifier dans Gestionnaire de modules externes → Helpho → onglet État qui affiche le chemin complet.
• Remplace le dossier helpho.lrplugin par le nouveau. Pas besoin de désinstaller le plugin dans Lightroom.

3. Recharge le plugin

Dans Gestionnaire de modules externes :

• Sélectionne Helpho dans la liste à gauche
• Clique Recharger le module externe (bouton en bas à droite, raccourci Cmd+R / Ctrl+R)

Le plugin redémarre instantanément. Tu n'as rien à reconfigurer :

• Le service « Helpho » dans le panneau Services de publication est intact
• Toutes tes galeries publiées (collections) sont intactes
• Ton token API est conservé
• Le mapping photo → galerie Helpho est préservé

Pourquoi ça fonctionne sans perte

Lightroom identifie chaque plugin par son identifiant unique (io.helpho.lightroom). Cet identifiant ne change jamais entre les versions, donc Lightroom comprend que le « nouveau » Helpho est le même que l'ancien — juste avec du code mis à jour. C'est exactement la même logique que quand tu mets à jour Lightroom lui-même : tes catalogues ne sont pas perdus.

⚠️ Ne désinstalle pas pour mettre à jour. Si tu fais Supprimer dans le Gestionnaire avant de remettre la nouvelle version, Lightroom peut perdre la trace du service de publication (les collections deviennent orphelines). Utilise toujours la méthode « remplace + recharge » décrite ci-dessus.

Désinstaller / Désactiver

• Pour désinstaller : dans le Gestionnaire de modules externes, sélectionne Helpho → clique Supprimer. Le plugin est retiré ; tes photos déjà publiées restent côté Helpho.io mais le service Lightroom est perdu (tu devras tout reconfigurer si tu réinstalles plus tard).
• Pour désactiver temporairement sans supprimer : décoche Activé dans le Gestionnaire. Tu pourras réactiver plus tard sans rien perdre.
• Pour révoquer ton token : Paramètres → API & plugin Lightroom → Révoquer. Le plugin cessera de fonctionner immédiatement (mais reste installé — il suffira de coller un nouveau token pour le réactiver).

🔄 Pour une mise à jour, ne désinstalle pas. Suis la section « Mettre à jour le plugin » ci-dessus.

Problèmes courants

« Token invalide ou expiré »

Ton token a peut-être été révoqué. Génère-en un nouveau dans Paramètres → API et reconnecte ton service Lightroom.

« Création de la galerie Helpho échouée »

Vérifie que tu as bien un client sélectionné dans le dialog. Si l'erreur persiste, ton plan Pro est peut-être expiré.

« Le plugin ne s'affiche pas dans Services de publication »

Sors et relance Lightroom Classic après installation. Si toujours absent, vérifie dans le Gestionnaire de modules externes que l'état est bien *Activé*.

Mode debug

Pour diagnostiquer un souci, active le mode debug dans Gestionnaire de modules externes → Helpho. Les logs détaillés iront dans ~/Documents/LrClassicLogs/Helpho.log (Mac) ou le dossier équivalent Windows.

Limites V1

• Pas de drag-and-drop direct sur une section précise (toutes les photos arrivent à la racine de la galerie pour l'instant)
• Pas de gestion des virtual copies (chaque copie est publiée comme une photo séparée)
• Upload séquentiel (1 photo à la fois) — sur une galerie de 500 photos compte ~15 min

Ces points seront améliorés dans les prochaines versions.