PIXMARO Documentation / Lightroom Classic plugin

📷 Lightroom Classic plugin

Publish your photos straight from Lightroom, and pull your clients' choices back into your catalogue.

Translation in progress
This page has not been translated into your language yet. It is shown to you in French.

What the plugin does

Le plugin relie Lightroom Classic à votre PIXMARO. Vos photos partent de votre catalogue et arrivent dans la galerie de votre client sans passer par le navigateur — et les choix de votre client reviennent dans votre catalogue de la même façon.

Les deux gains

Sans le pluginAvec le plugin
PublierExporter sur le disque, ouvrir le navigateur, glisser les fichiers, attendre.Glisser les photos dans une collection, cliquer sur Publier.
Récupérer la sélectionLire la liste des noms, les retrouver une à une dans le catalogue.Une commande, et les photos choisies sont notées et marquées dans Lightroom.
Qui prépare les imagesVotre serveur.Votre ordinateur.
Good to know

Ce dernier point compte plus qu'il n'y paraît. Lorsque vous publiez depuis Lightroom, c'est lui qui applique le format, la qualité et les dimensions ; PIXMARO stocke les fichiers tels quels, sans les retraiter. Votre serveur ne fait aucun travail d'image — sauf si vous appliquez un filigrane, qui reste à sa charge. Les gros lots en deviennent nettement plus fiables sur un hébergement modeste.

Careful

Le plugin fonctionne avec Lightroom Classic. Il n'est pas compatible avec Lightroom (l'application cloud d'Adobe, anciennement Lightroom CC), qui n'accepte pas les plugins d'exportation.

Installing the plugin in Lightroom Classic

  1. Dans PIXMARO, allez dans Paramètres → Lightroom et téléchargez le plugin.
  2. Décompressez l'archive. Vous obtenez un dossier PIXMARO.lrplugin.
  3. Rangez-le à un endroit définitif — vos documents, par exemple. Lightroom garde le chemin : si vous le déplacez ensuite, le plugin cesse d'être trouvé.
  4. Dans Lightroom : menu Fichier → Gestionnaire de modules externes.
  5. Cliquez sur Ajouter, désignez le dossier PIXMARO.lrplugin, validez.
  6. Le plugin apparaît dans la liste, avec sa version.
Careful

Sur macOS, le dossier .lrplugin ressemble à un fichier unique. C'est normal : désignez-le tel quel, sans chercher à entrer dedans.

Connecting the plugin to your PIXMARO

Le plugin ne sait pas encore à quel PIXMARO parler. Deux informations à lui donner, toutes deux dans Paramètres → Lightroom, avec un bouton de copie.

  1. Dans Lightroom, ouvrez le module Bibliothèque et repérez le panneau Services de publication, en bas à gauche.
  2. Trouvez PIXMARO et cliquez sur Configurer.
  3. Collez l'URL de l'API — l'adresse de votre PIXMARO suivie de /api/.
  4. Collez la clé d'API.
  5. Enregistrez. Le plugin vérifie la connexion et vous le confirme.

Les autres réglages du service

RéglageCe qu'il fait
Délai entre les envoisUne pause entre chaque photo : aucune, 0,5 s, 1 s ou 2 s. Laissez « aucune ». Ne l'augmentez que si votre hébergement limite le nombre de requêtes et rejette les envois rapides.
Synchroniser les sélectionsAutorise le rapatriement des choix de votre client dans le catalogue.
Ouvrir la page client après publicationOuvre la galerie dans votre navigateur dès la fin de l'envoi. Pratique pour vérifier d'un coup d'œil.
MétadonnéesDécide de ce que vos fichiers emportent : date, appareil, objectif, mots-clés et position GPS. C'est le réglage le plus important de cette liste — voir ci-dessous.

Le panneau Métadonnées

