HTMLPurifier.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\LegalDocuments;

use ilObjAdvancedEditing;
use ilHtmlPurifierAbstractLibWrapper;
use HTMLPurifier_Config;
use Closure;

class HTMLPurifier extends ilHtmlPurifierAbstractLibWrapper
{
    private readonly array $allowed_tags;
    private readonly string $cache_directory;

    private readonly Closure $create_config;

    public function __construct(
        ?array $allowed_tags = null,
        ?string $cache_directory = null,
        ?Closure $create_config = null
    ) {
        $this->cache_directory = $cache_directory ?? ilHtmlPurifierAbstractLibWrapper::_getCacheDirectory();
        $this->allowed_tags = $allowed_tags ?? ilObjAdvancedEditing::_getUsedHTMLTags('textarea');
        $this->create_config = $create_config ?? HTMLPurifier_Config::createDefault(...);
        parent::__construct();
    }

    protected function getPurifierConfigInstance(): HTMLPurifier_Config
    {
        $config = ($this->create_config)();
        $config->set('HTML.DefinitionID', 'ilias termsofservice document');
        $config->set('HTML.DefinitionRev', 1);
        $config->set('HTML.TargetBlank', true);
        $config->set('Cache.SerializerPath', $this->cache_directory);
        $config->set('HTML.Doctype', 'XHTML 1.0 Strict');

        $tags = $this->makeElementListTinyMceCompliant($this->allowed_tags);

        $tags[] = 'b';
        $tags[] = 'i';

        $config->set('HTML.AllowedElements', $this->removeUnsupportedElements($tags));
        $config->set('HTML.ForbiddenAttributes', 'div@style');

        if (($def = $config->maybeGetRawHTMLDefinition()) !== null) {
            $def->addAttribute('a', 'target', 'Enum#_blank,_self,_target,_top');
        }

        return $config;
    }
}