importStyles

WORD CONTENTS

LAYOUT & SETTINGS

TEMPLATES

FORMAT CONVERSION

DOCXPATH

DOCXUTILITIES

DOCXPATHUTILITIES

PDFUTILITIES

DOCXCUSTOMIZER

customizeWordContent

PERFORMANCE

BULK PROCESSING

TRACKING

CRYPTOPHPDOCX

DIGITAL SIGNATURE

ARTIFICIAL INTELLIGENCE

XLSXUTILITIES

PPTXUTILITIES

BLOCKCHAIN

VARIANT

importStyles

TRIAL / ADVANCED / PREMIUM

Imports Word styles from an external Word document.

Description

public importStyles ( string $path, string $type [, array $myStyles = array() [, string $styleIdentifier ] ] )

This method allows to import Word styles from an external Word document.

You may replace the whole stylesheet or just import a certain list of predefined styles.

If you need to know which styles are available for importation from an external Word document you may use the parseStyles method.

Parameters

path

The path to the Word document from which you want to import the styles.

type

The available options are:

'replace: overwrite the whole stylesheet.
'merge': import only the styles listed in the $myStyles array.

myStyles

An array with all the names of the styles that you wish to import. You may use the parseStyles($path) method to discover which styles are available.

styleIdentifier

The possible values are:

'styleName' (default value) if you wish to identify the styles included in $myStyles array by their name.
'styleID' if you want to use their id.

Exceptions

Error opening the file.

Code samples

Example #1

require_once 'classes/CreateDocx.php';

$docx = new CreateDocx();

// you may first check the available styles using the parseStyles('document.docx') methohd
$docx->importStyles('document.docx', 'merge', array('crazyStyle'));

$docx->addText('This is the resulting paragraph with the "CrazyStyle".', array('pStyle' => 'crazyStyle'));

// you may also import a complete XML style sheet by
//$docx->importStyles('document.docx', $type= 'replace');

$docx->createDocx('output');

The resulting Word document looks like:

Example #2

require_once 'classes/CreateDocx.php';

$docx = new CreateDocx();

// you may first check the available styles using the parseStyles('document.docx') methohd
$docx->importStyles('document.docx', 'merge', array('heading 1'));

$docx->addText('This is the resulting paragraph with a standard heading style.', array('pStyle' => 'Heading1'));

// you may also import a complete XML style sheet by
//$docx->importStyles('document.docx', $type= 'replace');

$docx->createDocx('output');

The resulting Word document looks like:

Release notes

phpdocx 12.0:
- supported linked numbering styles.
- set a random name value when importing a custom paragraph style with a numbering style.

phpdocx 10.0:
- in-memory DOCX documents.