HTML to PowerPoint with PHP

HTML to PowerPoint

Introduction

The conversion of HTML into PowerPoint is one of the most requested functionalities of phppptx.

phppptx supports creating PowerPoint presentations using HTML tags and CSS styles with the addHtml method.

To get the best PPTX output this feature provides, please install and enable PHP Tidy and PHP mbstring extensions on your server.

Examples

The code needed to insert some HTML with styles is as simple as this:

require_once 'classes/CreatePptx.php';

$pptx = new CreatePptx();

$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 <br>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));

$pptx->savePptx('output');

That generates the following output:

Another example that inserts lists:

require_once 'classes/CreatePptx.php';

$pptx = new CreatePptx();

$position = array(
    'coordinateX' => 4500000,
    'coordinateY' => 4000000,
    'sizeX' => 2000000,
    'sizeY' => 2000000,
);
$html = '<style>
    p {
        font-family: Arial;
        font-style: italic;
        text-decoration: underline;
        color: #2CA87A;
    }
    ul {
        font-weight: bold;
    }
</style>
<p>Unordered list:</p>
<ul>
    <li>Item 1</li>
    <li>Item 2</li>
    <li>Item 3</li>
</ul>';
$pptx->addHtml($html, array('new' => $position));

$position = array(
    'coordinateX' => 500000,
    'coordinateY' => 400000,
    'sizeX' => 3000000,
    'sizeY' => 2450000,
    'textBoxStyles' => array(
        'border' => array(
            'color' => 'FF0000',
            'dash' => 'dash',
            'width' => 48575,
        ),
    ),
);
$html = '<style>
    p {
        font-family: Arial;
        font-style: italic;
        text-decoration: underline;
        color: #2CA87A;
    }
    ol.rls {
        list-style-type: checkmarkBullet;
    }
    ul.sls {
        list-style-type: square;
    }
    ul.cls {
        list-style-type: circle;
    }
</style>
<p>Ordered list:</p>
<ol>
    <li>Item 1</li>
    <li>Item 2</li>
    <ol class="rls">
        <li>Item 2.1</li>
        <li>Item 2.2</li>
        <li>Item 2.3</li>
    </ol>
    <li>Item 3</li>
    <ul class="sls">
        <li>Item 3.1</li>
        <li>Item 3.2</li>
        <li>Item 3.3
        <ul class="cls">
            <li>Item 3.3.1</li>
            <li>Item 3.3.2</li>
            <li>Item 3.3.3</li>
        </ul>
        </li>
    </ul>
    <li>Item 4</li>
</ol>';
$pptx->addHtml($html, array('new' => $position));

$pptx->savePptx('output');

That generates the following output:

Supported HTML tags, attributes and styles

a tags
- see text element styles
br tags
p, h1, h2, h3, h4, h5, h6, li tags
- background-color
- dir: ltr, rtl
- text-align: left, center, right
ul, ol tags
- list-style-type: disc, circle, square, decimal, lower-alpha, lower-latin, lower-roman, upper-alpha, upper-latin, upper-roman, and PowerPoint list style names
span, b, cite, em, i, s, strong, var tags
- see text element styles
text element styles
- background-color
- color
- font-family
- font-size
- font-style: italic, oblique
- font-weight: bold, bolder, 700, 800, 900
- letter-spacing
- text-decoration: line-through, underline

Inserting HTML into PowerPoint templates

In addition to using addHtml to insert new content into a PPTX template, the replaceVariableHtml method can be used to replace text variables with HTML content:

require_once 'classes/CreatePptx.php';

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

$html = '<p style="font-size: 48px;"><b>php</b><em style="color:#C060E0;">pptx</em></p>';

// replace variables
$pptx->replaceVariableHtml(array('VAR_TITLE' => $html));

$pptx->savePptx('output');

CSS variables

phppptx supports CSS variables by enabling the parseCSSVars option.

The following sample transforms HTML contents with CSS variables:

$html = '<style>
:root {
    --text-color: green;
    --myborders: dashed;
    --text-size: 4px;
    font-weight: bold;
    --color-r: red;
    --color-g: green;
    --sz-t1: 32px;
    --font-fc: Arial;
}

p {
    border-bottom: var(--text-size) var(--myborders) var(--text-color);
    color: var(--color-r);
    font-size: var(--sz-t1, 32px);
}