Dans la même fenêtre, plus bas, un panneau Métadonnées décide de ce que vos fichiers emportent avec eux. Le menu Inclure propose plusieurs niveaux, du plus ouvert au plus fermé, et deux cases retirent séparément les informations de personne et les informations d'emplacement.

Good to know

Choisissez « Copyright uniquement ». C'est le réglage recommandé : votre mention de copyright voyage avec vos images, et tout le reste — date, appareil, objectif, mots-clés et surtout coordonnées GPS — reste chez vous. Vos clients n'ont aucun usage de ces informations, et une photo prise au domicile de quelqu'un n'a pas à révéler son adresse.

Ce réglage s'applique à tout ce que le plugin publie : vignettes, aperçus et fichiers de livraison. Il vaut pour le service entier, donc pour toutes vos collections publiées.

Careful

Une exception, et elle vient de Lightroom : au format Original, Lightroom recopie votre fichier sans le retraiter. Aucune métadonnée ne peut alors être retirée, quel que soit ce panneau. C'est logique — on livre le fichier brut — mais il faut le savoir avant de livrer des RAW.

Careful

Si vous régénérez la clé d'API dans PIXMARO, l'ancienne cesse aussitôt de fonctionner. Pensez à recoller la nouvelle dans le plugin, sinon vos publications échoueront avec une erreur d'authentification.

📷
Panneau Services de publication de Lightroom, avec la fenêtre de configuration PIXMARO ouverte.

Creating a published collection

Dans Lightroom, une collection publiée correspond à un album dans PIXMARO. Vous glissez des photos dedans, vous publiez, l'album se crée et se remplit.

  1. Faites un clic droit sur PIXMARO dans les Services de publication, puis Créer une collection publiée.
  2. Donnez-lui un nom : ce sera le titre de l'album vu par votre client.
  3. Réglez le type et le template (sujet suivant).
  4. Validez, puis glissez vos photos dans la collection.
  5. Cliquez sur Publier.

Au premier envoi, l'album est créé dans PIXMARO. Aux envois suivants, la collection reste liée au même album : rien n'est dupliqué.

Good to know

Les photos arrivent dans l'ordre où le plugin les envoie. Pour les ranger ensuite — remettre une séance dans l'ordre chronologique, mettre une image en tête — faites-le depuis PIXMARO, sur la page de l'album, en faisant glisser les vignettes.

A collection's settings

Ils s'ouvrent par un clic droit sur la collection, Modifier la collection publiée.

Ce qui définit l'album

RéglageDétail
TypeSélection (le client choisit), Visualisation (il regarde et commente) ou Livraison (il télécharge).
TemplateSeuls les templates marqués « compatibles Lightroom » apparaissent ici. La liste indique le type de chacun.
Compte portailRattache l'album à un compte client, pour qu'il apparaisse dans son portail. Facultatif.
CatégoriePour ranger l'album dans PIXMARO. Facultatif.
Sous-dossier cibleDépose les photos dans un sous-dossier de l'album. C'est ce qui permet de bâtir une arborescence de livraison.

Ce qui définit les fichiers envoyés

RéglageDétail
FormatLe type de fichier produit. Les choix dépendent du type d'album — voir juste en dessous.
QualitéLa compression JPEG appliquée par Lightroom.
Espace colorimétriquesRGB pour tout ce qui s'affiche sur le web — c'est le choix à faire dans presque tous les cas. Adobe RGB ne se justifie que pour une chaîne d'impression qui le réclame.
RedimensionnerLa taille du fichier envoyé : plus grand côté, plus petit côté, ou largeur × hauteur.

Le format dépend du type d'album

Un album de sélection ou de visualisation est fait pour être regardé dans un navigateur ; un dossier de livraison est fait pour être téléchargé. Le menu Format ne propose donc pas la même chose dans les deux cas.

