Skip to content

The file upload extension with insane intelligence for your Flarum forum.

License

Notifications You must be signed in to change notification settings

v17development/upload

 
 

Repository files navigation

Upload by FriendsOfFlarum

MIT license Latest Stable Version Total Downloads OpenCollective

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.
  • Extender interface to disable or force particular adaptors (see below)

Disable or Force a particular adaptor

In some circumstances, you may wish to either disable an adaptor, or force the use of one. This is set in your root extend.php file.

For example, you may disable imgur

(new FoF\Upload\Extend\Adapters())
        ->disable('imgur'),

Chaining of multiple commands is also possible:

(new FoF\Upload\Extend\Adapters())
        ->disable('imgur')
        ->disable('aws-s3'),

You may also force an adaptor:

(new FoF\Upload\Extend\Adapters())
        ->force('imgur'),

Adaptor names currently available:

  • local
  • imgur
  • qiniu
  • aws-s3

Installation

Use Bazaar or install manually:

composer require fof/upload

Updating

composer require fof/upload
php flarum migrate
php flarum cache:clear

Updating from Flagrow

This extension replaces Flagrow Upload.

To upgrade from the old extension to the new one:

  • Backup your data! You should backup the database and the uploaded files.

  • Make sure the latest version of Flagrow upload is installed and migrations have run:

composer require flagrow/upload
composer show flagrow/upload # You should see "versions: * 0.7.1" on the 4th line of output
php flarum migrate
  • Disable the Upload extension in the admin panel.

  • Run:

composer require fof/upload

Composer should let you know that flagrow/upload has been automatically removed.

  • Enable the new extension in the admin panel.

  • Your existing configuration and uploads meta will be migrated to FoF Upload automatically.

  • The same file locations on the disk are used by FoF Upload, it means the files don't need to be moved.

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|zip)-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: \/.

FAQ

Links

An extension by FriendsOfFlarum

About

The file upload extension with insane intelligence for your Flarum forum.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 58.1%
  • JavaScript 35.6%
  • Less 5.6%
  • Blade 0.7%