Add a method to load a location at a specific version

WrapperBundle/Core/Repository.php

@@ -171,6 +171,21 @@ public function loadEntityFromLocation(Location $location)
         return $this->enrichEntityAtLoad($entity);
     }
 
+    /**
+     * This method is useful f.e. when you want to create an Entity that matches a given version and specific location.
+     * This happens notably when doing content previews, where eZ will inject into your controllers both of them.
+     *
+     * @param Content $content
+     * @param Location $location
+     * @return \Kaliop\eZObjectWrapperBundle\Core\EntityInterface
+     */
+    public function loadEntityFromContentAndLocation(Content $content, Location $location)
+    {
+        $class = $this->entityClass;
+        $entity = new $class($this->repository, $content, $location);
+        return $this->enrichEntityAtLoad($entity);
+    }
+
     /**
      * @param ContentInfo $contentInfo
      * @return \Kaliop\eZObjectWrapperBundle\Core\EntityInterface

WrapperBundle/Core/RepositoryInterface.php

@@ -68,6 +68,16 @@ public function loadEntityFromContentRemoteId($remoteId);
      */
     public function loadEntityFromLocationRemoteId($remoteId);
 
+    /**
+     * This method is useful f.e. when you want to create an Entity that matches a given version and specific location.
+     * This happens notably when doing content previews, where eZ will inject into your controllers both of them.
+     *
+     * @param Content $content
+     * @param Location $location
+     * @return \Kaliop\eZObjectWrapperBundle\Core\EntityInterface
+     */
+    public function loadEntityFromContentAndLocation(Content $content, Location $location);
+
     /**
      * Called by the Entity Manager when retrieving the repo service / creating the repo instance
      * @param string $contentTypeIdentifier

news.md

@@ -1,3 +1,12 @@
+Ver 4.0
+
+* added a new method to the base Repository Class and Interface: `loadEntityFromContentAndLocation`
+    This method is useful f.e. when you want to create an Entity that matches a given version and specific location;
+    that happens notably when doing content previews, where eZ will inject into your controllers both of them.
+
+    Since we changed an Interface, we consider this to be an API breackage, and had to increase the major version nr.
+
+
 Ver 3.1
 
 * added a new Trait to allow to easily get related Entities of an existing entity