zephyrisle/fof-upload-imagekit

ImageKit adapter for FoF Upload on Flarum.

dev-main 2026-05-31 13:22 UTC

Requires

• php: ^8.1
• flarum/core: ^2.0@beta
• fof/upload: ^2.0@beta
• guzzlehttp/guzzle: ^7.0

MIT

• Zephyr-Isle

• upload
• flarum
• flarum-extension
• imagekit
• fof-upload

README

A Flarum extension that adds an imagekit upload adapter for fof/upload.

Features

• Registers imagekit as a FoF Upload adapter.
• Uploads files to ImageKit using the server-side upload API.
• Stores the ImageKit fileId in fof_upload_files.remote_id so deletions can be synchronized.
• Exposes a minimal admin settings page for ImageKit credentials and folder settings.

Installation

composer require zephyrisle/fof-upload-imagekit

Configuration

1. Enable the extension in the Flarum admin panel.
2. Fill in the ImageKit private key and URL endpoint on the extension page.
3. Optionally adjust the upload folder and unique filename behavior.
4. Open the fof/upload settings page and map your mime types to the imagekit adapter.

Notes

• This extension uses ImageKit server-side upload and delete APIs.
• Delete operations require the original ImageKit fileId, which is stored as remote_id when a file is uploaded through this adapter.
• Existing FoF Upload records that were not created through this adapter cannot be deleted from ImageKit automatically unless they already contain a valid remote_id.