Permit book-fold printing

Author: potofcoffee

docs/general.rst

@@ -177,6 +177,28 @@ Use mirror margins to set up facing pages for double-sided documents, such as bo
 
     $phpWord->getSettings()->setMirrorMargins(true);
 
+Note that in order for this to work properly, you need to set both paper size and page size. For example,
+to print a document on A4 paper (landscape) and fold it into A5 pages (portrait), use this section style:
+
+.. code-block:: php
+
+    $phpWord->getSettings()->setMirrorMargins(true);
+    $phpWord->addSection(array(
+        'paperSize' => 'A4',
+        'orientation' => 'landscape',
+        'pageSizeW' => \PhpOffice\PhpWord\Shared\Converter::cmToTwip(14.85),
+        'pageSizeH' => \PhpOffice\PhpWord\Shared\Converter::cmToTwip(21),
+    ));
+
+
+Printing as folded booklet
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+Use book-fold printing to set up documents to be printed as foldable pages.
+
+.. code-block:: php
+
+    $phpWord->getSettings()->setBookFoldPrinting(true);
+
 Spelling and grammatical checks
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

src/PhpWord/Metadata/Settings.php

@@ -160,6 +160,12 @@ class Settings
      */
     private $doNotHyphenateCaps;
 
+    /**
+     * Enable or disable book-folded printing
+     * @var bool|null
+     */
+    private $bookFoldPrinting;
+
     /**
      * @return Protection
      */
@@ -481,4 +487,20 @@ public function setDoNotHyphenateCaps($doNotHyphenateCaps): void
     {
         $this->doNotHyphenateCaps = (bool) $doNotHyphenateCaps;
     }
+
+    /**
+     * @return bool
+     */
+    public function hasBookFoldPrinting()
+    {
+        return $this->bookFoldPrinting;
+    }
+
+    /**
+     * @param bool $bookFoldPrinting
+     */
+    public function setBookFoldPrinting($bookFoldPrinting)
+    {
+        $this->bookFoldPrinting = $bookFoldPrinting;
+    }
 }

src/PhpWord/Writer/Word2007/Part/Settings.php

@@ -151,6 +151,7 @@ private function getSettings(): void
         $this->setOnOffValue('w:updateFields', $documentSettings->hasUpdateFields());
         $this->setOnOffValue('w:autoHyphenation', $documentSettings->hasAutoHyphenation());
         $this->setOnOffValue('w:doNotHyphenateCaps', $documentSettings->hasDoNotHyphenateCaps());
+        $this->setOnOffValue('w:bookFoldPrinting', $documentSettings->hasBookFoldPrinting());
 
         $this->setThemeFontLang($documentSettings->getThemeFontLang());
         $this->setRevisionView($documentSettings->getRevisionView());

tests/PhpWordTests/Writer/Word2007/Part/SettingsTest.php

@@ -468,4 +468,20 @@ public function testDoNotHyphenateCaps(): void
         $element = $doc->getElement($path, $file);
         self::assertSame('true', $element->getAttribute('w:val'));
     }
+
+    public function testBookFoldPrinting()
+    {
+        $phpWord = new PhpWord();
+        $phpWord->getSettings()->setBookFoldPrinting(true);
+
+        $doc = TestHelperDOCX::getDocument($phpWord);
+
+        $file = 'word/settings.xml';
+
+        $path = '/w:settings/w:bookFoldPrinting';
+        $this->assertTrue($doc->elementExists($path, $file));
+
+        $element = $doc->getElement($path, $file);
+        $this->assertSame('true', $element->getAttribute('w:val'));
+    }
 }