Zusammenfassung
ImgLink-Medien-Upload-Integration für Discourse mit bereichsdefinierten API-Schlüsseln, Wiederholungsbehandlung und Admin-Diagnosefunktionen.
Repository-Link
https://github.com/imglink12x/discourse-plugin
Installationsanleitung
-
Stellen Sie per SSH eine Verbindung zu Ihrem Discourse-Container her:
-
Fügen Sie das Plugin zu Ihrer
app.ymlhinzu: -
Bauen Sie den Container neu auf:
-
Konfigurieren Sie Ihren ImgLink API-Schlüssel in den Admin-Einstellungen (siehe Konfiguration unten)
Ausführliche Einrichtung: https://imglink.cc/tools/forum-plugins
Funktionen
-
Direkter Upload aus dem Composer — Bilder direkt aus dem Discourse-Beitrageneditor hochladen
-
Bereichsdefinierte API-Schlüssel — Verwendet Anmeldeinformationen mit begrenztem Umfang; kein vollständiger Kontozugriff
-
Direkte & Viewer-Links — Gibt sowohl direkte CDN-Links als auch Image-Viewer-URLs zurück
-
Wiederholung + Idempotenz — Automatische Wiederholungslogik für instabile Verbindungen; verhindert doppelte Uploads
-
Admin-Diagnose — Eingebaute Gesundheitsprüfungen zur Validierung von API-Authentifizierung, Konnektivität und Upload-Berechtigungen
-
BBCode-Ausgabe — Automatische BBCode-Formatierung für eingebettete Beiträge
-
Fehlerprotokollierung — Detaillierte Protokolle zur Fehlerbehebung bei Upload-Fehlern
Konfiguration
Schritt 1: Erstellen Sie einen ImgLink API-Schlüssel
-
Melden Sie sich bei ImgLink an (https://imglink.cc)
-
Navigieren Sie zu Einstellungen → API-Schlüssel
-
Erstellen Sie einen neuen Schlüssel mit diesen Bereichen (Scopes):
-
upload:create -
image:delete(optional, für Cleanup-Workflows)
-
-
Kopieren Sie den API-Schlüssel
Schritt 2: Zu den Discourse-Admin-Einstellungen hinzufügen
-
Gehen Sie zu Admin → Einstellungen → Plugins
-
Scrollen Sie zu ImgLink-Einstellungen
-
Fügen Sie Ihren API-Schlüssel in das Feld
imglink_api_keyein -
(Optional) Legen Sie
imglink_api_endpointfest, falls Sie eine benutzerdefinierte ImgLink-Instanz verwenden -
Speichern
Schritt 3: Diagnose ausführen
-
Gehen Sie zu Admin → Plugins → ImgLink-Einstellungen
-
Klicken Sie auf „Verbindung testen“, um Ihre Konfiguration zu validieren
-
Sie sollten „✓ Verbindung erfolgreich“ sehen
Einstellungen
| Einstellungsname | Typ | Standard | Beschreibung |
|---|---|---|---|
imglink_api_key |
Zeichenfolge | (leer) | Ihr ImgLink API-Schlüssel mit dem Geltungsbereich upload:create |
imglink_api_endpoint |
Zeichenfolge | https://imglink.cc/api/v1 |
ImgLink API-Basis-URL (Standard beibehalten, sofern nicht selbst gehostet) |
imglink_max_retries |
Integer | 3 |
Anzahl der Wiederholungsversuche für fehlgeschlagene Uploads |
imglink_retry_delay |
Integer | 1000 |
Millisekunden, die zwischen Wiederholungsversuchen gewartet werden |
imglink_timeout_ms |
Integer | 30000 |
Timeout für Upload-Anfragen (30 Sekunden) |
imglink_enable_diagnostics |
Boolean | true |
Aktiviert Admin-Diagnosetools und -Protokolle |
imglink_enable_direct_links |
Boolean | true |
Gibt direkte CDN-Links gegenüber Viewer-umschlossenen Links zurück |
Versionskompatibilität: Discourse 2.8+ | Zuletzt aktualisiert: März 2026 | Support: https://imglink.cc/tools/forum-plugins