Propose some contributions developed for my project

src/PhpPresentation/AbstractShape.php

@@ -103,13 +103,26 @@ abstract class AbstractShape implements ComparableInterface
      */
     protected $placeholder;
 
+    /**
+     * List of effect apply to shape
+     * @var array \PhpOffice\PhpPresentation\Style\Effect[]
+     */
+    protected ?array $effectCollection = null;
+
     /**
      * Hash index
      *
      * @var string
      */
     private $hashIndex;
 
+    /**
+     * Name
+     *
+     * @var string
+     */
+    protected $name;
+
     /**
      * Create a new self
      */
@@ -122,9 +135,11 @@ public function __construct()
         $this->width = 0;
         $this->height = 0;
         $this->rotation = 0;
+        $this->name = '';
         $this->fill = new Style\Fill();
         $this->border = new Style\Border();
         $this->shadow = new Style\Shadow();
+        $this->effectCollection = null;
 
         $this->border->setLineStyle(Style\Border::LINE_NONE);
     }
@@ -135,9 +150,27 @@ public function __construct()
     public function __clone()
     {
         $this->container = null;
-        $this->fill = clone $this->fill;
-        $this->border = clone $this->border;
-        $this->shadow = clone $this->shadow;
+        $this->name = $this->name;
+        if (isset($this->fill)) {
+          $this->fill = clone $this->fill;
+        }
+        if (isset($this->border)) {
+          $this->border = clone $this->border;
+        }
+        if (isset($this->shadow)) {
+          $this->shadow = clone $this->shadow;
+        }
+        if (isset($this->placeholder)) {
+          $this->placeholder = clone $this->placeholder;
+        }
+        if (isset($this->hyperlink)) {
+          $this->hyperlink = clone $this->hyperlink;
+        }
+        // Clone each effect
+        if (isset($this->effectCollection)) {
+          foreach ($this->effectCollection as &$effect) {
+            $effect = clone $effect;
+        }}
     }
 
     /**
@@ -190,6 +223,28 @@ public function setContainer(ShapeContainerInterface $pValue = null, $pOverrideO
         return $this;
     }
 
+    /**
+     * Get Name
+     *
+     * @return string
+     */
+    public function getName()
+    {
+        return $this->name;
+    }
+
+    /**
+     * Set Name
+     *
+     * @param  string                          $pValue
+     * @return \PhpOffice\PhpPresentation\Shape\AbstractGraphic
+     */
+    public function setName($pValue = '')
+    {
+        $this->name = $pValue;
+        return $this;
+    }
+
     /**
      * Get OffsetX
      *
@@ -407,6 +462,46 @@ public function setHyperlink(Hyperlink $pHyperlink = null)
         $this->hyperlink = $pHyperlink;
         return $this;
     }
+
+    /**
+     * Add an effect to the shpae
+     * 
+     * @param \PhpOffice\PhpPresentation\Style\Effect $effect
+     * @return $this
+     */
+    public function addEffect(Shape\Effect $effect)
+    {
+      if (!isset($this->effectCollection)) {
+        $this->effectCollection = array();
+      }
+      $this->effectCollection[] = $effect;
+      return $this;
+    }
+
+    /**
+     * Get the effect collection
+     * 
+     * @return array \PhpOffice\PhpPresentation\Style\Effect[]
+     */
+    public function getEffectCollection():?array
+    {
+      return $this->effectCollection;
+    }
+
+    /**
+     * Set the effect collection
+     * 
+     * @param array \PhpOffice\PhpPresentation\Style\Effect $effectCollection
+     * @return $this
+     */
+    public function setEffectCollection(array $effectCollection)
+    {
+      if (   isset($effectCollection)
+          && is_array($effectCollection)) {
+        $this->effectCollection = $effectCollection;
+      }
+      return $this;
+    }
 
     /**
      * Get hash code

src/PhpPresentation/DocumentProperties.php

@@ -91,7 +91,20 @@ class DocumentProperties
      * @var string
      */
     private $company;
-
+
+    /**
+     * revision
+     *
+     * @var string
+     */
+    private $revision;
+
+    /**
+     * status
+     *
+     * @var string
+     */
+    private $status;
     /**
      * Create a new \PhpOffice\PhpPresentation\DocumentProperties
      */
