Download the PHP package elendev/roxyfileman-bundle without Composer
On this page you can find all versions of the php package elendev/roxyfileman-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download elendev/roxyfileman-bundle
More information about elendev/roxyfileman-bundle
Files in elendev/roxyfileman-bundle
Package roxyfileman-bundle
Short Description Provides a Roxyfileman integration for your Symfony2 Project, mainly for ckeditor and tinymce.
License MIT
Informations about the package roxyfileman-bundle
README
The bundle provide a Roxyfileman integration for Symfony2. It works well with IvoryCKEditorBundle.
Documentation
- Installation
- Configuration
- File location configuration
- Roxyfileman configuration
- Multiple profiles
- Advanced customization
- Custom filesystem service
- Custom version of Roxyfileman
- LICENSE
Installation
Require the bundle in your composer.json file:
Register the bundle :
Update composer :
Import the bundle's routes to your routing configuration file, e.g. routing.yml
:
The prefix can be changed. You can also add the path to the firewall to have the file manager service protected.
Configuration
RoxyFilemanBundle provide a simple configuration.
File location configuration
If you use the default LocalFileSystem
(recommanded), this is the required configuration :
The base_path
parameter should be absolute. The base_url
parameter is appended to the file name / relative file path to create its url.
The LocalFileSystem
is used to access to a certain directory in the local file system. If you want to serve file from a distant server or located in database, you can take a look at the Custom filesystem service section.
Roxyfileman configuration
Every configuration options are available on the Roxyfileman configuration page.
The parameters have to be in lowercase.
Be careful : every url parameter available on the Roxyfileman configuration page should be used as a route here and the parameter have to be postfixed by _route
. For example : the parameter DIRLIST
becomes dirlist_route
.
Multiple profiles
Above shows how the bundle work in single profile mode. Occasionally, you may need different file manager instances to manage different directories - imagine a CMS with a "album" and a "blog" module, and you don't want the "album" administrator to touch the files in the "blog" module. This is possible by telling the bundle to operate in multi-profile mode. Here's how:
Now we have two profiles defined, each with its own base path, URL settings, and configuration options.
The bundle needs to know which profile it should work on when its certain URL is accessed. One way is to add the profile
placeholder to the routing config:
Note: When profiles
is not empty, the bundle will operate in multi-profile mode. conf
, local_file_system
and file_system_service_id
values defined in the root configuration will be ignored.
Integration with rich text editor (CKEditor)
The original index path /fileman/index.html
is served by the route elendev_roxyfileman_index
in this bundle, and is what you need to integrate with rich text editors like CKEditor. For example:
Using this bundle with egeloen/IvoryCKEditorBundle
is really simple, a small modification to the ivory_ck_editor
configuration do the job :
Advanced customization
Custom filesystem service
The filesystem
service represent a file system for Roxyfileman. It is capable of serving files, file and directory trees, do operations on directories and files, ...
You can create a custom filesystem service by implementing the Elendev\RoxyFilemanBundle\FileSystem\FileSystemInterface
and provide it as a service to the elendev_roxy_fileman
parameter.
Custom version of Roxyfileman
The bundle comes with a version of Roxyfileman library. If you want to use a custom version, you can specify the path to the directory containing the index.html
file to the roxyfileman_lib_path
parameter.
The library files are served by the Elendev\RoxyFilemanBundle\Controller\ResourcesController.php
controller. It don't have to be publicly accessible.
LICENCE
The Elendev RoxyFileman BUndle is under the MIT license. For the full copyright and license information, please read the LICENSE file that was distributed with this source code.
A partial copy of Roxyfileman library is bundled with this bundle. The Roxyfileman library is under the GPLv3 license was distributed with this source code.