Merge pull request #230 from Progi1984/issue161

#161 : PowerPoint2007 : Read/Write SlideLayout

Author: Progi1984

CHANGELOG.md

@@ -27,9 +27,11 @@
 - ODPresentation & PowerPoint2007 Writer : Add Font Support For Chart Axis - @jrking4 GH-186
 - ODPresentation & PowerPoint2007 Writer : Support for video - @Progi1984 GH-123
 - ODPresentation & PowerPoint2007 Writer : Support for Visibility for slides - @Progi1984
+- PowerPoint2007 Reader : Layout Management - @vincentKool @Progi1984 GH-161 
 - PowerPoint2007 Writer : Presentation with predefined View Type - @Progi1984 GH-120
 - PowerPoint2007 Writer : Implement alpha channel to Fills - @Dayjo GH-203 / @Progi1984 GH-215
 - PowerPoint2007 Writer : Implement Animations - @JewrassicPark GH-214 / @Progi1984 GH-217
+- PowerPoint2007 Writer : Layout Management - @vincentKool @Progi1984 GH-161 
 
 ## 0.6.0 - 2016-01-24
 

docs/credits.rst

@@ -3,4 +3,6 @@
 Credits
 =======
 
-	Images from chart page come from the `LibreOffice Core <https://github.com/LibreOffice/core/tree/master/icon-themes/galaxy/chart2/res>`.
+	Images from chart page come from the `LibreOffice Core <https://github.com/LibreOffice/core/tree/master/icon-themes/galaxy/chart2/res>`.
+
+    Some definitions come from the `Office Open XML <http://officeopenxml.com/>`.

docs/slides_layout.rst

@@ -0,0 +1,50 @@
+.. _slides_layout:
+
+Slides Layout
+=============
+
+A slide is a hierarchy of three components :
+- The master slide upon which the slide is based : it specifies such properties as the font styles for the title, body, and footer, placeholder positions for text and objects, bullets styles, and background ;
+- The slide layout which is applied to the the slide : it permits to override what is specified in the master slide ;
+- The slide itself : it contains content and formatting that is not already specified by the master slide and the slide layout
+
+Placeholders permit to link these three components together in order that the override is possible.
+
+Master slides
+-------------
+
+You can access to all master slides with the method ``getAllMasterSlides`` or create one with ``createMasterSlide``.
+
+.. code-block:: php
+
+    $arraySlideMasters = $oPHPPresentation->getAllMasterSlides();
+    $oMasterSlide = $oPHPPresentation->createMasterSlide();
+
+Slides Layout
+-------------
+
+You can access to all slide layout from a master with the method ``getAllSlideLayouts`` or create one with ``createSlideLayout``.
+
+.. code-block:: php
+
+    $arraySlideLayouts = $oMasterSlide->getAllSlideLayouts();
+    $oSlideLayout = $oMasterSlide->createSlideLayout();
+
+Placeholders
+------------
+
+For each master slide or slide layout, you can add any shape like on a slide.
+
+.. code-block:: php
+
+    $oShape = $oMasterSlide->createChartShape();
+    $oShape = $oSlideLayout->createTableShape();
+
+You can define a shape as a placeholder for each level with the method ``setPlaceHolder``.
+A shape defined in each level will have an override for its formatting in each level.
+
+.. code-block:: php
+
+    use PhpOffice\PhpPresentation\Shape\Placeholder;
+    $oShape->setPlaceHolder(new Placeholder(Placeholder::PH_TYPE_TITLE));
+

phpmd.xml.dist

@@ -18,8 +18,9 @@
     <rule ref="rulesets/design.xml/DepthOfInheritance" />
     <rule ref="rulesets/design.xml/CouplingBetweenObjects">
         <!-- PptSlides needs more coupling (default: 13) -->
-        <properties>
-            <property name="minimum" value="30" />
+        <!-- Writer/Office2007/AbstractSlide needs more coupling (default: 13) -->
+		<properties>
+            <property name="minimum" value="31" />
         </properties>
     </rule>
     <rule ref="rulesets/design.xml/NumberOfChildren">

samples/Sample_01_Complex.php

@@ -15,7 +15,7 @@
 
 // Set properties
 echo date('H:i:s') . ' Set properties'.EOL;
-$objPHPPresentation->getProperties()->setCreator('PHPOffice')
+$objPHPPresentation->getDocumentProperties()->setCreator('PHPOffice')
                                   ->setLastModifiedBy('PHPPresentation Team')
                                   ->setTitle('Sample 02 Title')
                                   ->setSubject('Sample 02 Subject')

samples/Sample_02_Serialized.php

@@ -13,7 +13,7 @@
 
 // Set properties
 echo date('H:i:s') . ' Set properties'.EOL;
-$objPHPPresentation->getProperties()->setCreator('PHPOffice')
+$objPHPPresentation->getDocumentProperties()->setCreator('PHPOffice')
                                   ->setLastModifiedBy('PHPPresentation Team')
                                   ->setTitle('Sample 03 Title')
                                   ->setSubject('Sample 03 Subject')

samples/Sample_04_Table.php

@@ -13,7 +13,7 @@
 
 // Set properties
 echo date('H:i:s') . ' Set properties'.EOL;
-$objPHPPresentation->getProperties()->setCreator('PHPOffice')
+$objPHPPresentation->getDocumentProperties()->setCreator('PHPOffice')
                                   ->setLastModifiedBy('PHPPresentation Team')
                                   ->setTitle('Sample 06 Title')
                                   ->setSubject('Sample 06 Subject')

samples/Sample_05_Chart.php

@@ -526,7 +526,7 @@ function fnSlide_Scatter(PhpPresentation $objPHPPresentation) {
 
 // Set properties
 echo date('H:i:s') . ' Set properties'.EOL;
-$objPHPPresentation->getProperties()->setCreator('PHPOffice')
+$objPHPPresentation->getDocumentProperties()->setCreator('PHPOffice')
                                   ->setLastModifiedBy('PHPPresentation Team')
                                   ->setTitle('Sample 07 Title')
                                   ->setSubject('Sample 07 Subject')

samples/Sample_05_Chart_with_PHPExcel.php

@@ -19,7 +19,7 @@
 
 	// Set properties
 	echo date('H:i:s') . ' Set properties'.EOL;
-	$objPHPPresentation->getProperties()->setCreator('PHPOffice')
+	$objPHPPresentation->getDocumentProperties()->setCreator('PHPOffice')
 										->setLastModifiedBy('PHPPresentation Team')
 										->setTitle('Sample 08 Title')
 										->setSubject('Sample 08 Subject')

samples/Sample_06_Fill.php

@@ -13,7 +13,7 @@
 
 // Set properties
 echo date('H:i:s') . ' Set properties'.EOL;
-$objPHPPresentation->getProperties()->setCreator('PHPOffice')
+$objPHPPresentation->getDocumentProperties()->setCreator('PHPOffice')
                                   ->setLastModifiedBy('PHPPresentation Team')
                                   ->setTitle('Sample 01 Title')
                                   ->setSubject('Sample 01 Subject')