$name
$name :
Name of the filter for identification purposes.
This filter extracts <style> blocks from input HTML, cleans them up using CSSTidy, and then places them in $purifier->context->get('StyleBlocks') so they can be used elsewhere in the document.
Sometimes, a little ad-hoc fixing of HTML has to be done before it gets sent through HTML Purifier: you can use filters to acheive this effect. For instance, YouTube videos can be preserved using this manner. You could have used a decorator for this task, but PHP's support for them is not terribly robust, so we're going to just loop through the filters.
Filters should be exited first in, last out. If there are three filters, named 1, 2 and 3, the order of execution should go 1->preFilter, 2->preFilter, 3->preFilter, purify, 3->postFilter, 2->postFilter, 1->postFilter.
preFilter(string $html, \HTMLPurifier_Config $config, \HTMLPurifier_Context $context) : string
Removes inline <style> tags from HTML, saves them for later use
| string | $html | |
| \HTMLPurifier_Config | $config | |
| \HTMLPurifier_Context | $context |
postFilter(string $html, \HTMLPurifier_Config $config, \HTMLPurifier_Context $context) : string
Post-processor function, handles HTML after HTML Purifier
| string | $html | |
| \HTMLPurifier_Config | $config | |
| \HTMLPurifier_Context | $context |
cleanCSS(string $css, \HTMLPurifier_Config $config, \HTMLPurifier_Context $context) : string
Takes CSS (the stuff found in <style>) and cleans it.
| string | $css | CSS styling to clean |
| \HTMLPurifier_Config | $config | |
| \HTMLPurifier_Context | $context |
Cleaned CSS