PHPackages softwaresystem/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. softwaresystem/roxyfileman-bundle ActiveSymfony-bundle[Utility & Helpers](/categories/utility) softwaresystem/roxyfileman-bundle ================================= Provides a Roxyfileman integration for your Symfony5 Project, mainly for FOSckeditor. 0100JavaScript Since Dec 21Pushed 5y ago1 watchersCompare [ Source](https://github.com/softwaresystempl/SoftwareSystemplRoxyFilemanBundle)[ Packagist](https://packagist.org/packages/softwaresystem/roxyfileman-bundle)[ RSS](/packages/softwaresystem-roxyfileman-bundle/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependenciesVersions (1)Used By (0) README ====== [](#readme) The bundle provide a [Roxyfileman](http://www.roxyfileman.com/) integration for Symfony5. It works well with [ FOSCKEditorBundle ](https://symfony.com/doc/current/bundles/FOSCKEditorBundle/installation.html). 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": { "softwaresystem/roxyfileman-bundle": "~1.0" } } ``` Register the bundle : ``` // app/AppKernel.php public function registerBundles() { return array( new Softwaresystem\RoxyFilemanBundle\SoftwaresystemRoxyFilemanBundle(), // ... ); } ``` Update composer : ``` $ composer update ``` Import the bundle's routes to your routing configuration file, e.g. `routing.yml`: ``` SoftwaresystemRoxyFilemanBundle: resource: "@SoftwaresystemRoxyFilemanBundle/Resources/config/routing.yml" prefix: /softwaresystem-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** : ``` softwaresystem_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). ``` softwaresystem_roxy_fileman: conf: dirlist_route: softwaresystem_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: ``` softwaresystem_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: ``` SoftwaresystemRoxyFilemanBundle: resource: "@SoftwaresystemRoxyFilemanBundle/Resources/config/routing.yml" prefix: /Softwaresystem-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 `softwaresystem_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('softwaresystem_roxyfileman_index') }}', // To specify the profile name in multi-profile mode: // filebrowserBrowseUrl: '{{ path('softwaresystem_roxyfileman_index', { 'profile': 'blog' }) }}', filebrowserImageBrowseUrl: '{{ path('softwaresystem_roxyfileman_index') }}?type=image', removeDialogTabs: 'link:upload;image:upload' }); }); ``` Using this bundle with `FOSCKEditorBundle` is really simple, a small modification to the `fos_ck_editor` configuration do the job : ``` fos_ck_editor: default_config: file_browse configs: file_browse: filebrowserBrowseRoute: softwaresystem_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 `Softwaresystem\RoxyFilemanBundle\FileSystem\FileSystemInterface` and provide it as a service to the `softwaresystem_roxy_fileman` parameter. ``` softwaresystem_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. ``` softwaresystem_roxy_fileman: roxyfileman_lib_path: /path/to/the/library ``` The library files are served by the `Softwaresystem\RoxyFilemanBundle\Controller\ResourcesController.php` controller. It don't have to be publicly accessible. LICENCE ------- [](#licence) The Softwaresystem 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. Original author: This is only mod for Symfony4 ### Health Score 18 — LowBetter than 8% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity31 Early-stage or recently created project Bus Factor1 Top contributor holds 100% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/c54ae110ae4e9cd4e676e5c3fc2b9d7506468580840505cee5987e94459de8c6?d=identicon)[softwaresystempl](/maintainers/softwaresystempl) --- Top Contributors [![softwaresystempl](https://avatars.githubusercontent.com/u/49900724?v=4)](https://github.com/softwaresystempl "softwaresystempl (6 commits)") ### Embed Badge ![Health badge](/badges/softwaresystem-roxyfileman-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/softwaresystem-roxyfileman-bundle/health.svg)](https://phpackages.com/packages/softwaresystem-roxyfileman-bundle) ``` ### Alternatives [kzykhys/parallel Simple multitasking library 93334.1k4](/packages/kzykhys-parallel)[tiny-pixel/acorn-block-templates Block templates for Sage 10 191.2k](/packages/tiny-pixel-acorn-block-templates) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)