modulargaming/purifier

HTMLPurifier module for Kohana

Purifier for Kohana

Overloads Security::xss_clean to provide secure XSS filtering using HTML Purifier., _(*1)

Installing Purifier

Using Git

If your application is in a Git repository, you can simply add this repository as a submodule:, _(*2)

git submodule add git://github.com/shadowhand/purifier.git modules/purifier
git submodule update --init --recursive

If you want to use a specific version, you can check out the tag of that version:, _(*3)

cd modules/purifier
git checkout v0.1.0
cd -
git add modules/purifier

Always remember to commit changes you make to submodules!, _(*4)

git commit -m 'Added Purifier module'

To install HTML Purifier, you will need to go into the purifier module directory and download it:, _(*5)

cd modules/purifier
git submodule update --init --recursive

HTML Purifier is enabled as submodule of the Purifier module. Submodules of submodules are only automatically initialized if you use the --recursive flag, _(*6)

FTP or Plain Files

For an untracked repository, you can download the repository and install it to MODPATH/purifier. To download a specific version, select the tag on Github before clicking the download link., _(*7)

You will also need to download HTML Purifier and install the entire "htmlpurifier" directory to MODPATH/purifier/vendor/htmlpurifier., _(*8)

After Installation

After HTML Purifier is installed, you will need to make the library/HTMLPurifier/DefinitionCache/Serializer in MODPATH/purifier/vendor/htmlpurifier writable by the web server., _(*9)

Using Purifier

To use Purifier, just call Security::xss_clean as you normally would. HTML Purifier will be used instead of the default "Bitflux" filter., _(*10)

Advanced Usage

If you want to access HTMLPurifier directly:, _(*11)

$html = Security::htmlpurifier();

You can configure the HTMLPurifier settings by creating APPPATH/config/purifier.php:, _(*12)

return array(
    'settings' => array(
        ... => ...
    ),
);