README

RichfileManager integration in Symfony

Code Quality Assurance

TravisCI	License	Version	Downloads
👁 Build Status	👁 License	👁 Latest Stable Version	👁 Total Downloads

RichfileManager An open-source file manager. http://fm.devale.pro

Table of contents

• Installation
  • Step 1: Installation
  • Step 2: Enable the bundle
  • Step 3: Import FMRFMBundle routing file
  • Step 4: Securing paths

Installation

Step 1: Installation

Add FMRFMBundle to your composer.json

{
 "require": {
 "helios-ag/fm-rfm-bundle": "~1"
 }
}

If you want to override default assets directory of Richfilemanager, add next option. By default assets copied to web/assets/richfilemanager or public/assets/richfilemanager depending on Symfony version

{
 "config": {
 "rfm-dir": "web/assets/richfilemanager/"
 }
}

Add composer script

"FM\\RFMBundle\\Composer\\RFMScriptHandler::copy",

to scripts section of composer.json

{
 "scripts": {
 "symfony-scripts": [
 "Incenteev\\ParameterHandler\\ScriptHandler::buildParameters",
 "Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::buildBootstrap",
 "Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::clearCache",
 "FM\\RFMBundle\\Composer\\RFMScriptHandler::copy",
 "Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::installAssets",
 "Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::installRequirementsFile",
 "Sensio\\Bundle\\DistributionBundle\\Composer\\ScriptHandler::prepareDeploymentTarget"
 ]
 }
}

Also you can copy assets manually. Copy dirs: 'config, 'images', 'languages', 'libs', 'src', 'themes' from vendor/servocoder/richfilemanager/ to your public assets directory

Now tell composer to download the bundle by running the command:

composer update helios-ag/fm-rfm-bundle

Step 2: Enable the bundle

Enable the bundle in the kernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
 $bundles = array(
 // ...
 new FM\RFMBundle\FMRFMBundle(),
 );
}

Step 3: Import FMRFMBundle routing file

# app/config/routing.yml
rfm:
 resource: "@FMRFMBundle/Resources/config/routing.yml"

Step 4: Configure your application's security.yml

Secure RFM with access_control:

# app/config/security.yml
security:

 //....
 access_control:
 - { path: ^/rfm_show, role: ROLE_USER }
 - { path: ^/rfm_run, role: ROLE_USER }
 - { path: ^/rfm_config.json, role: ROLE_USER }
 - { path: ^/rfm_config_default.json, role: ROLE_USER }

Basic configuration

Add configuration options to your config.yml

Example below (assumed that richfilemanager assets placed in web/assets/richfilemanager directory)

fm_rfm:
 instances:
 default:
 options:
 serverRoot: true
 fileRoot: /uploads

You can see the full list of roots options here. To use them, convert camelCased option names to snake_cased names.

Bundle provides custom form type, RFMType (provides same functionality as in FMElfinderBundle) and integration with CKEditor out of the box.