Type d'albumFormats proposésPourquoi
Sélection et visualisationJPEG uniquement.C'est le seul format que tout navigateur affiche. Un TIFF ou un RAW ne s'afficherait pas chez votre client, et l'album pèserait des gigaoctets pour rien.
Dossier de livraisonJPEG, PNG, TIFF ou Original.Ces fichiers sont faits pour être téléchargés et ouverts dans un logiciel. Livrer un TIFF à un imprimeur ou les RAW d'une séance a tout son sens.
Good to know

Si vous changez le type de la collection en cours de route, la liste s'ajuste aussitôt et le format revient à JPEG en quittant la livraison. Les collections de sélection réglées autrefois sur TIFF ou Original publient elles aussi en JPEG, sans que vous ayez à les rouvrir une par une.

Careful

Choisir Adobe RGB pour une galerie web donne des couleurs ternes et délavées dans certains navigateurs. Dans le doute, restez en sRGB.

Cloud only

Sur PIXMARO Cloud, un réglage Distribution apparaît en plus, à choisir à la création de l'album — il ne se modifie plus ensuite. CDN distribue les vignettes et les aperçus par un réseau de diffusion : les galeries s'ouvrent nettement plus vite, partout dans le monde. Sécurisé fait passer chaque image par le contrôle d'accès, ce qui est plus lent mais plus étanche. Les fichiers originaux restent protégés dans les deux cas : seuls les dérivés d'affichage passent par le CDN. Prenez CDN par défaut, Sécurisé pour des contenus sensibles. Ce réglage n'existe pas en self-hosted.

Cloud only

Sur le Cloud, le fichier téléchargeable d'un dossier de livraison ne doit pas dépasser 95 Mo. Au-delà, l'aperçu et la vignette sont publiés normalement — la photo est bien dans la galerie — mais son fichier téléchargeable ne part pas. Le plugin liste ces photos à la fin de la publication : déposez-les depuis le navigateur, ou livrez-les en JPEG.

En pratique, seuls des TIFF ou des fichiers originaux atteignent cette taille. Un JPEG ne s'en approche jamais, donc les albums de sélection et de visualisation ne sont pas concernés.

Publish, republish, delete

Le panneau de la collection distingue les photos à publier, celles publiées, celles modifiées à republier et celles à supprimer. C'est le fonctionnement habituel des services de publication de Lightroom.

Vous faites…Ce qui se passe
Ajouter des photos puis PublierElles s'ajoutent à l'album existant.
Retoucher une photo publiéeLightroom la marque « à republier ». Publier remplace la version en ligne.
Retirer une photo de la collectionElle est supprimée de l'album à la publication suivante. Sur un dossier de livraison, elle est conservée : les fichiers livrés ne se suppriment que depuis PIXMARO.
Renommer la collectionLe titre de l'album suit.
Supprimer la collectionL'album est supprimé dans PIXMARO, avec ses photos.
Good to know

La suppression d'une collection est définitive côté PIXMARO. Si vous voulez seulement fermer l'accès, faites-le depuis PIXMARO (fermer ou archiver) et laissez la collection tranquille dans Lightroom.

Publishing to several albums

Une même photo peut vivre dans plusieurs collections publiées, et donc dans plusieurs albums PIXMARO. Chaque collection garde son propre suivi : republier dans l'une ne touche pas les autres.

Ce que ça permet

  • une sélection pour les mariés et une autre pour la famille, à partir du même reportage ;
  • une livraison pleine définition et une livraison web, chacune avec son template ;
  • plusieurs sous-dossiers d'une même livraison — une collection par moment de la journée.

Pour ce dernier cas, utilisez le sous-dossier cible : plusieurs collections publiées vers le même album, chacune déposant dans son propre dossier. C'est ainsi qu'on bâtit une livraison structurée sans jamais toucher au navigateur.

Pulling selections back into Lightroom

C'est la fonction qui fait gagner le plus de temps. Votre client a coché ses photos ; une commande les retrouve dans votre catalogue.

  1. Clic droit sur la collection publiée.
  2. Choisissez Synchroniser les sélections.
  3. Le plugin interroge PIXMARO et applique les choix de votre client à vos photos.

