Merge pull request #440 from symfony-cmf/media-doc

improve mediabundle documentation

Author: wouterj

bundles/media/adapters/elfinder.rst

@@ -13,9 +13,8 @@ implementing the MediaBundle interfaces.
 Installation
 ~~~~~~~~~~~~
 
-1. *FMElfinderBundle* - Follow the installation instructions from the
-   `FMElfinderBundle documentation`_.
-2. *FMElfinderBundle* - Use the MediaBundle adapter:
+1. Install the FMElfinderBundle according to the `FMElfinderBundle documentation`_.
+2. Configure the FMElfinderBundle to use the MediaBundle adapter:
 
    .. configuration-block::
 
@@ -74,8 +73,15 @@ Installation
                ),
            ));
 
-3. *LiipImagineBundle* - When using LiipImagineBundle, add an imagine filter
-   for the thumbnails:
+.. note::
+
+    The driver service depends on your storage layer. For now, the MediaBundle
+    only provides a PHPCR driver. To make the above configuration work, you
+    need to enable PHPCR either globally on ``cmf_core.persistence:phpcr`` or,
+    if you only use the MediaBundle, directly on the bundle at
+    ``cmf_media.persistence.phpcr``.
+
+3. When using the LiipImagineBundle, add an imagine filter for the thumbnails:
 
    .. configuration-block::
 
@@ -131,7 +137,7 @@ Installation
                ),
            ));
 
-4. Test the elFinder browser by navigating to: http://localhost:8000/app_dev.php/elfinder
+4. Test the elFinder browser by navigating to: http://<yoursite>/app_dev.php/elfinder
 
 .. _`elFinder`: http://elfinder.org
 .. _`FMElfinderBundle`: https://github.com/helios-ag/FMElfinderBundle

bundles/media/introduction.rst

@@ -87,9 +87,14 @@ Installation
 
            return $collection;
 
-3. Run the ``doctrine:phpcr:repository:init`` command, it runs all tagged
-   :ref:`phpcr-odm-repository-initializers` including the MediaBundle
-   initializer.
+3. For now, the only supported persistence layer is PHPCR. If you enabled PHPCR
+   on the CoreBundle, you need to do nothing here. If you do not have the
+   CMF CoreBundle in your project, you need to configure
+   ``cmf_media.persistence.phpcr.enabled: true``.
+
+4. For PHPCR, run the ``doctrine:phpcr:repository:init`` command, to have the
+   base paths initialized, using the
+   :ref:`repository initializers <phpcr-odm-repository-initializers>`.
 
 Interfaces
 ----------