span.c1 {
    color: var(--color-g);
    font-size: var(--sz-t2, 16px);
    font-family: var(--font-fc);
}

</style>
<p>Complex <span class="c1">CSS variables</span> can be used.</p>
';
$pptx->addHtml($html, array('new' => $position), array('parseCSSVars' => true));

HTML Extended and CSS Extended

Premium licenses include HTML Extended and CSS Extended modes to invoke phppptx methods with custom HTML tags and apply custom styles not supported by standard HTML tags and CSS styles.

Thus, it is possible to insert slides, audios, videos, and other contents and styles. All of it integrated with the supported HTML tags and CSS styles.

The following sample illustrates the use of HTML Extended and CSS Extended:

require_once 'classes/CreatePptx.php';

$pptx = new CreatePptx();

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

// add an audio
$html = '<phppptx_audio data-src="audio.mp3" />';
$position = array(
    'coordinateX' => 1400000,
    'coordinateY' => 4500000,
    'sizeX' => 2000000,
    'sizeY' => 2000000,
);
$pptx->addHtml($html, array('new' => $position), array('useHtmlExtended' => true));

// add an image
$html = '<phppptx_image data-src="image.jpg" />';
$position = array(
    'coordinateX' => 6800000,
    'coordinateY' => 500000,
    'sizeX' => 2800000,
    'sizeY' => 2800000,
);
$pptx->addHtml($html, array('new' => $position), array('useHtmlExtended' => true));

// add a video
$html = '<phppptx_video data-src="video.mp4" />';
$position = array(
    'coordinateX' => 8000000,
    'coordinateY' => 4500000,
    'sizeX' => 2000000,
    'sizeY' => 2000000,
);
$pptx->addHtml($html, array('new' => $position), array('useHtmlExtended' => true));

// add a slide
$html = '<phppptx_slide data-active="true" />';
$pptx->addHtml($html, array('new' => array()), array('useHtmlExtended' => true)); // a position is set although it is not used with phppptx_slide. This tag must be used standalone before adding contents in it

// add an SVG
$html = '<phppptx_svg data-src="image.svg" />';
$position = array(
    'coordinateX' => 1500000,
    'coordinateY' => 4000000,
    'sizeX' => 2000000,
    'sizeY' => 2000000,
);
$pptx->addHtml($html, array('new' => $position), array('useHtmlExtended' => true));

// add an image
$html = '<phppptx_image data-src="image.jpg" />';
$position = array(
    'coordinateX' => 4500000,
    'coordinateY' => 4000000,
    'sizeX' => 2500000,
    'sizeY' => 2500000,
);
$pptx->addHtml($html, array('new' => $position), array('useHtmlExtended' => true));

// add an image
$imagePositionJson = '{"coordinateX": 7500000, "coordinateY": 4000000, "sizeX": 2500000, "sizeY": 2500000}';
$html = '<phppptx_image data-src="image.jpg" data-position="' . htmlspecialchars($imagePositionJson, ENT_QUOTES) . '" />'; // data-position overrides the position set in addHtml
$pptx->addHtml($html, array('new' => $position), array('useHtmlExtended' => true));


// add mutiple HTML contents
$position = array(
    'coordinateX' => 770000,
    'coordinateY' => 507000,
    'sizeX' => 7000000,
    'sizeY' => 450000,
    'textBoxStyles' => array(
        'border' => array(
            'color' => 'FF0000',
            'dash' => 'dash',
            'width' => 48575,
        ),
    ),
);
$imagePositionJson = '{"coordinateX": 7500000, "coordinateY": 4000000, "sizeX": 2500000, "sizeY": 2500000}';
$html = '<style>
    p {
        background-color: #AEBF7A;
    }
    .c1 {
        text-decoration: underline;
        font-size: 16pt;
    }
</style>
<phppptx_slide data-active="true" data-layout="Blank" />
<p>
    <b>phppptx</b> can transform <span class="c1">HTML to PPTX</span>.
    <a href="https://www.phppptx.com">Link to phppptx</a>
</p>
<phppptx_image data-src="image.jpg" data-position="' . htmlspecialchars($imagePositionJson, ENT_QUOTES) . '" />
';
$pptx->addHtml($html, array('new' => $position), array('useHtmlExtended' => true));

$pptx->savePptx('output');