Ce qui est appliqué à vos photos

Ce que votre client a faitCe que devient la photo dans Lightroom
Il l'a sélectionnéeElle est marquée Retenue (drapeau blanc).
Il lui a mis des étoilesElle reçoit la même note.
Il l'a sélectionnée sans la noterElle reçoit une étoile, pour rester repérable au filtre.
Il a posé une couleurElle reçoit le libellé de couleur correspondant.

Ensuite, le filtre de bibliothèque de Lightroom fait le reste : filtrez sur les photos retenues, et vous avez exactement le lot à retoucher.

Careful

La synchronisation écrase les drapeaux, notes et couleurs de ces photos dans votre catalogue. Si vous utilisez déjà ces marqueurs pour votre propre tri, faites une copie de la collection avant de synchroniser.

Good to know

Les commentaires de votre client ne sont pas transférés dans Lightroom : ils restent lisibles dans le rapport de l'album, côté PIXMARO. Gardez-le ouvert pendant la retouche.

Updating the plugin

Le plugin vérifie de lui-même s'il existe une version plus récente et vous le signale. Vous pouvez aussi le vérifier à la demande depuis le Gestionnaire de modules externes.

  1. Quand une version est disponible, le plugin propose d'ouvrir la page de téléchargement.
  2. Téléchargez l'archive et décompressez-la.
  3. Remplacez l'ancien dossier PIXMARO.lrplugin par le nouveau, au même endroit.
  4. Redémarrez Lightroom. Vérifiez le numéro de version dans le Gestionnaire de modules externes.
Good to know

Gardez le même emplacement : Lightroom retrouve alors le plugin tout seul, et vos collections publiées restent liées à leurs albums. Installer le nouveau à un autre endroit crée un second service, vide.

Le plugin et PIXMARO se mettent à jour indépendamment : mettre à jour l'un n'oblige pas à mettre à jour l'autre.

Troubleshooting common problems

SymptômeCause la plus probableCe qu'il faut faire
« Non authentifié » à la publicationLa clé d'API a changé, ou a été mal collée.Recopiez-la depuis Paramètres → Lightroom, en vérifiant l'absence d'espace au début ou à la fin.
Le plugin ne joint pas le serveurL'URL de l'API est incomplète.Elle doit finir par /api/ et commencer par https://.
La liste des templates est videAucun template n'est marqué « compatible Lightroom ».Cochez la case sur au moins un template, puis Actualiser les listes dans la collection.
Les listes ne se mettent pas à jourElles sont chargées à l'ouverture de la fenêtre.Le bouton ↺ Actualiser les listes les recharge sans fermer.
La publication s'arrête en coursL'hébergement limite le rythme des requêtes.Passez le délai entre les envois à 0,5 ou 1 seconde dans les réglages du service.
Erreur de licence (402)Votre abonnement ou votre licence n'est plus actif : la création et l'envoi sont bloqués.Régularisez depuis la page Facturation, ou Paramètres → Licence si vous hébergez PIXMARO.
Les couleurs paraissent délavéesL'espace colorimétrique est en Adobe RGB.Repassez la collection en sRGB et republiez.
Une photo est livrée sans son fichier téléchargeable (Cloud)Le fichier dépasse 95 Mo. Le plugin le signale dans le récapitulatif de fin de publication.Livrez-la en JPEG plutôt qu'en TIFF ou en original, ou déposez-la depuis le navigateur.
Good to know

Avant de chercher côté Lightroom, vérifiez deux choses dans PIXMARO : que votre abonnement est bien actif sur la page Facturation, et que la clé d'API de Paramètres → Lightroom est celle que porte le plugin. Ces deux causes expliquent la majorité des publications qui échouent.

Si vous hébergez PIXMARO vous-même, Paramètres → À propos → Diagnostic système va plus loin : il contrôle aussi les permissions de fichiers et les extensions PHP.