ImgLink plugin for Discourse (hosted image workflows + admin diagnostics)

Customization Plugin
1

Summary

ImgLink media upload integration for Discourse with scoped API keys, retry handling, and admin diagnostics.

Repository Link

https://github.com/imglink12x/discourse-plugin

Install Guide

  1. SSH into your Discourse container:

  2. Add the plugin to your app.yml:

  3. Rebuild the container:

  4. Configure your ImgLink API key in Admin Settings (see Configuration below)

For detailed setup: https://imglink.cc/tools/forum-plugins

Features

  • Direct Upload from Composer — Upload images directly from Discourse post editor

  • Scoped API Keys — Uses limited-scope credentials; no full account access

  • Direct & Viewer Links — Returns both direct CDN links and image viewer URLs

  • Retry + Idempotency — Automatic retry logic for unstable connections; prevents duplicate uploads

  • Admin Diagnostics — Built-in health checks to validate API auth, connectivity, and upload permissions

  • BBCode Output — Automatic BBCode formatting for embedded posting

  • Error Logging — Detailed logs for troubleshooting upload failures

Configuration

Step 1: Create an ImgLink API Key

  1. Log in to ImgLink (https://imglink.cc)

  2. Navigate to Settings → API Keys

  3. Create a new key with these scopes:

    • upload:create

    • image:delete (optional, for cleanup workflows)

  4. Copy the API key

Step 2: Add to Discourse Admin Settings

  1. Go to Admin → Settings → Plugins

  2. Scroll to ImgLink Settings

  3. Paste your API key in the imglink_api_key field

  4. (Optional) Set imglink_api_endpoint if using a custom ImgLink instance

  5. Save

Step 3: Run Diagnostics

  1. Go to Admin → Plugins → ImgLink Settings

  2. Click “Test Connection” to validate your configuration

  3. You should see “✓ Connection successful”

Settings

Setting Name Type Default Description
imglink_api_key String (empty) Your ImgLink API key with upload:create scope
imglink_api_endpoint String https://imglink.cc/api/v1 ImgLink API base URL (leave default unless self-hosted)
imglink_max_retries Integer 3 Number of retry attempts for failed uploads
imglink_retry_delay Integer 1000 Milliseconds to wait between retry attempts
imglink_timeout_ms Integer 30000 Upload request timeout (30 seconds)
imglink_enable_diagnostics Boolean true Enable admin diagnostic tools and logs
imglink_enable_direct_links Boolean true Return direct CDN links vs. viewer-wrapped links

Version Compatibility: Discourse 2.8+ | Last Updated: March 2026 | Support: https://imglink.cc/tools/forum-plugins

2

Why did you select these tags on this topic? The selection of random tags doesn’t help your plugin appear particularly trustworthy.

Also, most of the links don’t work:


Where are the settings? Usually, I can see them in a settings file in the config folder, like for example:

2 Likes
5

Hi @A_Richards, I removed the tags on your post because they were spammy and unrelated. I also had a look in the code and the plugin is not properly set up to have configurable settings as stated above.

I’d recommend you start here to edit your plugin to be better:

2 Likes