helios-ag/fm-rfm-bundle

FMRichfilemanager bundle, adds Richfilemanager file manager to your Symfony project

FMRFMBundle

RichfileManager integration in Symfony, _(*1)

Code Quality Assurance

TravisCI	License	Version	Downloads

RichfileManager An open-source file manager. http://fm.devale.pro, _(*2)

Table of contents, _(*3)

• 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, _(*4)

{
    "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, _(*5)

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

Add composer script, _(*6)

"FM\\RFMBundle\\Composer\\RFMScriptHandler::copy",, _(*7)

to scripts section of composer.json, _(*8)

{
  "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, _(*9)

Now tell composer to download the bundle by running the command:, _(*10)

composer update helios-ag/fm-rfm-bundle

Step 2: Enable the bundle

Enable the bundle in the kernel:, _(*11)

<?php
// app/AppKernel.php

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

Step 3: Import FMRFMBundle routing file

``` yaml, <sub>(*12)</sub>

app/config/routing.yml

rfm: resource: "@FMRFMBundle/Resources/config/routing.yml", <sub>(*13)</sub>

### Step 4: Configure your application's security.yml

Secure RFM with access_control:
``` yaml
# 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), <sub>(*14)</sub>

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., <sub>(*15)</sub>

Bundle provides custom form type, RFMType (provides same functionality as in FMElfinderBundle) and integration with CKEditor out of the box., <sub>(*16)</sub>