Download the PHP package redkite-labs/redkite-labs-elfinder-bundle without Composer
On this page you can find all versions of the php package redkite-labs/redkite-labs-elfinder-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download redkite-labs/redkite-labs-elfinder-bundle
More information about redkite-labs/redkite-labs-elfinder-bundle
Files in redkite-labs/redkite-labs-elfinder-bundle
Package redkite-labs-elfinder-bundle
Short Description The ElFinderBundle encapsulates the elFinder file manager to be used in Symfony2.
License MIT
Homepage http://redkite-labs.com
Informations about the package redkite-labs-elfinder-bundle
ElFinderBundle
The ElFinderBundle encapsulates the elFinder file manager to be used in Symfony2.
Installation
Clone this bundle in the vendor/bundles/RedKiteLabs directory:
git clone git://github.com/RedKiteLabs/ElFinderBundle.git vendor/bundles/RedKiteLabs/ElFinderBundle
OR (if you're using deps file)
Add the following to the deps file:
Now use the vendors script to clone the newly added repositories into your project:
Configure the ElFinderBundle
Open the AppKernel configuration file and add the bundle to the registerBundles() method:
public function registerBundles()
{
$bundles = array(
...
new RedKiteLabs\ElFinderBundle\RedKiteLabsElFinderBundle(),
)
}
Register the ElFinderBundle namespaces in app/autoload.php
:
$loader->registerNamespaces(array(
...
'RedKiteLabs' => __DIR__.'/../vendor/bundles',
));
Import the routing configuration into the routing.yml file:
_RedKiteLabsElFinderBundle:
resource: "@RedKiteLabsElFinderBundle/Resources/config/routing.yml"
Register the bundle into the Assetic bundles in config.yml:
# Assetic Configuration
assetic:
bundles: [ "RedKiteLabsElFinderBundle" ]
Initialize submodules grabbing the ElFinder vendor library. Move inside the ElFinder folder than give this commands:
git submodule init
git submodule update
To complete the bundle configuration you must install assets as follows:
app/console assets:install web
app/console assetic:dump
Using the object
RedKiteLabsElFinderBundle provides a ready to use controller to display the ElFinder:
http://[yoursite]/al_showElFinder
Customize elFinder
The default connector has a very minimal configuration, so you would like to configure it on your needs. The elFinder object is loaded into the show.html.twig template, where all the required assets and initial jquery script are added. To change the configuration you shoud create a new twig template that extends the base one:
/path/to/your/twig/template
{% extends 'RedKiteLabsElFinderBundle:ElFinder:show.html.twig' %}
This template has four blocks you may override:
{% block stylesheet_files %}{% endblock %}
{% block javascript_files %}{% endblock %}
{% block init_script %}{% endblock %}
{% block elfinder_html %}{% endblock %}
The names speak themselves, so if you need to change the init script, you just have to override the init_script block:
{% block init_script %}
<script type="text/javascript" charset="utf-8">
$(document).ready(function() {
$('<div/>').dialogelfinder({
url : '/al_elFinderMediaConnect',
lang : 'en',
width : 840,
destroyOnClose : true
}).dialogelfinder('instance');
});
</script>
{% endblock %}
Read the elFinder documentation to learn more on the available options
The connector
The url option declares the connector to use. It is the class where are defined the elFinder options, like the folder where are saved the files and so on. In the example above the al_elFinderMediaConnect route is called and the action implementstion might be:
public function connectMediaAction()
{
$connector = $this->container->get('el_finder_media_connector');
$connector->connect();
}
You may notice that the connector has been injected into the Dependency Injector Container, and its implementation is:
<parameters>
<parameter key="el_finder.media_connector">Path\To\RedKiteLabsElFinderMediaConnector</parameter>
</parameters>
<services>
<service id="el_finder_connector" class="%el_finder.media_connector%">
<argument type="service" id="service_container" />
</service>
</services>
The class RedKiteLabsElFinderMediaConnector is instantiated into the DIC. Follows a sample of its implementation:
namespace Path\To\RedKiteLabsElFinderMediaConnector;
use RedKiteLabs\ElFinderBundle\Core\Connector\RedKiteLabsElFinderBaseConnector;
class RedKiteLabsElFinderMediaConnector extends RedKiteLabsElFinderBaseConnector
{
protected function configure()
{
$request = $this->container->get('request');
$options = array(
'roots' => array(
array(
'driver' => 'LocalFileSystem', // driver for accessing file system (REQUIRED)
'path' => 'bundles/RedKiteLabselfinder/files/', // path to files (REQUIRED)
'URL' => $request->getScheme().'://'.$request->getHttpHost() . '/bundles/RedKiteLabselfinder/files/', // URL to files (REQUIRED)
'accessControl' => 'access' // disable and hide dot starting files (OPTIONAL)
)
)
);
return $options;
}
}
The connector extends the RedKiteLabsElFinderBaseConnector which requires the derived class to implement a configure() method where the elFinder connector's options must be declared. This function must return an array of options.