Merge pull request #273 from symfony-cmf/issue-272/child-restriction

Configure document's child restrictions

CHANGELOG.md

@@ -3,6 +3,8 @@ Changelog
 
  * **2017-02-10**: [BC BREAK] Removed the `ImagineBlock` as the CmfMediaBundle
    is abandoned.
+ * **2017-02-09**: [BC BREAK] Added child restrictions to the block documents.
+   See the UPGRADE guide for detailed information.
 
 2.0.0-RC1
 ---------

UPGRADE-2.0.md

@@ -1,6 +1,6 @@
 # Upgrade from 1.x to 2.0
 
-## Sonata Admin
+### Sonata Admin
 
  * The SonataAdminBundle integration has been moved to
    `symfony-cmf/sonata-admin-integration-bundle`. This includes the classes in
@@ -66,3 +66,14 @@
 
  * The `ImagineBlock` was removed from this bundle as the CmfMediaBundle is
    abandoned. Implement the block in your own application if you were using it.
+
+### Doctrine PHPCR ODM
+
+ * It is no longer possible to add a child to the `ActionBlock`,
+   `ImagineBlock`, `MenuBlock`, `ReferenceBlock`, `RssBlock`, `SimpleBlock` and
+   `StringBlock` documents. This behaviour can be changed by overriding the
+   `child-class` setting of the PHPCR ODM mapping.
+
+ * Only instances of sonata's `BlockInterface` are allowed as children of the
+   `ContainerBlock` and `SlideshowBlock` documents. This behaviour can be changed
+   by overriding the `child-class` setting of the PHPCR ODM mapping.

composer.json

@@ -15,7 +15,7 @@
         "php": "^5.6|^7.0",
         "symfony/framework-bundle": "^2.8|^3.0",
         "doctrine/phpcr-bundle" :"^1.0",
-        "doctrine/phpcr-odm": "^1.4|^2.0",
+        "doctrine/phpcr-odm": "^1.4.2",
         "sonata-project/block-bundle": "^3.3",
         "symfony-cmf/core-bundle": "^2.0"
     },

src/Resources/config/doctrine-phpcr/ActionBlock.phpcr.xml

@@ -8,6 +8,7 @@
     <document
         name="Symfony\Cmf\Bundle\BlockBundle\Doctrine\Phpcr\ActionBlock"
         referenceable="true"
+        is-leaf="true"
         >
 
         <lifecycle-callbacks>

src/Resources/config/doctrine-phpcr/ContainerBlock.phpcr.xml

@@ -16,6 +16,8 @@
             </cascade>
         </children>
 
+        <child-class name="Sonata\BlockBundle\Model\BlockInterface"/>
+
     </document>
 
 </doctrine-mapping>

src/Resources/config/doctrine-phpcr/MenuBlock.phpcr.xml

@@ -9,6 +9,7 @@
         name="Symfony\Cmf\Bundle\BlockBundle\Doctrine\Phpcr\MenuBlock"
         referenceable="true"
         property="blockMenu"
+        is-leaf="true"
         >
 
         <reference-one name="menuNode"/>

src/Resources/config/doctrine-phpcr/ReferenceBlock.phpcr.xml

@@ -8,6 +8,7 @@
     <document
         name="Symfony\Cmf\Bundle\BlockBundle\Doctrine\Phpcr\ReferenceBlock"
         referenceable="true"
+        is-leaf="true"
         >
 
         <reference-one name="referencedBlock"/>

src/Resources/config/doctrine-phpcr/RssBlock.phpcr.xml

@@ -8,6 +8,7 @@
     <document
         name="Symfony\Cmf\Bundle\BlockBundle\Doctrine\Phpcr\RssBlock"
         referenceable="true"
+        is-leaf="true"
         >
     </document>
 

src/Resources/config/doctrine-phpcr/SimpleBlock.phpcr.xml

@@ -9,6 +9,7 @@
         name="Symfony\Cmf\Bundle\BlockBundle\Doctrine\Phpcr\SimpleBlock"
         referenceable="true"
         translator="attribute"
+        is-leaf="true"
         >
 
         <locale name="locale"/>

src/Resources/config/doctrine-phpcr/SlideshowBlock.phpcr.xml

@@ -15,6 +15,8 @@
 
         <field name="title" type="string" translated="true" nullable="true"/>
 
+        <child-class name="Sonata\BlockBundle\Model\BlockInterface"/>
+
     </document>
 
 </doctrine-mapping>

src/Resources/config/doctrine-phpcr/StringBlock.phpcr.xml

@@ -9,6 +9,7 @@
         name="Symfony\Cmf\Bundle\BlockBundle\Doctrine\Phpcr\StringBlock"
         referenceable="true"
         translator="attribute"
+        is-leaf="true"
         >
 
         <locale name="locale"/>