2017 © Pedro Peláez
 

flarum-extension upload

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

image

flagrow/upload

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

  • Wednesday, May 16, 2018
  • by Luceos
  • Repository
  • 8 Watchers
  • 53 Stars
  • 7,965 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 31 Forks
  • 38 Open issues
  • 47 Versions
  • 11 % Grown

The README.md

Upload by FriendsOfFlarum

MIT license Latest Stable Version Total Downloads OpenCollective, (*1)

An extension that handles file uploads intelligently for your forum., (*2)

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 adapters (see below)

Installation

Install manually with composer:, (*3)

composer require fof/upload

Updating

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

Updating from Flagrow

This extension replaces Flagrow Upload., (*4)

To upgrade from the old extension to the new one:, (*5)

  • Backup your data! You should backup the database and the uploaded files., (*6)

  • Make sure the latest version of Flagrow upload is installed and migrations have run:, (*7)

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., (*8)

  • Run:, (*9)

composer require fof/upload

Composer should let you know that flagrow/upload has been automatically removed., (*10)

  • Enable the new extension in the admin panel., (*11)

  • Your existing configuration and uploads meta will be migrated to FoF Upload automatically., (*12)

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

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., (*14)

Make sure you configure the upload permission on the permissions page as well., (*15)

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., (*16)

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

(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: \/., (*18)

Disable or Force a particular adapter

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

For example, you may disable imgur, (*20)

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

Chaining of multiple commands is also possible:, (*21)

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

You may also force an adapter:, (*22)

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

Adapter names currently available: - local - imgur - qiniu - aws-s3, (*23)

FAQ

An extension by FriendsOfFlarum, (*24)

The Versions

16/05 2018

dev-master

9999999-dev

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

28/12 2017

0.7.0

0.7.0.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

14/11 2017

0.6.0

0.6.0.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

19/10 2017

dev-circleci

dev-circleci

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

12/09 2017

dev-jenkins

dev-jenkins

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

07/09 2017

dev-template-migration

dev-template-migration

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

30/08 2017

0.6.0-beta

0.6.0.0-beta

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

30/08 2017

dev-templates

dev-templates

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

12/07 2017

dev-simplify

dev-simplify

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

16/05 2017

0.5.7

0.5.7.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

28/04 2017

0.5.6

0.5.6.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

24/04 2017

0.5.5

0.5.5.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

24/04 2017

0.5.4

0.5.4.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

20/04 2017

0.5.3

0.5.3.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

20/04 2017

0.5.2

0.5.2.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

20/04 2017

0.5.1

0.5.1.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

19/04 2017

0.5.0

0.5.0.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

10/04 2017

0.4.13

0.4.13.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

05/04 2017

0.4.12

0.4.12.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

31/03 2017

0.4.11

0.4.11.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

31/03 2017

0.4.10

0.4.10.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

17/03 2017

dev-flysystem

dev-flysystem

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

16/03 2017

0.4.9

0.4.9.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

13/03 2017

0.4.8

0.4.8.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

28/02 2017

0.4.7

0.4.7.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

06/02 2017

0.4.6

0.4.6.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

02/02 2017

0.4.5

0.4.5.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

27/01 2017

0.4.4

0.4.4.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

27/01 2017

0.4.3

0.4.3.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

16/01 2017

0.4.2

0.4.2.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

06/01 2017

0.4.1

0.4.1.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

05/01 2017

0.4.0

0.4.0.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

12/12 2016

0.3.8

0.3.8.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

07/12 2016

0.3.7

0.3.7.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

26/11 2016

0.3.6

0.3.6.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

25/11 2016

0.3.5

0.3.5.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

23/11 2016

0.3.4

0.3.4.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

22/11 2016

0.3.3

0.3.3.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

21/11 2016

0.3.2

0.3.2.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

14/11 2016

0.3.1

0.3.1.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

11/11 2016

0.3.0

0.3.0.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

09/11 2016

0.2.1

0.2.1.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

07/11 2016

0.2.0

0.2.0.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

04/11 2016

0.1.3

0.1.3.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

04/11 2016

0.1.2

0.1.2.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

04/11 2016

0.1.1

0.1.1.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow

03/11 2016

0.1.0

0.1.0.0

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

  Sources   Download

MIT

The Requires

 

The Development Requires

file upload flarum flagrow