Merge remote-tracking branch 'upstream/develop' into #189-pyreweb

Author: ivanlanin

CHANGELOG.md

@@ -15,6 +15,7 @@ This is the changelog between releases of PHPWord. Releases are listed in revers
 - Element: New `CheckBox` element for sections and table cells - @ozilion GH-156
 - Settings: Ability to use PCLZip as alternative to ZipArchive - @bskrtich @ivanlanin GH-106 GH-140 GH-185
 - Template: Ability to find & replace variables in headers & footers - @dgudgeon GH-190
+- Template: Ability to clone & delete block of text using `cloneBlock` and `deleteBlock` - @diego-vieira GH-191
 
 ### Bugfixes
 

docs/templates.rst

@@ -19,6 +19,8 @@ Example:
     $template->setValue('Name', 'Somebody someone');
     $template->setValue('Street', 'Coming-Undone-Street 32');
 
-See ``Sample_07_TemplateCloneRow.php`` for more code sample, including
-how to create multirow from a single row in a template by using
-``cloneRow``.
+See ``Sample_07_TemplateCloneRow.php`` for example on how to create multirow
+from a single row in a template by using ``cloneRow``.
+
+See ``Sample_23_TemplateBlock.php`` for example on how to clone a block of
+text using ``cloneBlock`` and delete a block of text using ``deleteBlock``.

samples/Sample_23_TemplateBlock.php

@@ -0,0 +1,21 @@
+<?php
+include_once 'Sample_Header.php';
+
+// New Word document
+echo date('H:i:s') , " Create new PhpWord object" , \EOL;
+$phpWord = new \PhpOffice\PhpWord\PhpWord();
+
+$document = $phpWord->loadTemplate('resources/Sample_23_TemplateBlock.docx');
+
+// Will clone everything between ${tag} and ${/tag}, the number of times. By default, 1.
+$document->cloneBlock('CLONEME', 3);
+
+// Everything between ${tag} and ${/tag}, will be deleted/erased.
+$document->deleteBlock('DELETEME');
+
+$name = 'Sample_23_TemplateBlock.docx';
+echo date('H:i:s'), " Write to Word2007 format", EOL;
+$document->saveAs($name);
+rename($name, "results/{$name}");
+
+include_once 'Sample_Footer.php';

samples/resources/Sample_23_TemplateBlock.docx

@@ -232,7 +232,7 @@ public function getSections()
      */
     public function loadTemplate($filename)
     {
-        if (\file_exists($filename)) {
+        if (file_exists($filename)) {
             return new Template($filename);
         } else {
             throw new Exception("Template file {$filename} not found.");

src/PhpWord/PhpWord.php

@@ -65,7 +65,7 @@ public function setReadDataOnly($pValue = true)
     protected function openFile($pFilename)
     {
         // Check if file exists
-        if (!\file_exists($pFilename) || !is_readable($pFilename)) {
+        if (!file_exists($pFilename) || !is_readable($pFilename)) {
             throw new Exception("Could not open " . $pFilename . " for reading! File does not exist.");
         }
 

src/PhpWord/Reader/Reader.php

@@ -29,7 +29,7 @@ class Word2007 extends Reader implements IReader
     public function canRead($pFilename)
     {
         // Check if file exists
-        if (!\file_exists($pFilename)) {
+        if (!file_exists($pFilename)) {
             throw new Exception("Could not open {$pFilename} for reading! File does not exist.");
         }
 

src/PhpWord/Reader/Word2007.php

@@ -112,7 +112,7 @@ public function __construct($source, $style = null, $isWatermark = false)
                 \IMAGETYPE_PNG, \IMAGETYPE_BMP,
                 \IMAGETYPE_TIFF_II, \IMAGETYPE_TIFF_MM
             );
-            if (!\file_exists($source)) {
+            if (!file_exists($source)) {
                 throw new InvalidImageException;
             }
             $imgData = getimagesize($source);

src/PhpWord/Section/Image.php

@@ -61,7 +61,7 @@ public function __construct($src, $style = null)
         $_supportedObjectTypes = array('xls', 'doc', 'ppt', 'xlsx', 'docx', 'pptx');
         $inf = pathinfo($src);
 
-        if (\file_exists($src) && in_array($inf['extension'], $_supportedObjectTypes)) {
+        if (file_exists($src) && in_array($inf['extension'], $_supportedObjectTypes)) {
             $this->_src = $src;
             $this->_style = new \PhpOffice\PhpWord\Style\Image();
 

src/PhpWord/Section/Object.php

@@ -234,7 +234,7 @@ public function addObject($src, $style = null)
             }
 
             $iconSrc = __DIR__ . '/../../_staticDocParts/';
-            if (!\file_exists($iconSrc . '_' . $ext . '.png')) {
+            if (!file_exists($iconSrc . '_' . $ext . '.png')) {
                 $iconSrc = $iconSrc . '_default.png';
             } else {
                 $iconSrc .= '_' . $ext . '.png';