PHPackages elendev/roxyfileman-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. elendev/roxyfileman-bundle ActiveSymfony-bundle[Utility & Helpers](/categories/utility) elendev/roxyfileman-bundle ========================== Provides a Roxyfileman integration for your Symfony2 Project, mainly for ckeditor and tinymce. 1.3.0(8y ago)38.6k1[2 issues](https://github.com/Elendev/ElendevRoxyFilemanBundle/issues)1MITJavaScriptPHP >=5.3.3 Since Jan 26Pushed 8y ago1 watchersCompare [ Source](https://github.com/Elendev/ElendevRoxyFilemanBundle)[ Packagist](https://packagist.org/packages/elendev/roxyfileman-bundle)[ RSS](/packages/elendev-roxyfileman-bundle/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (3)Dependencies (1)Versions (5)Used By (1) README ====== [](#readme) The bundle provide a [Roxyfileman](http://www.roxyfileman.com/) integration for Symfony2. It works well with [IvoryCKEditorBundle](https://github.com/egeloen/IvoryCKEditorBundle). Documentation ------------- [](#documentation) 1. [Installation](#installation) 2. [Configuration](#configuration) 3. [File location configuration](#file-location-configuration) 4. [Roxyfileman configuration](#roxyfileman-configuration) 5. [Multiple profiles](#multiple-profiles) 6. [Advanced customization](#advanced-customization) 7. [Custom filesystem service](#custom-filesystem-service) 8. [Custom version of Roxyfileman](#custom-version-of-roxyfileman) 9. [LICENSE](#license) Installation ------------ [](#installation) Require the bundle in your composer.json file: ``` { "require": { "elendev/roxyfileman-bundle": "~1.0" } } ``` Register the bundle : ``` // app/AppKernel.php public function registerBundles() { return array( new Elendev\RoxyFilemanBundle\ElendevRoxyFilemanBundle(), // ... ); } ``` Update composer : ``` $ composer update ``` Import the bundle's routes to your routing configuration file, e.g. `routing.yml`: ``` ElendevRoxyFilemanBundle: resource: "@ElendevRoxyFilemanBundle/Resources/config/routing.yml" prefix: /elendev-roxyfileman ``` The prefix can be changed. You can also add the path to the firewall to have the file manager service protected. Configuration ------------- [](#configuration) RoxyFilemanBundle provide a simple configuration. ### File location configuration [](#file-location-configuration) If you use the default `LocalFileSystem` (recommanded), this is the **required configuration** : ``` elendev_roxy_fileman: local_file_system: base_path: /path/to/your/file base_url: /url/to/the/base/path ``` 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](#custom-filesystem-service) section. ### Roxyfileman configuration [](#roxyfileman-configuration) Every configuration options are available on the [Roxyfileman configuration page](http://www.roxyfileman.com/install). ``` elendev_roxy_fileman: conf: dirlist_route: elendev_roxyfileman_dir_list files_root: ... ``` The parameters have to be in lowercase. **Be careful** : every url parameter available on the [Roxyfileman configuration page](http://www.roxyfileman.com/install) 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 [](#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: ``` elendev_roxy_fileman: profiles: # Triggers multi-profile mode album: # Name of the profile local_file_system: base_path: /path/to/album/directory base_url: /web/album/directory conf: integration: tinymce4 blog: local_file_system: base_path: /path/to/blog/directory base_url: /web/blog/directory conf: integration: tinymce4 ``` 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: ``` ElendevRoxyFilemanBundle: resource: "@ElendevRoxyFilemanBundle/Resources/config/routing.yml" prefix: /elendev-roxyfileman/{profile} requirements: profile: blog|album ``` **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) [](#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: ``` $(function(){ CKEDITOR.replace( 'editor1', { // Single profile mode filebrowserBrowseUrl: '{{ path('elendev_roxyfileman_index') }}', // To specify the profile name in multi-profile mode: // filebrowserBrowseUrl: '{{ path('elendev_roxyfileman_index', { 'profile': 'blog' }) }}', filebrowserImageBrowseUrl: '{{ path('elendev_roxyfileman_index') }}?type=image', removeDialogTabs: 'link:upload;image:upload' }); }); ``` Using this bundle with `egeloen/IvoryCKEditorBundle` is really simple, a small modification to the `ivory_ck_editor` configuration do the job : ``` ivory_ck_editor: default_config: default configs: default: filebrowserBrowseRoute: elendev_roxyfileman_index ``` Advanced customization ---------------------- [](#advanced-customization) ### Custom filesystem service [](#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. ``` elendev_roxy_fileman: file_system_service_id: id_of_the_file_service ``` ### Custom version of Roxyfileman [](#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. ``` elendev_roxy_fileman: roxyfileman_lib_path: /path/to/the/library ``` The library files are served by the `Elendev\RoxyFilemanBundle\Controller\ResourcesController.php` controller. It don't have to be publicly accessible. LICENCE ------- [](#licence) The Elendev RoxyFileman BUndle is under the MIT license. For the full copyright and license information, please read the [LICENSE](LICENSE) file that was distributed with this source code. A partial copy of [Roxyfileman](http://www.roxyfileman.com) library is bundled with this bundle. The [Roxyfileman](http://www.roxyfileman.com) library is under the [GPLv3](Resources/doc/licenses/gpl-3.0.txt) license. A copy of the [GPLv3](Resources/doc/licenses/gpl-3.0.txt) license was distributed with this source code. ### Health Score 29 — LowBetter than 59% of packages Maintenance7 Infrequent updates — may be unmaintained Popularity24 Limited adoption so far Community14 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 57.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~379 days Total 4 Last Release 2990d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/2f3d01822621b80f6102d24f68e9a0ff2221d98a272ccd5c78c405d19621f475?d=identicon)[Elendev](/maintainers/Elendev) --- Top Contributors [![Elendev](https://avatars.githubusercontent.com/u/1331273?v=4)](https://github.com/Elendev "Elendev (12 commits)")[![tamcy](https://avatars.githubusercontent.com/u/959433?v=4)](https://github.com/tamcy "tamcy (8 commits)")[![danielfharmonic](https://avatars.githubusercontent.com/u/6092913?v=4)](https://github.com/danielfharmonic "danielfharmonic (1 commits)") --- Tags CKEditortinymceroxyfileman ### Embed Badge ![Health badge](/badges/elendev-roxyfileman-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/elendev-roxyfileman-bundle/health.svg)](https://phpackages.com/packages/elendev-roxyfileman-bundle) ``` ### Alternatives [stfalcon/tinymce-bundle This Bundle integrates TinyMCE WYSIWYG editor into a Symfony2 project. 2692.9M24](/packages/stfalcon-tinymce-bundle)[egeloen/ckeditor-bundle Provides a CKEditor integration for your Symfony2 Project. 3325.1M45](/packages/egeloen-ckeditor-bundle)[trsteel/ckeditor-bundle Symfony bundle for easy integration of the CKEditor WYSIWYG 99630.9k9](/packages/trsteel-ckeditor-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)