#161 : Documentation

Author: Progi1984

docs/slides_layout.rst

@@ -13,9 +13,38 @@ Placeholders permit to link these three components together in order that the ov
 Master slides
 -------------
 
-You can access to all master slides with the method ``getAllMasterSlides`` or create on with ``createMasterSlide``.
+You can access to all master slides with the method ``getAllMasterSlides`` or create one with ``createMasterSlide``.
 
 .. code-block:: php
 
-	$array = $oPHPPresentation->getAllMasterSlides();
-	$oMasterSlide = $oPHPPresentation->createMasterSlide();
+    $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));
+

samples/Sample_19_SlideMaster.php

@@ -33,7 +33,8 @@
 $shape = $oMasterSlide->createLineShape(0, 672, 960, 672)->getBorder()->setColor(new Color(Color::COLOR_WHITE))->setLineWidth(2);
 $shape = $oMasterSlide->createLineShape(0, 674, 960, 674)->getBorder()->setColor(new Color(Color::COLOR_DARKBLUE))->setLineWidth(2);
 // Title placeholder
-$shape = $oMasterSlide->createRichTextShape()->setWidthAndHeight(960, 80)->setOffsetX(0)->setOffsetY(60);
+$shape = $oMasterSlide->createRichTextShape();
+$shape->setWidthAndHeight(960, 80)->setOffsetX(0)->setOffsetY(60);
 $shape->getFill()->setFillType(Fill::FILL_SOLID)->setStartColor(new Color(Color::COLOR_BLUE));
 $shape->getActiveParagraph()->getAlignment()
     ->setHorizontal(Alignment::HORIZONTAL_RIGHT)->setMarginLeft(200)->setMarginRight(50)
@@ -46,23 +47,26 @@
 $textRun->getFont()->setBold(true)->setSize(30)->setColor(new Color(Color::COLOR_WHITE));
 $shape->setPlaceHolder(new Placeholder(Placeholder::PH_TYPE_TITLE));
 // Date placeholder
-$shape = $oMasterSlide->createRichTextShape()->setWidthAndHeight(140, 38)->setOffsetX(50)->setOffsetY(680);
+$shape = $oMasterSlide->createRichTextShape();
+$shape->setWidthAndHeight(140, 38)->setOffsetX(50)->setOffsetY(680);
 $shape->getActiveParagraph()->getAlignment()
     ->setHorizontal(Alignment::HORIZONTAL_LEFT)
     ->setVertical(Alignment::VERTICAL_BASE);
 $shape->setAutoFit(RichText::AUTOFIT_NORMAL);
 $textRun = $shape->createTextRun('01-02-2000')->getFont()->setSize(18);
 $shape->setPlaceHolder(new Placeholder(Placeholder::PH_TYPE_DATETIME))->getPlaceholder()->setIdx(10);
 // Footer placeholder
-$shape = $oMasterSlide->createRichTextShape()->setWidthAndHeight(468, 38)->setOffsetX(246)->setOffsetY(680);
+$shape = $oMasterSlide->createRichTextShape();
+$shape->setWidthAndHeight(468, 38)->setOffsetX(246)->setOffsetY(680);
 $shape->getActiveParagraph()->getAlignment()
     ->setHorizontal(Alignment::HORIZONTAL_CENTER)
     ->setVertical(Alignment::VERTICAL_BASE);
 $shape->setAutoFit(RichText::AUTOFIT_NORMAL);
 $textRun = $shape->createTextRun('Placeholder for Footer')->getFont()->setSize(18);
 $shape->setPlaceHolder(new Placeholder(Placeholder::PH_TYPE_FOOTER))->getPlaceholder()->setIdx(11);
 // Slidenumber placeholder
-$shape = $oMasterSlide->createRichTextShape()->setWidthAndHeight(140, 38)->setOffsetX(770)->setOffsetY(680);
+$shape = $oMasterSlide->createRichTextShape();
+$shape->setWidthAndHeight(140, 38)->setOffsetX(770)->setOffsetY(680);
 $shape->getActiveParagraph()->getAlignment()
     ->setHorizontal(Alignment::HORIZONTAL_RIGHT)
     ->setVertical(Alignment::VERTICAL_BASE);
@@ -86,7 +90,8 @@
 
 // Create a shape (text) linked to a PlaceHolder
 echo date('H:i:s') . ' Create a shape (rich text)' . EOL;
-$shape = $currentSlide->createRichTextShape()->setWidthAndHeight(960, 80)->setOffsetX(0)->setOffsetY(60);
+$shape = $currentSlide->createRichTextShape();
+$shape->setWidthAndHeight(960, 80)->setOffsetX(0)->setOffsetY(60);
 $shape->getFill()->setFillType(Fill::FILL_SOLID)->setStartColor(new Color(Color::COLOR_BLUE));
 $shape->getActiveParagraph()->getAlignment()
     ->setHorizontal(Alignment::HORIZONTAL_RIGHT)->setMarginLeft(200)->setMarginRight(50)