addTextBox

Key	Type	Description
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	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.

Coordinate and size values must be set.

textBoxStyles

Key	Type	Description
autofit	string	autofit (default), noautofit, shrink.
border	array	'cap' (string) rnd, sq, flat. 'dash' (string) solid, dot, dash, lgDash, dashDot, lgDashDot, lgDashDotDot, sysDash, sysDot, sysDashDot, sysDashDotDot. 'color' (string) default as 000000. 'transparency' (int) 0 to 100. 'width' (int) EMUs (English Metric Unit). Default as 12700 (1pt).
columns	array	'number' (int) 'spacing' (int) EMUs (English Metric Unit).
descr	string	Descr value.
fill	array	'color' (string) FFFF00, CCCCCC... 'image' (string) 'imageAsTexture' (bool) default as false 'transparency' (int) 0 to 100.
margin	array	'bottom' (int) EMUs (English Metric Unit) 'left' (int) EMUs (English Metric Unit) 'right' (int) EMUs (English Metric Unit) 'top' (int) EMUs (English Metric Unit)
rotation	int	60.000ths of a degree.
textDirection	string	horz, vert, vert270, wordArtVert, eaVert, mongolianVert, wordArtVertRtl.
verticalAlign	string	top, middle, bottom, topCentered, middleCentered, bottomCentered.
wrap	string	square, none.

Theme options (Available in Premium licenses):

Key	Type	Description
color	string	accent1 accent2 accent3 accent4 accent5 accent6 dk1 dk2 folHlink hlink lt1 lt2

Exceptions

Position not valid.

Code samples

Example #1

require_once 'classes/CreatePptx.php';

$position = array(
    'coordinateX' => 1470000,
    'coordinateY' => 600000,
    'sizeX' => 5000000,
    'sizeY' => 450000,
);
// if no style is applied or a content is added, a text box is added in the slide but it's not visually displayed
$textBoxStyles = array(
    'border' => array(
        'color' => '000000',
    ),
);
$pptx->addTextBox($position, $textBoxStyles);

$position = array(
    'coordinateX' => 3770000,
    'coordinateY' => 4507000,
    'sizeX' => 7000000,
    'sizeY' => 1450000,
);
$textBoxStyles = array(
    'autofit' => 'noautofit',
    'border' => array(
        'color' => '000000',
    ),
    'fill' => array(
        'color' => '99B369',
    ),
);
$pptx->addTextBox($position, $textBoxStyles);

$pptx->savePptx('output');

The resulting PPTX looks like:

Example #2

require_once 'classes/CreatePptx.php';

$pptx = new CreatePptxFromTemplate('template.pptx');

// add the text boxed in the second slide. The first slide has the position 0
$pptx->setActiveSlide(array('position' => 1));

$position = array(
    'coordinateX' => 6470000,
    'coordinateY' => 600000,
    'sizeX' => 5000000,
    'sizeY' => 450000,
    'name' => 'Textbox custom A',
);
$textBoxStyles = array(
    'border' => array(
        'color' => '000000',
    ),
);
$pptx->addTextBox($position, $textBoxStyles);

$position = array(
    'coordinateX' => 1770000,
    'coordinateY' => 3507000,
    'sizeX' => 4000000,
    'sizeY' => 2350000,
    'name' => 'Textbox custom A',
    'order' => 0,
);
$textBoxStyles = array(
    'autofit' => 'noautofit',
    'fill' => array(
        'image' => 'image.png',
    ),
);
$pptx->addTextBox($position, $textBoxStyles);

$pptx->savePptx('output');

The resulting PPTX looks like:

Release notes

phppptx 4.5:
- theme, transparency option.
- rotation uses 60.000ths of a degree.

phppptx 4.0:
- extra check to avoid duplicated shape internal ids.
- name option moved to the position array option.

phppptx 1.0:
- new method.