Resumen
Integración de carga de medios ImgLink para Discourse con claves de API con ámbito definido, manejo de reintentos y diagnósticos de administrador.
Enlace al Repositorio
https://github.com/imglink12x/discourse-plugin
Guía de Instalación
-
Inicie sesión por SSH en su contenedor de Discourse:
-
Añada el plugin a su app.yml:
-
Reconstruya el contenedor:
-
Configure su clave de API de ImgLink en la Configuración de Administrador (consulte Configuración a continuación)
Para una configuración detallada: https://imglink.cc/tools/forum-plugins
Características
-
Carga Directa desde el Compositor — Cargue imágenes directamente desde el editor de publicaciones de Discourse
-
Claves de API con Ámbito Definido — Utiliza credenciales de alcance limitado; sin acceso completo a la cuenta
-
Enlaces Directos y del Visor — Devuelve enlaces CDN directos y URL del visor de imágenes
-
Reintento + Idempotencia — Lógica de reintento automática para conexiones inestables; previene cargas duplicadas
-
Diagnósticos de Administrador — Comprobaciones de estado integradas para validar la autenticación de API, la conectividad y los permisos de carga
-
Salida BBCode — Formato BBCode automático para publicación incrustada
-
Registro de Errores — Registros detallados para solucionar problemas de fallos de carga
Configuración
Paso 1: Cree una Clave de API de ImgLink
-
Inicie sesión en ImgLink (https://imglink.cc)
-
Navegue a Configuración → Claves de API
-
Cree una nueva clave con estos ámbitos:
-
upload:create -
image:delete(opcional, para flujos de trabajo de limpieza)
-
-
Copie la clave de API
Paso 2: Añadir a la Configuración de Administrador de Discourse
-
Vaya a Admin → Configuración → Plugins
-
Desplácese hasta Configuración de ImgLink
-
Pegue su clave de API en el campo
imglink_api_key -
(Opcional) Establezca
imglink_api_endpointsi utiliza una instancia de ImgLink personalizada -
Guardar
Paso 3: Ejecutar Diagnósticos
-
Vaya a Admin → Plugins → Configuración de ImgLink
-
Haga clic en “Probar Conexión” para validar su configuración
-
Debería ver “✓ Conexión exitosa”
Ajustes
| Nombre del Ajuste | Tipo | Predeterminado | Descripción |
|---|---|---|---|
imglink_api_key |
String | (vacío) | Su clave de API de ImgLink con el ámbito upload:create |
imglink_api_endpoint |
String | https://imglink.cc/api/v1 |
URL base de la API de ImgLink (deje el valor predeterminado a menos que esté autoalojado) |
imglink_max_retries |
Integer | 3 |
Número de intentos de reintento para cargas fallidas |
imglink_retry_delay |
Integer | 1000 |
Milisegundos de espera entre intentos de reintento |
imglink_timeout_ms |
Integer | 30000 |
Tiempo de espera de la solicitud de carga (30 segundos) |
imglink_enable_diagnostics |
Boolean | true |
Habilitar herramientas de diagnóstico y registros de administrador |
imglink_enable_direct_links |
Boolean | true |
Devolver enlaces CDN directos frente a enlaces envueltos en el visor |
Compatibilidad de Versión: Discourse 2.8+ | Última Actualización: Marzo de 2026 | Soporte: https://imglink.cc/tools/forum-plugins