addList

Key	Type	Description
text	string\|array	See addText for text styles.
bold	bool
characterSpacing	int
color	string	HEX color.
font	string	Font family.
fontSize	int	8, 9, 10, 11...
highlight	string	HEX color.
italic	bool
lang	string	Language.
strikethrough	bool
underline	string	Underline: single.

position

Key	Type	Description
placeholder	array	The content is added in a placeholder of the layout. One of the following options can be used to get the text box. 'name' (string) placeholder name. 'descr' (string) placeholder alt text (descr) value. 'position' (int) placeholder position by order. 0 is the first order position. 'type' (string) title (Title), body (Body), ctrTitle (Centered Title), subTitle (Subtitle).
new	array	A new position is generated. 'coordinateX' (int) EMUs (English Metric Unit). 'coordinateY' (int) EMUs (English Metric Unit). 'sizeX' (int) EMUs (English Metric Unit). 'sizeY' (int) EMUs (English Metric Unit). 'name' (string) placeholder internal name. If not set, a random name is generated. 'order' (int) set the display order. Default after existing contents. 0 is the first order position. If the order position doesn't exist add after existing contents. 'textBoxStyles' (array) See addTextBox for text box styles.

listStyles

Array for each list level.

Key	Type	Description
color	string	HEX color.
font	string	Font family.
indent	int	EMUs (English Metric Unit) default as -250000.
marginLeft	int	EMUs (English Metric Unit).
marginRight	int	EMUs (English Metric Unit).
size	int	% of text.
startAt	int	Start at value.
type	array	'filledRoundBullet' 'hollowRoundBullet' 'filledSquareBullet' 'hollowSquareBullet' 'starBullet' 'arrowBullet' 'checkmarkBullet' 'decimal' 'romanUpperCase' 'romanLowerCase' 'alphaUpperCase' 'alphaLowerCase' 'alphaLcParenBoth' 'alphaUcParenBoth' 'alphaLcParenR' 'alphaUcParenR' 'alphaLcPeriod' 'alphaUcPeriod' 'arabicParenBoth' 'arabicParenR' 'arabicPeriod' 'arabicPlain' 'romanLcParenBoth' 'romanUcParenBoth' 'romanLcParenR' 'romanUcParenR' 'romanLcPeriod' 'romanUcPeriod' 'circleNumDbPlain' 'circleNumWdBlackPlain' 'circleNumWdWhitePlain' 'arabicDbPeriod' 'arabicDbPlain' 'ea1ChsPeriod' 'ea1ChsPlain' 'ea1ChtPlain' 'ea1JpnChsDbPeriod' 'ea1JpnKorPlain' 'ea1JpnKorPeriod' 'arabic1Minus' 'arabic2Minus' 'hebrew2Minus' 'thaiAlphaPeriod' 'thaiAlphaParenR' 'thaiAlphaParenBoth' 'thaiNumPeriod' 'thaiNumParenR' 'thaiNumParenBoth' 'hindiAlphaPeriod' 'hindiNumPeriod' 'hindiNumParenR' 'hindiAlpha1Period'

options

Key	Type	Description
insertMode	string	Insert mode if the position contains an existing content: append replace Default as append.

Key

Type

Description

insertMode

string

Insert mode if the position contains an existing content:

append
replace

Default as append.

Exceptions

Position not valid.

Code samples

Example #1

require_once 'classes/CreatePptx.php';

$pptx = new CreatePptx(array('layout' => 'Two Content'));

$content = array(
    'Item 1',
    'Item 2',
    'Item 3',
);
$pptx->addList($content, array('placeholder' => array('name' => 'Content Placeholder 2')));

$content = array(
    'Item A',
    array(
        'Item A.1',
        'Item A.2',
        array(
            'Item A.2.sub1',
            'Item A.2.sub2',
        ),
        'Item A.3',
    ),
    'Item B',
    'Item C',
);
$pptx->addList($content, array('placeholder' => array('name' => 'Content Placeholder 3')));

$pptx->savePptx('output');

The resulting PPTX looks like:

Example #2

require_once 'classes/CreatePptx.php';

$pptx = new CreatePptx(array('layout' => 'Title and Content'));

$paragraphStyles = array(
    'noBullet' => false,
    'listStyles' => array(
        'type' => 'decimal',
        'indent' => -500000,
    ),
);

$contentA = array(
    'text' => 'List item 1',
    'bold' => true,
    'underline' => 'single',
);
$listFragmentA = new PptxFragment($pptx);
$listFragmentA->addText($contentA, array(), $paragraphStyles);

$contentB = array(
    array(
        'text' => 'Sublist',
        'highlight' => '628A54',
    ),
    array(
        'text' => ' item 1.1',
        'bold' => true,
        'italic' => true,
        'font' => 'Times New Roman',
    ),
);
$listFragmentB = new PptxFragment($pptx);
$listFragmentB->addText($contentB, array(), $paragraphStyles);

$contentC = array(
    array(
        'text' => 'List item ',
        'bold' => true,
        'font' => 'Arial',
        'fontSize' => 30,
    ), array(
        'text' => '3',
        'color' => '406094',
        'fontSize' => 40,
    )
);
$listFragmentC = new PptxFragment($pptx);
$listFragmentC->addText($contentC, array(), $paragraphStyles);

$contentLink = array(
    'text' => 'My link',
    'hyperlink' => 'https://www.phppptx.com'
);
$linkFragment = new PptxFragment();
$linkFragment->addText($contentLink, array(), $paragraphStyles);

$content = array(
    $listFragmentA,
    array(
        $listFragmentB,
    ),
    $listFragmentC,
    $linkFragment,
);
$pptx->addList($content, array('placeholder' => array('name' => 'Content Placeholder 2')));

$pptx->savePptx('output');

The resulting PPTX looks like:

Example #3

require_once 'classes/CreatePptx.php';

$pptx = new CreatePptx();

$content = array(
    array(
        'text' => 'Item 1',
        'bold' => true,
    ),
    array(
        'text' => 'Item 2',
        'bold' => true,
        'italic' => true,
        'underline' => 'single',
    ),
    array(
        'text' => 'Item 3',
        'fontSize' => 32,
    ),
);
$listStyles = array(
    array(
        'type' => 'checkmarkBullet',
        'indent' => -500000,
    ),
);
$pptx->addList($content, array('placeholder' => array('name' => 'Subtitle 2')), $listStyles);

$pptx->addSlide(array('layout' => 'Blank', 'active' => true));

// text box position and styles
$content = array(
    'Item A',
    array(
        'Item A.1',
        'Item A.2',
        array(
            'Item A.2.sub1',
            'Item A.2.sub2',
        ),
        'Item A.3',
    ),
    'Item B',
    'Item C',
);
$position = array(
    'coordinateX' => 770000,
    'coordinateY' => 507000,
    'sizeX' => 7000000,
    'sizeY' => 3450000,
);
$listStyles = array(
    array(
        'type' => 'filledRoundBullet',
    ),
    array(
        'type' => 'hollowRoundBullet',
    ),
    array(
        'type' => 'decimal',
    ),
);
$pptx->addList($content, array('new' => $position), $listStyles);

$pptx->savePptx('output');

The resulting PPTX looks like:

Release notes

phppptx 1.0: new method.