Riepilogo
Integrazione per il caricamento di media ImgLink per Discourse con chiavi API con ambito limitato, gestione dei tentativi e diagnostica per amministratori.
Link al Repository
https://github.com/imglink12x/discourse-plugin
Guida all’Installazione
-
Accedi tramite SSH al container di Discourse:
-
Aggiungi il plugin al tuo
app.yml: -
Ricostruisci il container:
-
Configura la tua chiave API ImgLink nelle Impostazioni Amministratore (vedi Configurazione di seguito)
Per l’installazione dettagliata: https://imglink.cc/tools/forum-plugins
Funzionalità
-
Caricamento Diretto dall’Editor — Carica immagini direttamente dall’editor dei post di Discourse
-
Chiavi API con Ambito Limitato — Utilizza credenziali con ambito limitato; nessun accesso completo all’account
-
Link Diretti e per Visualizzatore — Restituisce sia i link diretti al CDN sia gli URL per la visualizzazione delle immagini
-
Tentativi + Idempotenza — Logica di nuovo tentativo automatica per connessioni instabili; previene caricamenti duplicati
-
Diagnostica Amministratore — Controlli di stato integrati per convalidare l’autenticazione API, la connettività e i permessi di caricamento
-
Output BBCode — Formattazione BBCode automatica per l’inserimento nei post
-
Registrazione Errori — Log dettagliati per la risoluzione dei problemi di caricamento falliti
Configurazione
Passaggio 1: Crea una Chiave API ImgLink
-
Accedi a ImgLink (https://imglink.cc)
-
Vai su Impostazioni → Chiavi API
-
Crea una nuova chiave con questi ambiti:
-
upload:create -
image:delete(opzionale, per i flussi di lavoro di pulizia)
-
-
Copia la chiave API
Passaggio 2: Aggiungi alle Impostazioni Amministratore di Discourse
-
Vai su Admin → Impostazioni → Plugin
-
Scorri fino a Impostazioni ImgLink
-
Incolla la tua chiave API nel campo
imglink_api_key -
(Opzionale) Imposta
imglink_api_endpointse stai utilizzando un’istanza ImgLink personalizzata -
Salva
Passaggio 3: Esegui la Diagnostica
-
Vai su Admin → Plugin → Impostazioni ImgLink
-
Clicca su “Test Connessione” per convalidare la tua configurazione
-
Dovresti vedere “✓ Connessione riuscita”
Impostazioni
| Nome Impostazione | Tipo | Predefinito | Descrizione |
|---|---|---|---|
imglink_api_key |
Stringa | (vuoto) | La tua chiave API ImgLink con ambito upload:create |
imglink_api_endpoint |
Stringa | https://imglink.cc/api/v1 |
URL di base dell’API ImgLink (lascia il predefinito a meno che non sia self-hosted) |
imglink_max_retries |
Intero | 3 |
Numero di tentativi per i caricamenti falliti |
imglink_retry_delay |
Intero | 1000 |
Millisecondi di attesa tra i tentativi |
imglink_timeout_ms |
Intero | 30000 |
Timeout della richiesta di caricamento (30 secondi) |
imglink_enable_diagnostics |
Booleano | true |
Abilita strumenti di diagnostica e log per amministratori |
imglink_enable_direct_links |
Booleano | true |
Restituisce link diretti al CDN anziché link con visualizzatore |
Compatibilità Versione: Discourse 2.8+ | Ultimo Aggiornamento: Marzo 2026 | Supporto: https://imglink.cc/tools/forum-plugins