ilHtmlPurifierAbstractLibWrapper Class Reference

Abstract class wrapping the HTMLPurifier instance. More...

Inheritance diagram for ilHtmlPurifierAbstractLibWrapper:

Collaboration diagram for ilHtmlPurifierAbstractLibWrapper:

Public Member Functions
	__construct ()
	Constructor. More...
	purify ($a_html, $a_config=null)
	Filters an HTML snippet/document to be XSS-free and standards-compliant. More...
	purifyArray (Array $a_array_of_html, $a_config=null)
	Filters an array of HTML snippets/documents to be XSS-free and standards-compliant. More...
Public Member Functions inherited from ilHtmlPurifierInterface
	purify ($a_html)
	Filters an HTML snippet/document to be XSS-free and standards-compliant. More...
	purifyArray (Array $a_array_of_html)
	Filters an array of HTML snippets/documents to be XSS-free and standards-compliant. More...

Static Public Member Functions
static	_getCacheDirectory ()
	Get the directory for HTMLPurifier cache files. More...

Protected Member Functions
	getPurifierConfigInstance ()
	Has to be implemented by subclasses to build the HTMLPurifier_Config instance with object specific configurations. More...
	setPurifier (HTMLPurifier $oPurifier)
	Set the purifier by subclass. More...
	getPurifier ()
	Get the purifier. More...
	removeUnsupportedElements ($a_array)
	Removes all unsupported elements. More...
	makeElementListTinyMceCompliant ($elements)

Protected Attributes
	$oPurifier = null

Detailed Description

Abstract class wrapping the HTMLPurifier instance.

Author

Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Version

$Id$

Definition at line 15 of file class.ilHtmlPurifierAbstractLibWrapper.php.

Constructor & Destructor Documentation

__construct()

ilHtmlPurifierAbstractLibWrapper::__construct

(

)

Constructor.

public

Definition at line 34 of file class.ilHtmlPurifierAbstractLibWrapper.php.

References getPurifierConfigInstance(), HTMLPurifier(), and setPurifier().

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

Here is the call graph for this function:

Member Function Documentation

_getCacheDirectory()

static ilHtmlPurifierAbstractLibWrapper::_getCacheDirectory ( )

staticfinal

Get the directory for HTMLPurifier cache files.

Returns

string Cache directory for HTMLPurifier public

Definition at line 117 of file class.ilHtmlPurifierAbstractLibWrapper.php.

References ilUtil\getDataDir(), and ilUtil\makeDirParents().

Referenced by ilAssHtmlUserSolutionPurifier\getPurifierConfigInstance(), and ilHtmlForumPostPurifier\getPurifierConfigInstance().

        {
                if(!file_exists(ilUtil::getDataDir().'/HTMLPurifier') ||
                   !is_dir(ilUtil::getDataDir().'/HTMLPurifier'))
                {
                        ilUtil::makeDirParents(ilUtil::getDataDir().'/HTMLPurifier');
                }
                
                return ilUtil::getDataDir().'/HTMLPurifier';
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getPurifier()

ilHtmlPurifierAbstractLibWrapper::getPurifier ( )

protected

Get the purifier.

Returns

HTMLPurifier instance of HTMLPurifier protected

Definition at line 102 of file class.ilHtmlPurifierAbstractLibWrapper.php.

References $oPurifier.

        {
                return $this->oPurifier;
        }

getPurifierConfigInstance()

ilHtmlPurifierAbstractLibWrapper::getPurifierConfigInstance ( )

abstractprotected

Has to be implemented by subclasses to build the HTMLPurifier_Config instance with object specific configurations.

protected

Referenced by __construct(), and purifyArray().

Here is the caller graph for this function:

makeElementListTinyMceCompliant()

ilHtmlPurifierAbstractLibWrapper::makeElementListTinyMceCompliant (   $elements )

protected

Definition at line 165 of file class.ilHtmlPurifierAbstractLibWrapper.php.

Referenced by ilAssHtmlUserSolutionPurifier\getAllowedElements(), and ilHtmlForumPostPurifier\getPurifierConfigInstance().

        {
                // 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;
        }

Here is the caller graph for this function:

purify()

ilHtmlPurifierAbstractLibWrapper::purify (   $a_html,   $a_config = null  )

final

Filters an HTML snippet/document to be XSS-free and standards-compliant.

public

Parameters

string

$a_html

HTML snippet/document

Returns

string purified html

Definition at line 50 of file class.ilHtmlPurifierAbstractLibWrapper.php.

        {
                return $this->oPurifier->purify($a_html, $a_config);
        }

purifyArray()

ilHtmlPurifierAbstractLibWrapper::purifyArray ( Array  $a_array_of_html,   $a_config = null  )

final

Filters an array of HTML snippets/documents to be XSS-free and standards-compliant.

public

Parameters

array

$a_array_of_html

HTML snippet/document

Returns

array Array of HTML snippets/documents

Definition at line 64 of file class.ilHtmlPurifierAbstractLibWrapper.php.

References getPurifierConfigInstance().

        {               
                return $this->oPurifier->purifyArray($a_array_of_html, $a_config);
        }

Here is the call graph for this function:

removeUnsupportedElements()

ilHtmlPurifierAbstractLibWrapper::removeUnsupportedElements (   $a_array )

finalprotected

Removes all unsupported elements.

Parameters

Array

$a_array

array of all elements

Returns

Array array of supported elements protected

Definition at line 137 of file class.ilHtmlPurifierAbstractLibWrapper.php.

Referenced by ilAssHtmlUserSolutionPurifier\getAllowedElements(), and ilHtmlForumPostPurifier\getPurifierConfigInstance().

        {
                $supportedElements = array();
                
                $notSupportedTags = array(
                        'rp',
                        'rt',
                        'rb',
                        'rtc',
                        'rbc',
                        'ruby',
                        'u',
                        'strike',
                        'param',
                        'object'
                );
                
                foreach($a_array as $element)
                {
                        if(!in_array($element, $notSupportedTags))
                        {
                                $supportedElements[] = $element;
                        }
                }

                return $supportedElements;
        }

Here is the caller graph for this function:

setPurifier()

ilHtmlPurifierAbstractLibWrapper::setPurifier ( HTMLPurifier  $oPurifier )

protected

Set the purifier by subclass.

Parameters

HTMLPurifier

$oPurifier

Instance of HTMLPurifier

Returns

ilHtmlPurifier This reference protected

Definition at line 88 of file class.ilHtmlPurifierAbstractLibWrapper.php.

References $oPurifier.

Referenced by __construct().

        {
                $this->oPurifier = $oPurifier;
                return $this;
        }

Here is the caller graph for this function:

Field Documentation

$oPurifier

ilHtmlPurifierAbstractLibWrapper::$oPurifier = null

protected

Definition at line 26 of file class.ilHtmlPurifierAbstractLibWrapper.php.

Referenced by getPurifier(), and setPurifier().

---

The documentation for this class was generated from the following file:

• Services/Html/classes/class.ilHtmlPurifierAbstractLibWrapper.php