Practical phppptx

HTML and CSS

Introduction

phppptx can transform HTML and CSS to add new contents in slides.

HTML and CSS

addHtml is the method to add HTML:

public function addHtml($html, $position, $options = array())

This method includes the following parameters:

$html: HTML/CSS to transform.
$position: position to add the new content. This can be an existing placeholder in the layout or a new text box.
$options: array to set extra options.

The following code adds HTML contents applying CSS styles:

$html = '<p style="font-size: 48px;"><b>Lorem ipsum</b></p>';
$pptx->addHtml($html, array('placeholder' => array('name' => 'Title 1')));

$html = '<style>
    p {
        font-family: Arial;
        font-style: italic;
        text-decoration: underline;
        color: #2CA87A;
    }
</style>
<p>Lorem ipsum with Arial font</p>';
$pptx->addHtml($html, array('placeholder' => array('name' => 'Subtitle 2')));

$position = array(
    'coordinateX' => 770000,
    'coordinateY' => 507000,
    'sizeX' => 7000000,
    'sizeY' => 450000,
    'textBoxStyles' => array(
        'border' => array(
            'color' => 'FF0000',
            'dash' => 'dash',
            'width' => 48575,
        ),
    ),
);
$html = '<style>
    p {
        background-color: #AEBF7A;
    }
    .c1 {
        text-decoration: underline;
        font-size: 16pt;
    }
</style>
<p>
    <b>phppptx</b> can transform <span class="c1">HTML to PPTX</span>.
    <a href="https://www.phppptx.com">Link to phppptx</a>
</p>
';
$pptx->addHtml($html, array('new' => $position));

Replacing variables in templates

When working with a template, replaceVariableHtml allows to replace a placeholder with HTML:

public function replaceVariableHtml($variables, $options = array())

The available parameters are:

$variables: placeholders to be replaced
$options: it's an array which can have these keys:
- 'activeSlide' (bool): if true, get only the active slide. Default as false.
- 'target' (string): slides (default), notesSlides, slideLayouts, slideMasters.
- 'type' (string): inline (only replaces the variable), block (default, removes the variable and its containing paragraph).

After loading the template, an easy replacement would be:

$pptx->replaceVariableHtml(array('VAR' => '<p style="font-size: 48px;"><b>php</b><em style="color:#C060E0;">pptx</em></p>'));

This code changes the placeholder VAR by a paragraph with the text "phppptx".

Tips and tricks

Install and enable Tidy and mbstring PHP extensions to transform HTML.

HTML Extended

Premium licenses include HTML Extended and CSS Extended features to invoke phppptx methods with custom HTML tags and apply custom styles. Thus, it is possible to insert audios, images, slides, videos, and other contents.

The following code adds a slide:

$html = '<phppptx_slide data-active="true" />';
$pptx->addHtml($html, array('new' => array()), array('useHtmlExtended' => true));

Next - Tables