Photoshop
Installez le plugin UXP ArtInStack, Connect Device Code, choisissez un portfolio et publiez le document actif depuis Adobe Photoshop.
Ceci est le guide d'intégration du plugin UXP officiel Photoshop. Référence API : OAuth, Médias, Portfolios.
Prérequis
- Adobe Photoshop 23+ (UXP)
- Creative Cloud Desktop (pour installer le
.ccx) - Compte ArtInStack avec au moins un portfolio créé dans le tableau de bord
.ccxdepuis Software
Installation
- Téléchargez
ArtInStack-Photoshop-latest.ccxdepuis Software - Double-cliquez le
.ccx(ou ouvrez-le avec Creative Cloud Desktop) pour l'installer dans Photoshop - Redémarrez Photoshop si le panneau n'apparaît pas
- Ouvrez Plugins → ArtInStack
Bêta privée / développement : chargez manifest.json avec UXP Developer Tools au lieu du .ccx.
Connexion (Device Code)
Photoshop UXP ne peut pas lier un écouteur HTTP en loopback, donc le plugin utilise OAuth 2.0 Device Authorization Grant (pas Authorization Code + PKCE).
- Dans le panneau ArtInStack, cliquez sur Connect
- Le plugin demande un device code et ouvre
/oauth/devicedans le navigateur - Connectez-vous si besoin, saisissez le code utilisateur affiché dans le panneau (si demandé), puis approuvez les portées
- Le plugin interroge
/api/oauth/tokenjusqu'à l'approbation, puis stocke access + refresh tokens - Applications connectées dans Paramètres → Développeur liste ArtInStack Photoshop après consentement
Choisir un portfolio
- Après Connect, le panneau charge
GET /api/v1/portfolios - Choisissez le portfolio pour cette publication
- Créez les portfolios dans le tableau de bord ArtInStack. Le plugin ne les crée pas
Publier
- Ouvrez le document à publier (le master)
- Ajustez Export settings dans le panneau si besoin (les défauts correspondent au dimensionnement web Lightroom / Capture One)
- Cliquez sur Publish active document. Le plugin prépare un JPEG et le téléverse via
POST /api/v1/mediaavecIdempotency-Keyetportfolio_id - En cas de succès, la photo apparaît dans le portfolio du tableau de bord ; le journal du panneau affiche
media_id
Les types API pris en charge (JPEG, PNG, GIF, WebP, TIFF) sont listés sur Médias. Le panneau publie uniquement du JPEG aujourd'hui.
Réglages d'export (v0.1.1+)
| Réglage | Défaut | Notes |
|---|---|---|
| Resize | On — 2048 px | Grand côté (alternatives : petit côté, largeur, hauteur, px personnalisé) |
| Convert to sRGB | On | Couleur web/portfolio |
| Embed profile | On | Avec conversion sRGB |
| Duplicate image | On | Travaillez sur une copie ; le master n'est jamais modifié |
| Convert to 8-bit | On | Chemin JPEG |
| Sharpening | Light | Light ou Screen Smart Sharpen sur un calque stamped ; None pour ignorer |
| JPEG quality | High (~10) | Échelle UXP 1–12 |
Ce qui se passe à la publication (Duplicate on)
- Photoshop duplique le document actif et exécute les étapes d'export sur la copie uniquement (8 bits, sRGB, resize, fusion visible, tampon de netteté optionnel)
- Le plugin écrit
{document-basename}-copy.jpget le téléverse - La copie traitée reste ouverte pour inspecter les calques, ajuster l'opacité de netteté dans Calques (
ArtInStack sharpen), ou Save As en local - La copie s'ouvre à 100 % de zoom, ou Fit on Screen lorsque le canevas est plus grand que la vue
- Publish again tant que cette copie est au premier plan → re-téléversement seulement (pas de second doublon). Activez le master pour préparer une nouvelle copie ou changer les réglages d'export
Le title du téléversement utilise le nom du document ; le filename multipart utilise {basename}-copy.jpg (p. ex. Tiger-Edit-copy.jpg). Les masters dont le nom contient déjà copy reçoivent un suffixe -copy supplémentaire à l'export — c'est attendu.
Dépannage
| Symptôme | Vérifier |
|---|---|
| Connect bloqué / refusé | Terminez le consentement sur /oauth/device ; Device Grant activé pour le client OAuth Photoshop |
| Liste de portfolios vide | portfolios:read accordé ; le portfolio existe dans le même espace de travail que le consentement ; Connect terminé |
| Téléversement 403 | media:write ou portfolios:write manquant |
| Type de fichier rejeté | Gardez le document actif ouvert ; l'export du plugin doit réussir |
| Fichier trop volumineux | Activez Resize ou baissez la qualité JPEG ; la taille max plateforme s'applique |
| Erreur de réglages d'export modifiés | Activez le master et publiez à nouveau (la copie préparée a été créée avec d'autres réglages) |
| Doublons au nouvel essai | Idempotency-Key stable par document préparé. Sûr de Publish à nouveau depuis la même copie ouverte |
Déconnexion
Utilisez Disconnect dans le panneau ou Révoquer l'accès sous Applications connectées dans le tableau de bord.
