flagrow / upload
The file upload extension for the Flarum forum with insane intelligence.
Installs: 49 031
Dependents: 0
Suggesters: 0
Security: 0
Stars: 100
Watchers: 6
Forks: 59
Open Issues: 55
Type:flarum-extension
Requires
- flarum/core: ^0.1.0-beta.8
- ramsey/uuid: ^3.5.2
Requires (Dev)
- flagrow/steamroller: dev-master
- league/flysystem: ^1.0.32
- league/flysystem-aws-s3-v3: ^1.0
- techyah/flysystem-ovh: ^1.0
Suggests
- league/flysystem-aws-s3-v3: Uploads to AWS S3 using API version 3.
- techyah/flysystem-ovh: Uploads to OVH Swift vfs using API.
- dev-master
- 0.7.1
- 0.7.0
- 0.7.0-beta.2
- 0.7.0-beta.1
- 0.6.0
- 0.6.0-beta
- 0.5.7
- 0.5.6
- 0.5.5
- 0.5.4
- 0.5.3
- 0.5.2
- 0.5.1
- 0.5.0
- 0.4.13
- 0.4.12
- 0.4.11
- 0.4.10
- 0.4.9
- 0.4.8
- 0.4.7
- 0.4.6
- 0.4.5
- 0.4.4
- 0.4.3
- 0.4.2
- 0.4.1
- 0.4.0
- 0.3.8
- 0.3.7
- 0.3.6
- 0.3.5
- 0.3.4
- 0.3.3
- 0.3.2
- 0.3.1
- 0.3.0
- 0.2.1
- 0.2.0
- 0.1.3
- 0.1.2
- 0.1.1
- 0.1.0
- dev-dk/user-files-page
- dev-circleci
- dev-jenkins
- dev-template-migration
- dev-simplify
This package is auto-updated.
Last update: 2020-02-08 19:35:53 UTC
README
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.
Security
If you discover a security vulnerability within Upload, please send an email to the Flagrow team at security@flagrow.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
- AWS S3: read the AWS S3 configuration page.
Links
An extension by Flagrow.