@@ -108,6 +121,8 @@ public function __construct()
         $this->keywords       = '';
         $this->category       = '';
         $this->company        = 'Microsoft Corporation';
+        $this->revision       = '';
+        $this->status         = '';
     }
 
     /**
@@ -345,4 +360,50 @@ public function setCompany($pValue = '')
 
         return $this;
     }
+
+    /**
+     * Get Revision
+     *
+     * @return string
+     */
+    public function getRevision()
+    {
+        return $this->revision;
+    }
+
+    /**
+     * Set Revision
+     *
+     * @param  string                           $pValue
+     * @return \PhpOffice\PhpPresentation\DocumentProperties
+     */
+    public function setRevision($pValue = '')
+    {
+        $this->revision = $pValue;
+
+        return $this;
+    }
+
+    /**
+     * Get Status
+     *
+     * @return string
+     */
+    public function getStatus()
+    {
+        return $this->status;
+    }
+
+    /**
+     * Set Status
+     *
+     * @param  string                           $pValue
+     * @return \PhpOffice\PhpPresentation\DocumentProperties
+     */
+    public function setStatus($pValue = '')
+    {
+        $this->status = $pValue;
+
+        return $this;
+    }
 }

src/PhpPresentation/PresentationProperties.php

@@ -29,6 +29,8 @@ class PresentationProperties
     const VIEW_SLIDE_MASTER = 'sldMasterView';
     const VIEW_SLIDE_SORTER = 'sldSorterView';
     const VIEW_SLIDE_THUMBNAIL = 'sldThumbnailView';
+    const THUMBNAIL_FILE = 'file'; // Thumbnail path is out of PPT
+    const THUMBNAIL_ZIP = 'zip'; // Thumbnail path point to an image store into file loaded
 
     protected $arrayView = array(
         self::VIEW_HANDOUT,
@@ -53,9 +55,19 @@ class PresentationProperties
     protected $markAsFinal = false;
 
     /*
-     * @var string
+     * @var string Define the thumbnail content (if content into zip file)
+     */
+    protected $thumbnail = null;
+
+    /*
+     * @var string Define the thumbnail place
+     */
+    protected $thumbnailPath = '';
+
+    /*
+     * @var string Define if thumbnail is out of PPT or previouly store into PPT
      */
-    protected $thumbnail;
+    protected $thumbnailType = self::THUMBNAIL_FILE;
 
     /**
      * Zoom
@@ -99,22 +111,57 @@ public function setLoopContinuouslyUntilEsc($value = false)
      */
     public function getThumbnailPath()
     {
+        return $this->thumbnailPath;
+    }
+
+    /**
+     * Return the content of thumbnail
+     *
+     * @return binary Content of image
+     */
+    public function getThumbnail()
+    {
+      // Return content of local file
+      if ($this->getThumbnailType() == self::THUMBNAIL_FILE) {
+        if (file_exists($this->getThumbnailPath()))
+          return file_get_contents($this->getThumbnailPath());
+      }
+      // Return content of image stored into zip file
+      if ($this->getThumbnailType() == self::THUMBNAIL_ZIP) {
         return $this->thumbnail;
+      }
+      // Return null if no thumbnail
+      return null;
     }
 
     /**
      * Define the path for the thumbnail file / preview picture
      * @param string $path
      * @return \PhpOffice\PhpPresentation\PresentationProperties
      */
-    public function setThumbnailPath($path = '')
+    public function setThumbnailPath($path = '', $type = self::THUMBNAIL_FILE, $content = null)
     {
-        if (file_exists($path)) {
-            $this->thumbnail = $path;
+        if (file_exists($path) && ($type == self::THUMBNAIL_FILE)) {
+            $this->thumbnailPath = $path;
+            $this->thumbnailType = $type;
+        }
+        if (($path != '') && ($type == self::THUMBNAIL_ZIP)) {
+            $this->thumbnailPath = $path;
+            $this->thumbnailType = $type;
+            $this->thumbnail = $content;
         }
         return $this;
     }
 
+    /**
+     * Return the thumbnail type
+     * @return string
+     */
+    public function getThumbnailType()
+    {
+        return $this->thumbnailType;
+    }
+
     /**
      * Mark a document as final
      * @param bool $state