class.ilHtmlPurifierAbstractLibWrapper.php

Go to the documentation of this file.

<?php declare(strict_types=1);
/* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */

abstract class ilHtmlPurifierAbstractLibWrapper implements ilHtmlPurifierInterface
{
    protected $purifier;

    public function __construct()
    {
        $this->setPurifier(
            new HTMLPurifier($this->getPurifierConfigInstance())
        );
    }

    final public function purify(string $html) : string
    {
        return $this->purifier->purify($html);
    }

    final public function purifyArray(array $htmlCollection) : array
    {
        return $this->purifier->purifyArray($htmlCollection);
    }

    abstract protected function getPurifierConfigInstance() : HTMLPurifier_Config;

    protected function setPurifier(HTMLPurifier $purifier) : self
    {
        $this->purifier = $purifier;
        return $this;
    }

    protected function getPurifier() : HTMLPurifier
    {
        return $this->purifier;
    }

    final public static function _getCacheDirectory() : string
    {
        if (!file_exists(ilUtil::getDataDir() . '/HTMLPurifier') ||
            !is_dir(ilUtil::getDataDir() . '/HTMLPurifier')) {
            ilUtil::makeDirParents(ilUtil::getDataDir() . '/HTMLPurifier');
        }

        return ilUtil::getDataDir() . '/HTMLPurifier';
    }

    final protected function removeUnsupportedElements(array $elements) : array
    {
        $supportedElements = array();

        $notSupportedTags = array(
            'rp',
            'rt',
            'rb',
            'rtc',
            'rbc',
            'ruby',
            'u',
            'strike',
            'param',
            'object'
        );

        foreach ($elements as $element) {
            if (!in_array($element, $notSupportedTags)) {
                $supportedElements[] = $element;
            }
        }

        return $supportedElements;
    }

    protected function makeElementListTinyMceCompliant(array $elements) : array
    {
        // Bugfix #5945: Necessary because TinyMCE does not use the "u"
        // html element but <span style="text-decoration: underline">E</span>

        if (in_array('u', $elements) && !in_array('span', $elements)) {
            $elements[] = 'span';
        }

        return $elements;
    }
}