Résumé
Intégration de téléchargement de médias ImgLink pour Discourse avec des clés API délimitées, gestion des nouvelles tentatives et diagnostics d’administration.
Lien vers le dépôt
https://github.com/imglink12x/discourse-plugin
Guide d’installation
-
Connectez-vous en SSH à votre conteneur Discourse :
-
Ajoutez le plugin à votre
app.yml: -
Reconstruisez le conteneur :
-
Configurez votre clé API ImgLink dans les paramètres d’administration (voir Configuration ci-dessous)
Pour une configuration détaillée : https://imglink.cc/tools/forum-plugins
Fonctionnalités
-
Téléchargement direct depuis le compositeur — Téléchargez des images directement depuis l’éditeur de publication de Discourse
-
Clés API délimitées — Utilise des informations d’identification à portée limitée ; pas d’accès complet au compte
-
Liens directs et visionneuse — Retourne à la fois les liens CDN directs et les URL de la visionneuse d’images
-
Nouvelles tentatives + Idempotence — Logique de nouvelle tentative automatique pour les connexions instables ; empêche les téléchargements dupliqués
-
Diagnostics d’administration — Vérifications d’intégrité intégrées pour valider l’authentification API, la connectivité et les autorisations de téléchargement
-
Sortie BBCode — Formatage BBCode automatique pour l’intégration des publications
-
Journalisation des erreurs — Journaux détaillés pour le dépannage des échecs de téléchargement
Configuration
Étape 1 : Créer une clé API ImgLink
-
Connectez-vous à ImgLink (https://imglink.cc)
-
Naviguez vers Paramètres → Clés API
-
Créez une nouvelle clé avec ces portées :
-
upload:create -
image:delete(facultatif, pour les flux de nettoyage)
-
-
Copiez la clé API
Étape 2 : Ajouter aux paramètres d’administration de Discourse
-
Accédez à Administration → Paramètres → Plugins
-
Faites défiler jusqu’à Paramètres ImgLink
-
Collez votre clé API dans le champ
imglink_api_key -
(Facultatif) Définissez
imglink_api_endpointsi vous utilisez une instance ImgLink personnalisée -
Enregistrez
Étape 3 : Exécuter les diagnostics
-
Accédez à Administration → Plugins → Paramètres ImgLink
-
Cliquez sur « Tester la connexion » pour valider votre configuration
-
Vous devriez voir « ✓ Connexion réussie »
Paramètres
| Nom du paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
imglink_api_key |
Chaîne | (vide) | Votre clé API ImgLink avec la portée upload:create |
imglink_api_endpoint |
Chaîne | https://imglink.cc/api/v1 |
URL de base de l’API ImgLink (laisser par défaut sauf si auto-hébergé) |
imglink_max_retries |
Entier | 3 |
Nombre de tentatives de nouvelle tentative pour les téléchargements ayant échoué |
imglink_retry_delay |
Entier | 1000 |
Millisecondes à attendre entre les tentatives de nouvelle tentative |
imglink_timeout_ms |
Entier | 30000 |
Délai d’attente de la requête de téléchargement (30 secondes) |
imglink_enable_diagnostics |
Booléen | true |
Active les outils de diagnostic d’administration et les journaux |
imglink_enable_direct_links |
Booléen | true |
Retourne les liens CDN directs par rapport aux liens enveloppés dans la visionneuse |
Compatibilité de version : Discourse 2.8+ | Dernière mise à jour : Mars 2026 | Support : https://imglink.cc/tools/forum-plugins