The file upload extension with insane intelligence for your Flarum forum.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Daniël Klabbers 1c05db3cdb
Update ISSUE_TEMPLATE.md
1 year ago
.circleci db host wrong? 2 years ago
.github Update ISSUE_TEMPLATE.md 1 year ago
js fixes #104 toggling watermark setting failed 2 years ago
less clarification of templates 2 years ago
locale added slovak translation 2 years ago
migrations ok seems to do a lot already, but downloads seems to persist to db 2 years ago
resources added new logo 1 year ago
src Use https for s3 links 1 year ago
tests added a test, but we need to install the extension first 2 years ago
.editorconfig first commit 3 years ago
.gitattributes added an issue template 2 years ago
.gitignore handling and hooking 3 years ago
CHANGELOG.md beta 8 ready up 1 year ago
CONTRIBUTING.md ok seems to do a lot already, but downloads seems to persist to db 2 years ago
LICENSE.md Apply new README format 2 years ago
README.md Apply new README format 2 years ago
bootstrap.php fallback added 2 years ago
composer.json Update composer.json 1 year ago
phpunit.xml added a test, but we need to install the extension first 2 years ago

README.md

Upload by Flagrow logo Flagrow, a project of Gravure

MIT license Latest Stable Version Total Downloads Donate Join our Discord server

An extension that handles file uploads intelligently for your forum.

Features

  • For images:
    • Auto watermarks.
    • Auto resizing.
  • Mime type to upload adapter mapping.
  • Whitelisting mime types.
  • Uploading on different storage services (local, imgur, AWS S3 for instance).
  • Drag and drop uploads.
  • Uploading multiple files at once (button and drag and drop both support this).
  • Easily extendable, the extension heavily relies on Events.

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

Installation

Use Bazaar or install manually:

composer require flagrow/upload

Updating

composer update flagrow/upload
php flarum cache:clear

Configuration

Enable the extension, a new tab will appear on the left hand side. This separate settings page allows you to further configure the extension.

Make sure you configure the upload permission on the permissions page as well.

Mimetype regular expression

Regular expressions allow you a lot of freedom, but they are also very difficult to understand. Here are some pointers, but feel free to ask for help on the official Flarum forums.

In case you want to allow all regular file types including video, music, compressed files and images, use this:

(video\/(3gpp|mp4|mpeg|quicktime|webm))|(audio\/(aiff|midi|mpeg|mp4))|(image\/(gif|jpeg|png))|(application\/(x-(7z|rar)-compressed|zip|arj|x-(bzip2|gzip|lha|stuffit|tar)|pdf))

A mimetype consists of a primary and secondary type. The primary type can be image, video and application for instance. The secondary is like a more detailed specification, eg png, pdf etc. These two are divided by a /, in regex you have to escape this character by using: \/.

Changelog

Please visit the thread.

Check future milestones.

Support our work

We prefer to keep our work available to everyone. In order to do so we rely on voluntary contributions on Patreon.

Security

If you discover a security vulnerability within Upload, please send an email to the Gravure team at security@gravure.io. All security vulnerabilities will be promptly addressed.

Please include as many details as possible. You can use php flarum info to get the PHP, Flarum and extension versions installed.

FAQ

An extension by Flagrow, a project of Gravure.