Flagrow image uploader for Flarum forum messages

matpompili

image-upload by flagrow

A Flarum extension that adds an image upload button on discussion and comment creation, uploads the image(s) to the configured upload connection and then adds a markdown link to the uploaded image.

Screenshots

Imgur Imgur

goals

Allow uploading and attachment of images.
Support any needed upload service.

For a complete overview of our releases, please visit the milestones tracker on Github.

installation

composer require flagrow/flarum-ext-image-upload

configuration

Visit the permission tab to select what user group can upload images in posts.
Visit the settings tab of the extension in your admin to configure your image upload services.

Upload services

The following upload services are supported:

Locally in assets/images (default).
Imgur anonymously (requires Client Id by signing up).
Cloudinary.com (install with composer to use: composer require cloudinary/cloudinary_php).

End-user usage

During post creation, click the Attach button to select a file. Once you've chosen an image, upload will immediately start and based on the image size and your connection will take some time to complete. The link to the image will then be added as markdown into the post composer.

links

Flagrow is a collaboration of Flarum extension developers to provide quality, maintained extensions.

manifest

matpompili Hi! How soon will support upload any file?

7h3ev1l

matpompili Hey, why upload images in imgur is not starting with https:// this is really bad, please fix it.

marcozambi

matpompili HI! We have developed a migration script that, among other things, is capable of exporting image attachments, populating flagrow_images DB table, then adding the inline image link in the relevant messages. (see https://discuss.flarum.org/d/3585-smf2-to-flarum-migration-script-alpha-3)
In our SMF forum the attachment are divided in different sub-folders, one for each year, to help us storing efficiently our >19000 files.
I was wondering whether you could implement (maybe as an option) the same solution in your extension, helping forums with numerous attachments keeping things a bit tidier (a bit similar to what WordPress does natively for storing media files).
The directory structure could be something like
flarum_install_dir/assets/images/2016
flarum_install_dir/assets/images/2017
flarum_install_dir/assets/images/2018...

Thanks in advance!

VIRUXE

I was already lurking this repository before you guys posted it here. :p

This sounds amazing, mainly because of the local upload. I will try it out when I get home. Thank you.

luceos

VIRUXE local storage is not yet available, it will be implemented before the first release 0.1.0 though.

matpompili

Update: version 0.1.0 released!

The links are not served over HTTPS, known issue. Fixing it as soon as tomorrow 😉

Hiob

A W E S O M E
You did a great job guys! 😃

websmallc

thanks

matpompili

Update: 0.1.1 released.
Fixed the https issue. Now imgur links are forced over https. Local ones are served on the same protocol as the loaded page.

luceos

In order to conform to best practices, we renamed the package to flagrow/flarum-ext-image-upload please update your composer.json files. The old (non-prefixed) package is marked as abandoned.

Hiob

Super! 🙂

luceos

I just released 0.1.3 which now runs on the new package name (flagrow/flarum-ext-image-upload). This fixes the upload url and some other things.

I'll moderate all issues solved in this thread.

HavocK

luceos You update faster than i install 😃
Great job !

luceos

HavocK that's one benefit of working together in Flagrow with matpompili ; a shared responsibility of maintaining quality packages!

erickoh

Thanks! I've been waiting for an image attach extension since the beginning.
Local storage and resize works.
Imgur gives an error on upload though. I didn't configure an imgur client-id, is that required?

luceos

erickoh yes that's required if choosing imgur.

We're closing in on release 0.2.0 which is a major overhaul but still features the same upload services.

matpompili

0.2.0-beta is out!

New in this version:

permission to allow uploading only to a specific group
requires flarum/composer-installer 0.3.0
moved logic of uploading to php
added/restored imgur and local adapters
now validates image uploads
added cloudinary.com adapter

Please feel free to send PR for translations! Also any feedback is appreciated, as always 😃

luceos

With a big thanks to @Toby and @Franz for providing some great feedback. 0.2.0 reflects a lot of their feedback.

Please also note for the cloudinary upload method to be selectable you need to run the following composer command in the Flarum installation directory:

composer require cloudinary/cloudinary_php

Cheun

Image upload? Looks like normal Markdown to me. Unless you're uploading the image to the local server and it's entering the image files location as the url... .-.

luceos

Cheun related to your feedback, I updated the OP and the readme on github. When you enable the extension a new button is added to the post composer. If you click it and select an image the image will be uploaded to the configured service - by default this is local storage aka your own Flarum installation. Once the upload is done a markdown image is added linking to the newly uploaded image.