Merge pull request #597 from symfony-cmf/ensure_cms_routes_is_created

as the initializer is only run when sonata is present, ensure users create /cms/routes themselves

Author: wouterj

book/routing.rst

@@ -453,6 +453,7 @@ follows::
     use Doctrine\Common\Persistence\ObjectManager;
     use Symfony\Cmf\Bundle\RoutingBundle\Doctrine\Phpcr\Route;
     use Symfony\Cmf\Bundle\ContentBundle\Doctrine\Phpcr\StaticContent;
+    use PHPCR\Util\NodeHelper;
 
     class LoadRoutingData implements FixtureInterface
     {
@@ -466,6 +467,8 @@ follows::
                 throw new \RuntimeException("Fixture requires a PHPCR ODM DocumentManager instance, instance of '$class' given.");
             }
 
+            NodeHelper::createPath($session, '/cms/routes');
+
             $route = new Route();
             $route->setParentDocument($dm->find(null, '/cms/routes'));
             $route->setName('projects');
@@ -491,6 +494,15 @@ follows::
 This will give you a document that matches the URL ``/projects/<number>`` but
 also ``/projects`` as there is a default for the id parameter.
 
+.. caution::
+
+    As you can see, the code explicitely creates the ``/cms/routes`` path.
+    The RoutingBundle only creates this path automatically if the Sonata Admin
+    was enabled in the routing configuration using an :ref:`initializer
+    <phpcr-odm-repository-initializers>`. Otherwise, it'll assume you do
+    something yourself to create the path (by configuring an initializer or
+    doing it in a fixture like this).
+
 Because you defined the ``{id}`` route parameter, your controller can expect an
 ``$id`` parameter. Additionally, because you called setRouteContent on the
 route, your controller can expect the ``$contentDocument`` parameter.

bundles/routing/configuration.rst

@@ -441,6 +441,13 @@ is not what you want, as the created node is of type 'Generic' and sometimes thi
 already needs to be a route (for the homepage). Set this to false to disable the
 initializer when you create your nodes your self (e.g. using Alice_).
 
+.. caution::
+
+    Initializers are forced to be disabled when Sonata Admin is not enabled.
+    In such cases, you might have multiple route basepaths which are created
+    by other sources. If the route basepath isn't created by another source,
+    you have to configure an :ref:`initializer <phpcr-odm-repository-initializers>`.
+
 orm
 """