Skip to content

LukeTowers/oc-easyfiles-public-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 

Repository files navigation

About

Easy to use file manager plugin for OctoberCMS that allows you to share your files with frontend users. Based on the built-in Media Manager, this plugin is easy to configure to your needs. Great for sharing files with frontend users from any filesystem defined in your project!

Requirements

This plugin requires the Ajax Framework to be included in your layout/page in order to handle requests.

Installation

To install from the Marketplace, click on the "Add to Project" button and then select the project you wish to add it to before updating the project to pull in the plugin. The plugin is paid, so you will need to purchase it before adding it to a project.

To install from the backend, go to Settings -> Updates & Plugins -> Install Plugins and then search for LukeTowers.EasyFiles.

Usage

This plugin registers a single component (fileBrowser) that you can add to your CMS pages. It supports the following configuration options:

Option Description
disk (string, default: 'local') The Storage disk defined in config/filesystems.php to use for this instance of the component
folder (string, default: '') The folder on the disk to use as the root folder for this instance of the component
includeStyles (boolean, default: true) Whether to include the base October styles or not (october.css, storm.css)
allowUploads (boolean, default: false) Whether or not to allow uploads

This component can be customized further by copying partials from /modules/backend/widgets/mediamanager/partials to /themes/myactivetheme/partials/componentAlias/ (for a specific alias of the component) or /themes/myactivetheme/partials/fileBrowser/ (for the component in general) and modifying as required.

NOTE: These partials are backend partials that use PHP, not frontend partials that use Twig.

Protecting the component

To protect this component from being access by unauthorized users, you can put it on a page with the session component from RainLab.User.

Storage Disks

As stated above, this plugin supports any storage disk / driver that Laravel supports. This includes built in disks / drivers like local or ftp but also includes custom drivers like SFTP, AWS S3, Rackspace, Microsoft Azure Blob Storage, Dropbox, and even Google Drive

NOTE: These drivers need to be installed and configured separately before they can be used for this plugin

Reporting Issues

If you find a bug in this plugin, or would like a feature added, please use the public repository's Issues section. If you find a security vulnerability or have an urgent issue that needs to be addressed, please contact me directly at [email protected].

About

Public repo for LukeTowers.EasyFiles

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages